zerx-lab/FluxDown v0.5.1 on GitHub

📦 下载与安装说明（服务器 / CLI）· 文件校验见 SHA256SUMS.txt

📦 Headless 服务器：直接下载运行（免 Docker）

平台	资产
Windows x64 / ARM64	`FluxDown-Server-0.5.1-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-Server-0.5.1-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-Server-0.5.1-linux-{x64,arm64}.tar.gz`
OpenWrt 软路由（x86_64 / aarch64 各子架构）	`fluxdown-server_0.5.1_<arch>.ipk` + `luci-app-fluxdown_0.5.1_all.ipk`
QNAP NAS（QTS x86_64 / ARM64）	`FluxDown-Server-0.5.1-qnap-{x64,arm64}.qpkg`
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64）	`FluxDown-Server-0.5.1-synology-{dsm7,dsm6}-{x64,arm64}.spk`

解压后运行 fluxdown-agent --server（Windows 为 fluxdown-agent.exe --server），浏览器访问 http://127.0.0.1:17800。
包内两个可执行文件必须放在同一目录：fluxdown-agent（含 Web 控制台，已编译进二进制）与 fluxdownd（下载 daemon，由 agent 自动拉起、退出时一并关停），无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。

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

🐳 Headless 服务器：Docker（linux/amd64 · linux/arm64）

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

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

📦 命令行 CLI

平台	资产
Windows x64 / ARM64	`FluxDown-CLI-0.5.1-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-CLI-0.5.1-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-CLI-0.5.1-linux-{x64,arm64}.tar.gz`

解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用；也可从源码安装：
cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli。

fluxdown ping                         # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls

服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），管理 token 经 --token 或 FLUXDOWN_TOKEN。

0.5.1 - 2026-10-01

🚀 新功能

Webhook 端点配置更健壮：配置中格式有误的条目会被跳过或回退为默认值，不再影响其他端点；桌面端与 Web 控制台同时编辑端点时会基于最新内容合并，不会覆盖他人的修改
Webhook 的任务创建 / 开始事件现在会根据来源链接推断临时文件名；投递日志按记录合并，并在重启后保留
下载进度窗口改为固定尺寸，宽度随内容自适应且只增不减，避免窗口来回抖动；Windows / Linux 上标题栏仅保留最小化与关闭按钮

🐛 问题修复

修复桌面端任务列表右键菜单按旧选区弹出的问题（无选中时不弹出，或作用于上一次选中的任务）
修复在简体中文等非 UTF-8 系统上，因 whoami 输出编码导致获取用户 SID 失败的问题
修复极慢连接（如约 2 KiB/s）长期占着最后一小段数据、导致下载尾部迟迟无法完成的问题
桌面端界面字体改用系统默认字体，修复 Windows 上同一行文字字号、粗细不一致的问题

0.5.1 - 2026-10-01

🚀 Features

More robust Webhook endpoint configuration: malformed entries are skipped or fall back to defaults without affecting other endpoints, and when the desktop client and Web console edit endpoints at the same time, changes are merged against the latest content instead of overwriting each other
Webhook task-created / task-started events now infer a temporary filename from the source URL; delivery logs are merged per record and kept across restarts
The download progress window now has a fixed size whose width adapts to content and only grows, avoiding jitter; on Windows / Linux the title bar keeps only minimize and close buttons

🐛 Bug Fixes

Fixed the desktop task list right-click menu being built from a stale selection (not appearing when nothing was selected, or acting on the previously selected task)
Fixed failure to obtain the user SID on non-UTF-8 systems (e.g. Simplified Chinese) caused by the encoding of whoami output
Fixed very slow connections (e.g. ~2 KiB/s) holding on to the last small piece of a download indefinitely and delaying completion
The desktop UI now uses the system default font, fixing inconsistent font size and weight within the same line of text on Windows