zerx-lab/FluxDown v0.5.6-rc.1 on GitHub

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

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

平台	资产
Windows x64 / ARM64	`FluxDown-Server-0.5.6-rc.1-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-Server-0.5.6-rc.1-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-Server-0.5.6-rc.1-linux-{x64,arm64}.tar.gz`
OpenWrt 软路由（x86_64 / aarch64 各子架构）	`fluxdown-server_0.5.6-rc.1_<arch>.ipk` + `luci-app-fluxdown_0.5.6-rc.1_all.ipk`
QNAP NAS（QTS x86_64 / ARM64）	`FluxDown-Server-0.5.6-rc.1-qnap-{x64,arm64}.qpkg`
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64）	`FluxDown-Server-0.5.6-rc.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.6-rc.1
docker run -d -p 17800:17800 -v fluxdown-data:/data \
  ghcr.io/zerx-lab/fluxdown-server:0.5.6-rc.1

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

📦 命令行 CLI

平台	资产
Windows x64 / ARM64	`FluxDown-CLI-0.5.6-rc.1-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-CLI-0.5.6-rc.1-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-CLI-0.5.6-rc.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。

📱 Android

设备	资产
不确定架构（通用包）	`FluxDown-0.5.6-rc.1-android-universal.apk`
64 位 ARM（绝大多数手机）	`FluxDown-0.5.6-rc.1-android-arm64-v8a.apk`
32 位 ARM	`FluxDown-0.5.6-rc.1-android-armeabi-v7a.apk`
x86_64（模拟器 / Chromebook）	`FluxDown-0.5.6-rc.1-android-x86_64.apk`

⚠️ 从旧版（Flutter 版）升级：新版 Android 客户端换用了新的签名证书，不能直接覆盖安装旧版（系统会提示「应用未安装」或签名冲突）。
请先在旧版中记下需要保留的下载任务与设置，卸载旧版后再安装新版；卸载会清除旧版的本地数据，已下载到公共目录的文件不受影响。

0.5.6-rc.1 - 2026-10-10

⚠️ 注意事项

旧版 Flutter 客户端工程已移除，Android 正式包改用原生签名，无法覆盖安装旧版 Flutter APK，需先卸载旧版

🚀 新功能

新增云端推送通知：任务事件可通过云端渠道（邮件、Telegram）发送，桌面端、Web 控制台和移动端均可配置渠道并查看投递日志；默认仅发送文件名、大小、状态等信息
下载线程数上限提升到 512；线程数超过 64 时在设置、队列和新建下载界面显示风险提示，超过 256 提升为危险提示（自动模式仍最多 64 线程）
剪贴板监听改为按文件特征识别链接，只提示看起来像文件的链接；新增「探测无扩展名链接」和「自定义监听扩展名」设置项
Android：前台服务通知显示下载进度、速度和剩余时间，多任务显示聚合进度并列出前 5 个任务；应用在前台时，完成提示改为应用内 toast，本机文件可直接「打开」
Android：任务详情页动作区重做，浮层投影与对话框按钮样式统一，浅色主题改为冷调中性灰
桌面端：进度窗口支持直接删除任务，删除前二次确认，可选择是否同时删除已下载文件（默认保留）
Windows：打开文件和所在目录时，窗口不再落在其他窗口后面

🐛 问题修复

修复 Android 正式包启动即闪退的问题
修复应用内更新说明未跟随界面语言、且未按 Markdown 渲染的问题
修复登录类对话框按回车时对话框被提前关闭的问题；密码输入限制为 ASCII 字符
修复 RSS 条目状态标签对齐问题，状态文字被截断时悬停可查看完整内容
修复 Docker 镜像构建因缺少内置图标包而失败的问题

0.5.6-rc.1 - 2026-10-10

⚠️ Notes

The legacy Flutter app project has been removed. Official Android builds now use native signing and cannot be installed over the old Flutter APK, so uninstall the old version first

🚀 Features

Added cloud push notifications: task events can be delivered through cloud channels (email, Telegram). Channels and delivery logs are configurable on desktop, the Web console and mobile; by default only file name, size and status are sent
The download thread limit is raised to 512. Risk hints appear in Settings, the queue and the New Download dialog above 64 threads, escalating to a danger level above 256 (Auto mode still caps at 64)
Clipboard monitoring now recognizes links by file characteristics and only prompts for links that look like files; new "Probe extensionless links" and "Custom watched extensions" settings
Android: the foreground service notification shows download progress, speed and remaining time, with aggregated progress for multiple tasks and the top 5 tasks listed. While the app is in the foreground, completion is shown as an in-app toast, with an "Open" action for local files
Android: redesigned task detail action area, unified overlay shadows and dialog buttons, and a cooler neutral-gray light theme
Desktop: the progress window can delete a task directly, with a confirmation and an option to also delete downloaded files (kept by default)
Windows: opening a file or its folder no longer places the window behind other windows

🐛 Bug Fixes

Fixed the Android release build crashing on launch
Fixed in-app update notes not following the UI language and not rendering as Markdown
Fixed login-related dialogs closing prematurely when pressing Enter; password input is now limited to ASCII characters
Fixed RSS entry status label alignment; hovering shows the full text when truncated
Fixed Docker image builds failing due to missing built-in icon packs