zerx-lab/FluxDown v0.5.8 on GitHub

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

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

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

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

📦 命令行 CLI

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

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

[0.5.8] - 2026-10-19

🚀 Features

(plugin) 支持插件市场撤回并暴露解析器 URL 规则
(extension) 重写浏览器扩展并由 agent 下发签名嗅探规则
(website) 网页购买支持推荐码立减
(website) 网页购买支持 USDT 支付
(account) 支持套餐购买与推荐码推介
(shell) 支持拖拽自定义顶栏、活动栏与状态栏布局
(web) 支持拖拽自定义外壳布局
(engine) 支持 HLS 直播录制
(engine) 新增 bt / ed2k feature 以编译期剔除 P2P
(ios) 区分商店与侧载构建 flavor
(extension) 提升媒体嗅探与浮钮归属准确度
(plugins) 新增插件界面、授权审计与插件 SDK
(plugins) [breaking] 视图新增 portable 声明区分仅桌面实现
(web) 隐藏仅桌面实现的插件视图入口
(extension) Dom 规则支持页面 URL 与媒体元素归属
(plugins) 新增 youtube-down 示例插件
(extension) 资源列表预览按钮提到行内
(plugins) 支持多插件命中时选择解析器与站点默认
(downloads) 新建下载预填探测到的文件名
(extension) 页面接管卡片显示桌面端解析进度
(extension) 右键下载链接走浏览器捕获路径
(extension) 新增快捷键面板并在发布包隐藏内置规则原文
(engine) 支持 BT 任务完整性校验
(extension) 官方嗅探规则改由规则仓分发并完善设置页
(extension) 扩展更新后自动恢复已打开页面的探测
(rss) 订阅支持插件 provider 与专属配置
(link) 直连配对 v2 数据面并补齐多端配对界面
(engine) 新增插件拦截平面与任务速度历史
(packaging) 新增飞牛 fnOS .fpk 服务器包
(downloads) 进度与完成窗口新增打开主界面按钮
(sniff) 插件嗅探规则新增 epoch 与分片补取
(extension) 重构嗅探规则同步、命中记录与本地规则编辑
(downloads) 任务右键菜单删除项使用破坏性配色
(downloads) 任务详情日志页支持复制全部并改为条目卡片
(egress) 宿主自身下载统一走全局代理与插件改写出口
(shortcuts) 支持自定义应用内与全局快捷键
(extension) 不再向用户展示吊销列表
(extension) 禁止下载 Service Worker 合成的视频地址
(extension) 官方规则快照新增抖音分离音视频轨判定

🐛 Bug Fixes

(downloads) 新建任务全部成功时不再弹出提示
(update) AUR 等非官方系统包不再尝试应用内更新
(settings) 统一更新日志标题并去掉正文重复的版本标题
(downloads) 完成窗口点击打开文件后立即随前台交接关闭
(ci) 扩展测试前生成 .wxt 路径别名，修复委托更新测试的交接竞态
(app) 修复 new_download.rs 的 rustfmt 格式差异
(web) 新建下载的 batchId 改用 getRandomValues 生成，修复非安全上下文报错
(android) 修复后台下载失去前台服务保护与进程崩溃
(extension) 不再接管浏览器本地生成与 SW 合成的下载
(engine) 市场安装前核对包 manifest 与索引条目
(engine) 取消插件选择改为暂停任务并显示准备中
(agent) 放宽反代丢端口时的 Origin 同源校验
(downloads) 引擎准备中状态统一显示为「准备中」
(web) 访问密钥复制改用统一的 copyText
(plugin) 入口脚本加载期校验并修正任务审计目标
(engine) 凭据刷新上限改为只计连续无效换发
(engine) 插件源码校验纳入拦截器入口脚本
(downloads) 进度窗口打开主界面按钮改为图标按钮
(i18n) 修正系统包管理器更新提示的标点
(downloads) 补齐进度窗口测试对 OpenMainWindow 事件的匹配
(extensions) 插件市场隐藏已全部撤回的插件

💼 Other

(plugin-sdk) 包名改为 fluxdown-plugin-sdk 并发布到 npm
(app) MacOS dev 构建调整链接参数
Dev 构建改用依赖 O1 替代 macOS 链接参数

🚜 Refactor

(shell) 侧栏切换按钮下沉为组件并简化下载页顶栏

📚 Documentation

(plugins) 发布流程改为登记作者仓库并自动收录 Release
(extension) 补充嗅探规则文档并同步知识库
(website) 新增插件开发与贡献指南并调整生态页
(plugin) 同步凭据刷新上限的新语义
(plugin) 补充拦截器的权限说明与调试排查
(api) 精简接口标题并优化文档说明

⚡ Performance

(extension) 降低拦截投递与嗅探热路径开销
(engine) HLS 分片乱序窗口直写并按接收字节测速
(engine) DASH 合并 mp4 时去掉 faststart 二次重写

🎨 Styling

(web) 移除注释与测试标题中的 issue 编号
(extensions) 按 rustfmt 格式化插件市场候选过滤

🧪 Testing

(web) 复现 #895 非安全上下文缺少 crypto.randomUUID 时导入失败
(engine) 去掉插件选择测试中与后台定案竞态的断言

⚙️ Miscellaneous Tasks

(release) MacOS 公证 staple 遇网络断连时退避重试
(release) 草稿转正后推送发布公告到 Telegram 频道
(release) Telegram 公告只发中文更新日志并转为富文本格式
(website) 移除未使用的 OKC 链图标
(website) 移除 v1 旧站，仅部署 website-v2