📦 下载与安装说明（服务器 / CLI / Android / iOS）· 文件校验见 SHA256SUMS.txt
## 📦 Headless 服务器：直接下载运行（免 Docker） | 平台 | 资产 | |---|---| | Windows x64 / ARM64 | `FluxDown-Server-0.6.5-windows-{x64,arm64}.zip` | | macOS Intel / Apple Silicon | `FluxDown-Server-0.6.5-macos-{x64,arm64}.tar.gz` | | Linux x64 / ARM64（musl 静态链接，任意发行版可用） | `FluxDown-Server-0.6.5-linux-{x64,arm64}.tar.gz` | | OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构） | `fluxdown-server_0.6.5_<arch>.ipk` + `luci-app-fluxdown_0.6.5_all.ipk` | | OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） | `fluxdown-server_0.6.5_<arch>.apk` + `luci-app-fluxdown_0.6.5_all.apk` | | QNAP NAS（QTS x86_64 / ARM64） | `FluxDown-Server-0.6.5-qnap-{x64,arm64}.qpkg` | | 群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） | `FluxDown-Server-0.6.5-synology-{dsm7,dsm6}-{x64,arm64}.spk` | | 飞牛 fnOS NAS（x86 / ARM） | `FluxDown-Server-0.6.5-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） :::bash docker pull ghcr.io/zerx-lab/fluxdown-server:0.6.5 docker run -d -p 17800:17800 -v fluxdown-data:/data \ ghcr.io/zerx-lab/fluxdown-server:0.6.5 Compose 部署见仓库 `docker/docker-compose.yml`。首次打开 Web 界面时按向导设置访问密钥，或用 `-e FLUXDOWN_TOKEN=...` 预置。 ## 📦 命令行 CLI | 平台 | 资产 | |---|---| | Windows x64 / ARM64 | `FluxDown-CLI-0.6.5-windows-{x64,arm64}.zip` | | macOS Intel / Apple Silicon | `FluxDown-CLI-0.6.5-macos-{x64,arm64}.tar.gz` | | Linux x64 / ARM64（musl 静态链接，任意发行版可用） | `FluxDown-CLI-0.6.5-linux-{x64,arm64}.tar.gz` | 解压后得到 `fluxdown`（Windows 为 `fluxdown.exe`），放入 PATH 即可使用；也可从源码安装： `cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli`。 :::bash 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.5-android-universal.apk` | | 64 位 ARM（绝大多数手机） | `FluxDown-0.6.5-android-arm64-v8a.apk` | | 32 位 ARM | `FluxDown-0.6.5-android-armeabi-v7a.apk` | | x86_64（模拟器 / Chromebook） | `FluxDown-0.6.5-android-x86_64.apk` | ⚠️ **从旧版（Flutter 版）升级**：新版 Android 客户端换用了新的签名证书，不能直接覆盖安装旧版（系统可能提示「应用未安装」「软件包无效」「无法降级」或签名冲突）。 请先在旧版中记下需要保留的下载任务与设置，卸载旧版后再安装新版；卸载会清除旧版的本地数据，已下载到公共目录的文件不受影响。 ## 📱 iOS（侧载，未签名） | 版本 | 资产 | |---|---| | 完整版：含 BitTorrent / eD2K，远端主机的插件 / 组件管理可用 | `FluxDown-0.6.5-ios-sideload-unsigned.ipa` | IPA 未签名，需用 AltStore / SideStore / Sideloadly 等工具以自己的 Apple ID 签名后安装；免费 Apple ID 的签名 7 天后过期，需重新签名（AltStore / SideStore 可自动续签）。 不想自签可加入 TestFlight 公测（App Store 版，不含 P2P 与插件 / 组件功能），入口见官网下载页。[0.6.5] - 2026-10-31
🚀 Features
- (extension) 支持配置单页嗅探资源上限
- (bt-guard) 引擎与服务端支持 BT 防吸血
- (bt-guard) GPUI 新增防吸血设置页与任务对端证据
- (bt-guard) Android 新增防吸血设置页
- (bt-guard) IOS 新增防吸血设置页
- (bt-guard) Web 新增防吸血设置与对端操作
- (website) 新增 BT 防吸血页面与云端代理接口
🐛 Bug Fixes
- (server) 默认同时监听 IPv4 与 IPv6
- (i18n) 按术语表把 tr 新译文的省略号统一为 …
💼 Other
- (tr,zh-TW) 同步界面翻译（2026-10-30）
🚜 Refactor
- (website) 移除下载接口的按 IP 封禁
📚 Documentation
- (website) 说明服务端双栈监听与飞牛远程访问
- 同步 BT 防吸血的遥测例外与知识库
⚙️ Miscellaneous Tasks
- (release) 移除 123 云盘镜像上传流程
- (plugin-sdk) 发布 0.5.0
- (release) Linux-x64 服务端与 CLI 产物固定 x86-64 基线
