📦 下载与安装说明（服务器 / CLI / Android）· 文件校验见 SHA256SUMS.txt
📦 Headless 服务器：直接下载运行（免 Docker）
| 平台 | 资产 |
|---|---|
| Windows x64 / ARM64 | FluxDown-Server-0.6.3-windows-{x64,arm64}.zip
|
| macOS Intel / Apple Silicon | FluxDown-Server-0.6.3-macos-{x64,arm64}.tar.gz
|
| Linux x64 / ARM64（musl 静态链接，任意发行版可用） | FluxDown-Server-0.6.3-linux-{x64,arm64}.tar.gz
|
| OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构） | fluxdown-server_0.6.3_<arch>.ipk + luci-app-fluxdown_0.6.3_all.ipk
|
| OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） | fluxdown-server_0.6.3_<arch>.apk + luci-app-fluxdown_0.6.3_all.apk
|
| QNAP NAS（QTS x86_64 / ARM64） | FluxDown-Server-0.6.3-qnap-{x64,arm64}.qpkg
|
| 群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） | FluxDown-Server-0.6.3-synology-{dsm7,dsm6}-{x64,arm64}.spk
|
| 飞牛 fnOS NAS（x86 / ARM） | FluxDown-Server-0.6.3-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：24.10 及更早用 opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk；25.12 起用 apk add --allow-untrusted fluxdown-server_*.apk luci-app-fluxdown_*.apk（包未用 OpenWrt 官方密钥签名）。<arch> 取路由器 /etc/apk/arch（或 opkg print-architecture）中的架构名。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.3
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.6.3Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。
📦 命令行 CLI
| 平台 | 资产 |
|---|---|
| Windows x64 / ARM64 | FluxDown-CLI-0.6.3-windows-{x64,arm64}.zip
|
| macOS Intel / Apple Silicon | FluxDown-CLI-0.6.3-macos-{x64,arm64}.tar.gz
|
| Linux x64 / ARM64（musl 静态链接，任意发行版可用） | FluxDown-CLI-0.6.3-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.3-android-universal.apk
|
| 64 位 ARM（绝大多数手机） | FluxDown-0.6.3-android-arm64-v8a.apk
|
| 32 位 ARM | FluxDown-0.6.3-android-armeabi-v7a.apk
|
| x86_64（模拟器 / Chromebook） | FluxDown-0.6.3-android-x86_64.apk
|
⚠️ 从旧版（Flutter 版）升级：新版 Android 客户端换用了新的签名证书，不能直接覆盖安装旧版（系统可能提示「应用未安装」「软件包无效」「无法降级」或签名冲突）。
请先在旧版中记下需要保留的下载任务与设置，卸载旧版后再安装新版；卸载会清除旧版的本地数据，已下载到公共目录的文件不受影响。
0.6.3 - 2026-10-24
🚀 新功能
- 系统代理支持 PAC 脚本：按每个下载链接分别决定走哪个代理，系统开启「自动发现代理」（WPAD）时也能自动识别（macOS / Windows / GNOME）。
- 「自动」代理模式在起跑时并行探测多条备选线路，首条可用线路接管下载；传输失败会按类型归类，换线与自动重试更准确，被阻断的线路不再被选作备选。
- 浏览器扩展新增「扩展错误」日志：记录扩展自身的错误（保留 7 天、最多 100 条），可在侧边栏「诊断」页查看，导出连接诊断时会一并附带并脱敏。
- 浏览器扩展的商店签名安装包改为直接提供
.crx文件，下载后可直接拖入浏览器安装；官网下载页将扩展离线包分为「商店签名包」（自动更新）与「开发者模式解压包」（不会自动更新）两类。 - 官网下载页移除新版本邮件订阅与 macOS「已损坏」指南（macOS 版本已签名并公证）。
🐛 问题修复
- 修复下载遇到重定向时的凭据处理：跨子域跳转不再丢失浏览器 Cookie，302 响应下发的 Set-Cookie 也能正确带上。
- 修复浏览器扩展在 YouTube 等站点上因样式加载产生跨源错误、样式可能被拦截的问题。
- 修复浏览器扩展右键菜单在浏览器启动时可能因重复项而创建失败的问题。
- 修复页面进入前进/后退缓存（bfcache）时扩展出现未检查的连接错误的问题。
- 修复页面自身被 CSP 拦截的请求被误记为扩展错误的问题，并避免在 Cloudflare 验证框架中注入钩子。
- 修复取消浏览器下载后扩展产生多余错误提示的问题。
0.6.3 - 2026-10-24
🚀 Features
- System proxy now supports PAC scripts, choosing the proxy per download link. When the system has "Auto-detect proxy" (WPAD) enabled, it is discovered automatically (macOS / Windows / GNOME).
- The "Auto" proxy mode now probes alternative routes in parallel at startup, and the first working route takes over the download. Transport failures are classified by type for more accurate route switching and auto-retry, and blocked routes are no longer picked as fallbacks.
- The browser extension gains an "Extension errors" log that records the extension's own errors (kept for 7 days, up to 100 entries). View it on the side panel's Diagnostics page; it is included, with sensitive data redacted, when you export connection diagnostics.
- The store-signed browser extension package is now delivered as a plain
.crxfile that can be dragged straight into the browser. The website download page now separates extension offline packages into "Store-signed packages" (auto-update) and "Developer-mode unpacked packages" (no auto-update). - The website download page no longer offers new-release email subscriptions or the macOS "app is damaged" guide (macOS builds are signed and notarized).
🐛 Bug Fixes
- Fixed credential handling on redirects: cross-subdomain redirects no longer lose browser cookies, and Set-Cookie sent with a 302 response is now applied correctly.
- Fixed cross-origin errors and possibly blocked styles from the browser extension on sites such as YouTube.
- Fixed the extension's context menu sometimes failing to build with duplicate-item errors at browser startup.
- Fixed unchecked connection errors in the extension when a page enters the back/forward cache (bfcache).
- Fixed requests blocked by a page's own CSP being wrongly logged as extension errors, and the extension no longer injects its hooks into Cloudflare challenge frames.
- Fixed spurious extension errors after cancelling a browser download.