zerx-lab/FluxDown v0.6.4 on GitHub

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

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

平台	资产
Windows x64 / ARM64	`FluxDown-Server-0.6.4-windows-{x64,arm64}.zip`
macOS Intel / Apple Silicon	`FluxDown-Server-0.6.4-macos-{x64,arm64}.tar.gz`
Linux x64 / ARM64（musl 静态链接，任意发行版可用）	`FluxDown-Server-0.6.4-linux-{x64,arm64}.tar.gz`
OpenWrt 软路由 24.10 及更早（opkg，x86_64 / aarch64 各子架构）	`fluxdown-server_0.6.4_<arch>.ipk` + `luci-app-fluxdown_0.6.4_all.ipk`
OpenWrt 软路由 25.12 起（apk，x86_64 / aarch64 各子架构）	`fluxdown-server_0.6.4_<arch>.apk` + `luci-app-fluxdown_0.6.4_all.apk`
QNAP NAS（QTS x86_64 / ARM64）	`FluxDown-Server-0.6.4-qnap-{x64,arm64}.qpkg`
群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64）	`FluxDown-Server-0.6.4-synology-{dsm7,dsm6}-{x64,arm64}.spk`
飞牛 fnOS NAS（x86 / ARM）	`FluxDown-Server-0.6.4-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.4
docker run -d -p 17800:17800 -v fluxdown-data:/data \
  ghcr.io/zerx-lab/fluxdown-server:0.6.4

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

📦 命令行 CLI

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

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

📱 iOS（侧载，未签名）

版本	资产
完整版：含 BitTorrent / eD2K，远端主机的插件 / 组件管理可用	`FluxDown-0.6.4-ios-sideload-unsigned.ipa`

IPA 未签名，需用 AltStore / SideStore / Sideloadly 等工具以自己的 Apple ID 签名后安装；免费 Apple ID 的签名 7 天后过期，需重新签名（AltStore / SideStore 可自动续签）。
不想自签可加入 TestFlight 公测（App Store 版，不含 P2P 与插件 / 组件功能），入口见官网下载页。

[0.6.4] - 2026-10-30

🚀 Features

(website) 大陆访客与应用内更新优先走 123 云盘下载
(website) 按 Cloudflare 国家码判定大陆访客，移除 ip2region
(website) 123 云盘下载改用直链空间 URL 鉴权签名
(website) 下载页提供 iOS 侧载 IPA
(omp) 发版 tag 推送在 CI 与演练全绿时自动放行
(downloads) 自定义分类新增按网址匹配与快捷添加网址规则
(mobile) Android/iOS 分类编辑支持网址模式，列表按网址规则归类
(website) 123 云盘直链只签给 0.6.0 起的应用内更新
(website) 文档首页新增与 Ghost Downloader 的功能对照
(website) 对照表新增实测行并在首页加入口
(share) 新增快传分享与接收
(agent) 诊断日志纳入 fluxdown_mobile 目标
(theme) 新增石墨内置主题预设
(plugin) 支持登录视图容器与视图 effects
(proto) 预解析与建组回传解析插件 ID
(share) 我的分享支持重新开始、删除与批量操作
(downloads) 建任务组时回传预览插件 ID
(share) 分享落地页展示取件码
(engine) HLS 点播进度改用逐段证据估算总大小
(downloads) 支持把已完成任务的产物复制到系统剪贴板
(extension) 支持按住修饰键点击跳过接管
(share) 新增共享（swarm）多源传输
(share) 共享提供方会话纳入诊断与上报
(engine) 支持站点代理规则
(proxy) 四端支持站点代理规则的配置与展示
(share) 支持共享加速额度、举报与申诉
(account) 支持周期会员卡续费与流量包购买
(engine) 插件请求遵循站点代理规则并与下载同出口
(share) 任务事实携带接收记录与共享状态
(share) 免打扰模式下分享链接直接接收
(app) 系统打开链接被拒绝时提示用户
(website) 页脚展示 ICP 备案号
(website) 浏览器下载须先过 ESA AI 验证码
(agent) 远程任务通道优先使用 WebSocket
(share) FluxMesh 改为实验性功能并默认关闭
(web) 界面语言表改为构建期自动发现
(android) 按 assets/i18n 自动生成全部语言资源
(ios) Check-i18n 校验每种界面语言均已声明本地化
(i18n) 新增土耳其语界面
(app-icon) 支持自定义桌面应用图标
(ui) 按钮进行中转圈保证最短可见时长
(extension) 支持 Android 浏览器经 Intent 交给 FluxDown App
(extension) 按下下载链接时预热 NMH
(android) 设备页展示并管理云端受信任设备
(bt) 支持 peer/tracker 状态、本机做种与种子分享
(ui) 分段标签放不下时横向滚动并两端渐隐
(bt) 详情 Tracker 页支持状态筛选、排序与复制错误

🐛 Bug Fixes

(website) 定价页隐藏 USDT 支付选项
(downloads) 补齐移动端 urlPattern 往返与审查意见
(web) 分类路由缺省 rules 不再抛错，网址通配符预编译
(engine) 网址规则三个落盘时机统一按来源地址匹配
(downloads) 网址规则建议必命中源链接，保存基于最新分类并提示失败
(extension) 表单 POST 经 30x 跳转后的直链改按 GET 下载
(android) 远端主机的已完成任务不再提供打开本机文件
(agent) 替换旧版残留的 agent / daemon 并在程序文件消失后退出
(deps) 回退 rsa / pkcs1 到 rc.18 / rc.4（llrt_crypto 与 rc.19 / rc.5 不兼容）
(engine) 代理绕过列表恒含环回地址
(app) 修复标题栏菜单在下载页外点击下载动作无效
(website) Download-route 测试的 astro:env mock 补全 FLUXCLOUD_API_BASE
(engine) 修复 BT 初检期间暂停后卡在准备中
(mobile) 信号流意外结束时进入失败态并记录连接诊断
(agent) 系统代理模式下遵循 macOS 例外列表
(plugin) 修复视图动作与关闭事件先于 open 应答时丢失
(plugin) 插件状态跟随引擎快照并将任务组成员绑定预览插件
(downloads) 插件命令与详情 tab 按稳定键定位
(extensions) 已打开的插件对话框跟随实时插件列表
(web) 插件设置页跟随实时插件列表并全局提示自动禁用
(plugin) 二段解析任务绑定与失败收尾改为 fail-closed
(downloads) 任务组成员不再提供忽略插件重试
(extensions) 插件卸载后的列表更新不再误关其它对话框
(update) MacOS 清除更新包与已安装 bundle 的隔离标记
(shell) 新增内置入口按目录顺序插回默认区域
(downloads) 重命名仅对引擎可接受的任务开放并拒绝会被清洗的新名
(share) 网络诊断页内定高列表可独立滚动
(website) 修复官网窄屏横向溢出与表格布局
(share) 网络诊断内嵌列表滚到边后把滚轮交还页面
(plugin) 按 gpui-shell 0.8.1 重新生成桌面插件类型
(i18n) 修正 zh-TW 智慧排除劇集说明中的简体字
(downloads) 视图菜单高度上限改按行高推导
(theme) Windows 汉字按界面语言选字体与回退链
(account) 云端无流量包时隐藏购买入口
(build) X86_64 产物回退 x86-64 基线以支持老 CPU
(engine) Windows 系统代理检测补齐站点代理规则 rules 字段

💼 Other

(engine) 固定 libc 0.2.189 并新增 iOS 核心交叉检查
(deps) GPUI 与 quickjs-jit 改用 crates.io 发布版
(tr,zh-TW) 同步界面翻译（2026-10-30）

🚜 Refactor

(share) 用户可见名称由「快传」统一为 FluxMesh
(share) GPUI 分享页做减法并收拢接收与额度入口
(web) Web 分享页与 GPUI 同构做减法
(native) 移除无调用方的 pub 方法
(website) Dl-cn 镜像与官网加速迁移到阿里云 ESA

📚 Documentation

(omp) 补充分类网址规则的匹配口径与镜像坐标
(knowledge) 补充磁力规范化与会话信号流结束踩坑
(knowledge) 补充 libc 版本钉与 build-core 失败踩坑
(api) OpenAPI 补充建组与预览的解析插件 ID 字段
(extension) 补充与 SingleFile 共用时的文件名问题说明
(agent) 补充 FluxMesh 额度结算、合规与术语约定
(omp) 升级 gpui-shell 时须同回合重新生成桌面插件类型
(i18n) 非基线语言改由 ZerxLabBot 翻译自动化维护
(omp) 移除已不存在的 .augment 同步步骤
(i18n) 更新新增界面语言的流程说明

⚡ Performance

(website) 首页装饰动效延后到空闲时段加载

🧪 Testing

(i18n) 校验非基线语言占位符不越界不丢失

⚙️ Miscellaneous Tasks

(release) 发版资产同步上传 123 云盘
(release) 发版流水线撤下 123 云盘上传步骤
(release) 发布后经东京服务器中转上传 123 云盘
(release) IOS 侧载 IPA 并入统一 release 并停止保存 tag 缓存
(package) 测试包同步改用 AppImage/appimagetool 下载
(i18n) 合并 main 并保留 tr 应用图标译文