📦 下载与安装说明（服务器 / CLI / Android / iOS）· 文件校验见 SHA256SUMS.txt
## 📦 Headless 服务器：直接下载运行（免 Docker） | 平台 | 资产 | |---|---| | Windows x64 / ARM64 | `FluxDown-Server-0.6.6-windows-{x64,arm64}.zip` | | macOS Intel / Apple Silicon | `FluxDown-Server-0.6.6-macos-{x64,arm64}.tar.gz` | | Linux x64 / ARM64（musl 静态链接，任意发行版可用） | `FluxDown-Server-0.6.6-linux-{x64,arm64}.tar.gz` | | OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构） | `fluxdown-server_0.6.6_<arch>.ipk` + `luci-app-fluxdown_0.6.6_all.ipk` | | OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构） | `fluxdown-server_0.6.6_<arch>.apk` + `luci-app-fluxdown_0.6.6_all.apk` | | QNAP NAS（QTS x86_64 / ARM64） | `FluxDown-Server-0.6.6-qnap-{x64,arm64}.qpkg` | | 群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） | `FluxDown-Server-0.6.6-synology-{dsm7,dsm6}-{x64,arm64}.spk` | | 飞牛 fnOS NAS（x86 / ARM） | `FluxDown-Server-0.6.6-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.6 docker run -d -p 17800:17800 -v fluxdown-data:/data \ ghcr.io/zerx-lab/fluxdown-server:0.6.6 Compose 部署见仓库 `docker/docker-compose.yml`。首次打开 Web 界面时按向导设置访问密钥，或用 `-e FLUXDOWN_TOKEN=...` 预置。 ## 📦 命令行 CLI | 平台 | 资产 | |---|---| | Windows x64 / ARM64 | `FluxDown-CLI-0.6.6-windows-{x64,arm64}.zip` | | macOS Intel / Apple Silicon | `FluxDown-CLI-0.6.6-macos-{x64,arm64}.tar.gz` | | Linux x64 / ARM64（musl 静态链接，任意发行版可用） | `FluxDown-CLI-0.6.6-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.6-android-universal.apk` | | 64 位 ARM（绝大多数手机） | `FluxDown-0.6.6-android-arm64-v8a.apk` | | 32 位 ARM | `FluxDown-0.6.6-android-armeabi-v7a.apk` | | x86_64（模拟器 / Chromebook） | `FluxDown-0.6.6-android-x86_64.apk` | ⚠️ **从旧版（Flutter 版）升级**：新版 Android 客户端换用了新的签名证书，不能直接覆盖安装旧版（系统可能提示「应用未安装」「软件包无效」「无法降级」或签名冲突）。 请先在旧版中记下需要保留的下载任务与设置，卸载旧版后再安装新版；卸载会清除旧版的本地数据，已下载到公共目录的文件不受影响。 ## 📱 iOS（侧载，未签名） | 版本 | 资产 | |---|---| | 完整版：含 BitTorrent / eD2K，远端主机的插件 / 组件管理可用 | `FluxDown-0.6.6-ios-sideload-unsigned.ipa` | IPA 未签名，需用 AltStore / SideStore / Sideloadly 等工具以自己的 Apple ID 签名后安装；免费 Apple ID 的签名 7 天后过期，需重新签名（AltStore / SideStore 可自动续签）。 不想自签可加入 TestFlight 公测（App Store 版，不含 P2P 与插件 / 组件功能），入口见官网下载页。[0.6.6] - 2026-11-02
🚀 Features
- (downloads) 新建下载按分类记忆手选保存目录
- (plugin) Add archive contributions
- (plugin-sdk) 新增 defineArchive 入口辅助函数
- (update) 桌面更新提示改为状态栏更新按钮
🐛 Bug Fixes
- (plugins) 卸载时删除同 identity 的全部安装副本
- (downloads) 行悬停操作条用不透明底与左侧渐隐
- (downloads) 修复分类入口、目录优先级与远程分类
- (windows) 修复单实例测试编译与未使用参数警告
- (web) 保留清单目录并覆盖手动分类优先级
- (downloads) 保留手动目录意图并覆盖偏好刷新回归
- (downloads) 切换任一分类模式都清除手动目录标记
- (plugin) 恢复拦截器顺序并收敛归档改动
- (plugin-sdk) 对齐归档回调的异步与空结果类型
- (plugins) 归档回调补齐日志门面、失败原因进任务活动
- (i18n) 归档权限文案说明是分类目录下的子目录
💼 Other
- (tr,zh-TW) 同步界面翻译（2026-10-31）
- (tr,zh-TW) 同步界面翻译（2026-11-01）
🚜 Refactor
- (share) 移除 FluxMesh 分享功能的 Rust 与 GPUI 实现
- (web) 移除分享页面与设置并同步 protocol 绑定
- (mobile) 同步移除分享相关 protocol 绑定
- (website) 移除分享落地页与代理接口
- (extensions) 站点默认插件拆为独立子页
- (agent) 强制局域网建任务显式处理分类路由
📚 Documentation
- 同步移除分享功能后的 CI 与知识库
- (clients) 对齐分类选择与手动目录优先级说明
- (knowledge) 同步分类路由的手动标记与远端接单语义
- (plugins) 归档能力文档对齐实现（沙箱接口、触发条件、校验规则与限额）
⚡ Performance
- (agent) 局域网接单建任务不再克隆分类路由
⚙️ Miscellaneous Tasks
- (i18n) 合并 main 并剔除已删除分享键的译文
- (ai) 引入 Cursor 薄适配并抽取共享 bash 守卫
- (plugin-sdk) 发布 0.5.1
