zerx-lab/FluxDown server-v0.3.0

FluxDown Server v0.3.0

on GitHub

0.3.0 - 2026-07-31

⚠️ 注意事项

• 服务器改为单文件发行：Web 控制台已内嵌进服务器二进制，不再需要在同目录放置 web/ 静态文件；如曾通过 FLUXDOWN_WEBROOT 环境变量自定义 Web 静态资源路径，需确认该变量已显式设置，否则将改用内置资源。

🚀 新功能

• 服务器内嵌 Web 控制台，NAS/OpenWrt/Docker 打包同步改为单文件分发；新增 ED2K 设置项，启动与配置变更时自动刷新 ED2K 的 server.met / nodes.dat。
• Web 控制台补齐 BT 做种能力：新增做种设置分组、任务级做种限速对话框、做种摘要栏及上传速度/累计上传展示，下载页与队列支持上传限速；状态栏新增限速面板与代理模式快切，与桌面端保持一致；任务详情日志新增链路选路结果记录，便于排查连接问题。
• 新增站点 HTTP 认证凭据管理：可在设置页维护各站点的 HTTP Basic 用户名/密码，新建下载或快速下载时按域名自动带出已保存的凭据；CLI 与 REST/aria2 接口同样支持传入 http-user/http-passwd。
• 无人值守下载体验优化：开启无人值守时，HLS/DASH 及插件下载不再等待手动二次选择，直接采用默认项。
• 新增「文件已存在时」设置：可选择保留默认的自动改名，或改为覆盖磁盘上已存在的同名文件；进行中的临时文件与并发任务命名规则不受影响，不会误覆盖其他任务的产物。

⚡ 性能与稳定性

• BT 暂停/恢复优化：暂停未完成任务时不再销毁 BT 会话，恢复即时生效，省去重新校验与冷启动开销；初始校验阶段现在会展示准确的进度百分比，Windows 上的分段文件写入也更省磁盘空间。
• 自动代理路由决策会持久化历史判断结果，跨重启后能更快复用此前验证过的优质代理线路。

🐛 问题修复

• 修复恢复下载时，若连接数收敛为 1 会导致已下载的分段进度被清空、需从头重新下载的问题。
• 修复部分服务器返回非标准 Content-Encoding: none 时，下载被永久拒绝且无法通过重试恢复的问题。
• 修复新建任务在按队列筛选视图下偶尔不显示的问题。
• 修复 Docker 多架构构建缓存冲突导致服务器镜像未能发布的问题。

0.3.0 - 2026-07-31

⚠️ Notes

• The server is now distributed as a single file: the Web console is embedded directly in the server binary, so a sibling web/ directory is no longer required. If you previously relied on FLUXDOWN_WEBROOT to point at custom Web assets, make sure it is still set explicitly — otherwise the server will fall back to the built-in assets.

🚀 Features

• The Web console is now embedded in the server binary, and NAS/OpenWrt/Docker packages ship as a single file as well. Added an ED2K settings page; the server now refreshes ED2K's server.met / nodes.dat on startup and whenever the config changes.
• The Web console now matches the desktop client's BitTorrent seeding support: a new seeding settings group, a per-task seeding limits dialog, a seeding summary bar with upload speed/total uploaded, and upload rate limits on the downloads page and queue manager. The status bar gained a rate-limit popover and a quick proxy-mode switch, matching desktop. Task detail logs now record routing decisions, making connection issues easier to diagnose.
• Added site HTTP authentication credential management: manage HTTP Basic username/password per site from Settings, with saved credentials auto-filled by domain when adding a new or quick download; CLI and the REST/aria2 API also accept http-user/http-passwd.
• Unattended downloads no longer wait for manual re-selection: HLS/DASH and plugin variants pick their default option automatically when unattended mode is on.
• Added a "when file exists" setting: choose between the default automatic renaming or overwriting an existing file on disk with the same name. In-progress temp files and concurrent-task naming are unaffected, so another task's in-flight or finished output is never overwritten by mistake.

⚡ Performance & Stability

• BitTorrent pause/resume is faster: pausing an incomplete torrent no longer tears down its session, so resuming takes effect instantly instead of re-verifying and cold-starting peers. The initial verification stage now shows an accurate progress percentage, and staging files on Windows use less disk space.
• Auto proxy routing now remembers past decisions across restarts, so a previously-confirmed better proxy route is reused faster instead of being re-measured from scratch.

🐛 Bug Fixes

• Fixed downloaded segment progress being wiped and restarted from byte zero when a resume's connection count collapsed to 1.
• Fixed downloads being permanently refused, with no way to recover via retry, when a server sent the non-standard Content-Encoding: none header.
• Fixed newly created tasks occasionally not appearing when a queue filter was active.
• Fixed a Docker multi-arch build cache conflict that had prevented server images from being published.

📦 直接下载运行（免 Docker）

解压后直接运行 fluxdown-server（Windows 为 fluxdown-server.exe），浏览器访问 http://127.0.0.1:17800。
单文件分发：Web 控制台已编译进二进制，包内只有可执行文件本身，无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。文件校验见 SHA256SUMS.txt。

OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。二进制含完整 Web UI（约 30MB），需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。

🐳 Docker（linux/amd64 · linux/arm64）

docker pull ghcr.io/zerx-lab/fluxdown-server:0.3.0
docker run -d -p 17800:17800 -v fluxdown-data:/data \
  ghcr.io/zerx-lab/fluxdown-server:0.3.0

Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。