zerx-lab/FluxDown v0.6.0 on GitHub

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

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

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

解压后运行 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）。
飞牛 fnOS：应用中心 → 手动安装 .fpk；x86 机型选 x64，ARM 机型选 arm64。以专用应用用户 fluxdown 运行，默认保存到安装时创建的 fluxdown 共享文件夹，其他目录在应用设置「授权目录」中添加。装完点桌面图标直达 Web 界面（端口 17800）。

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

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

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

📦 命令行 CLI

平台	资产
Windows x64 / ARM64	`FluxDown-CLI-0.6.0-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-CLI-0.6.0-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-CLI-0.6.0-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.6.0-android-universal.apk`
64 位 ARM（绝大多数手机）	`FluxDown-0.6.0-android-arm64-v8a.apk`
32 位 ARM	`FluxDown-0.6.0-android-armeabi-v7a.apk`
x86_64（模拟器 / Chromebook）	`FluxDown-0.6.0-android-x86_64.apk`

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

[0.6.0] - 2026-10-22

🚀 Features

(website) 主域名切换到 fluxdown.com
客户端官网链接与默认服务端点改用 fluxdown.com
(android) 本机保存目录改用应用内目录浏览器
(website) 大陆访客下载分流到阿里云 CDN 并为下载链接签名
(website) 官网静态页面走 Cloudflare 边缘缓存,部署后按主机名清除
(website) 官网与下载迁到阿里云 CDN，国际下载直跳 GitHub
(website) CDN 下载只发给读过发布清单的非脚本大陆访客
(website) 同一 IP 15 分钟内超过 20 次下载封禁 12 小时
(website) 手动接入 Cloudflare Web Analytics
(plugin) 开发模式插件的 flux.fetch 允许访问非公网地址
(plugin) 插件包替换后桌面端重新挂载脚本视图
(plugin) 拦截补丁支持 maxRangeBytes 限制 Range 跨度
(app) Windows / Linux 标题栏应用菜单栏改为可选显示
(plugin-sdk) 支持页面脚本 pageScripts 并发布 0.2.0
(plugin) 支持插件页面脚本 pageScripts
(downloads) 保存目录支持最近路径历史下拉
(web) 新建下载保存目录支持最近路径历史下拉
(downloads) 对齐 qBittorrent 做种交互并支持任务组文件夹行
(android) 外部唤起下载按分类预填保存目录
(plugin) 插件视图支持自定义活动栏图标
(plugin-sdk) 校验视图 icon 并发布 0.3.0
(plugin-sdk) 统一包准入与审核摘要并发布 0.4.0
(extensions) 插件市场支持收藏与排序
(link) 配对即授权远程控制并支持设备控制凭据
(account) GPUI 配对弹窗支持请求完全控制
(web) 配对弹窗支持请求完全控制
(android) 添加主机支持局域网配对
(ios) 添加主机支持局域网配对
(settings) 设置行说明限制单行并收进信息图标

🐛 Bug Fixes

(web) 修复 server 模式直连配对误报局域网未开启
(website) Deploy.sh 拉取后重新执行自身,避免执行新旧拼接的脚本
(extension) 修复 Firefox 注入页面钩子卡死导致视频浮钮不显示
(agent) 默认端口不可用时回退系统端口并发布端点
(gpui) 桌面连接 agent 加超时并展示拉起失败原因
(protocol) 放宽客户端 WebSocket 帧与消息上限
(account) 当前与不可选套餐不再套用抵扣额
(engine) 优先下载只接受未结束任务并兜底结束 Boost
(website) Download-route 测试的 geoip mock 保留真实导出，修复测试顺序相关的 CI 失败
(daemon) 端点发布测试等待文件出现而非仅等端口监听
(plugin-sdk) 补充 repository 字段以通过 npm provenance 校验
(app) 进度窗口按主窗口与选择请求状态判定弹出
(downloads) 批量继续跳过已完成任务，避免重新下载
(extension) 修复内嵌 PDF 无法被嗅探收录
(android) 修复无文件选择器与存储卡文件打开时崩溃
(agent) MacOS 托盘右键改为主线程弹出菜单

💼 Other

升级 gpui-kit 至 0.8 与 gpui-fast 对应快照

🚜 Refactor

(agent) 移除更新端点的 with_base 包装
(theme) 主题导出的 $schema 改用 fluxdown.com
(android) 导航坞改为常驻的图标在上标签在下样式
(components) 抽取统一的 tooltip_view 并替换各处 Tooltip

📚 Documentation

文档、打包元数据与仓库模板改用 fluxdown.com
(ops) 下载分发说明对齐准入规则
记录本机端口回退与端点发现规则
登记保存目录历史的 GPUI 与 Web 镜像契约
(release) 补充旧版升级时可能出现的安装失败提示

⚡ Performance

[breaking] 优化大任务量下的导入、事件同步与界面刷新

🧪 Testing

(downloads) 复现 #935 批量继续会重下已完成任务
(android) 同步移除导航坞迷你态的测试断言