github zerx-lab/FluxDown v0.6.2
on GitHub

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

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

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

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

📦 命令行 CLI

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

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

0.6.2 - 2026-10-24

🚀 新功能

  • 新建下载时可根据保存目录自动选择分类，桌面、Web、Android、iOS 行为一致；过长的路径会在中间省略显示
  • 浏览器扩展：开启下载拦截后，浏览器自行处理的下载会在页面内显示提示卡（支持「在文件夹中显示」），页面收不到提示时改用系统通知
  • 插件：Resolver 可在 manifest 中声明 memoryLimitMb，为需要处理大量数据的解析器提高内存上限
  • youtube-down 插件升级到 2.0.0，改为插件内自行解析，不再依赖 yt-dlp 组件和外部 JS 运行时
  • 桌面端「关闭窗口」新增 Ctrl+W 备选快捷键
  • POST 任务恢复失败、仅支持 POST 的下载地址等错误提示现已本地化（桌面、Web、Android、iOS）
  • iOS 商店版本对本机和任意远端主机一律不提供 P2P 与插件功能

🐛 问题修复

  • 修复接管的 POST 下载在恢复或重试时被改发 HEAD/GET 探测的问题，现在会明确提示失败；遇到仅允许 POST 的地址（405）会立即停止并给出可读错误
  • 修复 Resolver 返回空 audioUrl（声明无音轨）时任务下载失败的问题
  • 修复 Windows 上含中文路径的提示音无法播放的问题
  • 修复退出程序后 macOS / Linux 上提示音播放器仍继续播放的问题，单次播放最长 60 秒
  • 修复宽松 / 舒适密度下，任务列表大图标超出选中底色的问题（桌面与 Web）
  • 修复 OpenWrt LuCI 界面语言始终显示为英文的问题
  • 加固 Windows 安装器对旧版全用户安装的卸载等待，静默更新中止后会重新拉起原程序
  • Android 应用内更新改为交由系统安装程序处理，仅在界面可见时拉起安装
  • Web 下载页顶栏的新建按钮改为带悬停提示的图标按钮

0.6.2 - 2026-10-24

🚀 Features

  • The New Download dialog can now pick a category based on the save directory, consistent across desktop, Web, Android and iOS; long paths are shown with a middle ellipsis
  • Browser extension: with interception enabled, downloads handled by the browser itself now show an in-page notice card (with "Show in folder"), falling back to a system notification if the page can't receive it
  • Plugins: resolvers can declare memoryLimitMb in the manifest to raise the memory limit for parsers that handle large data
  • The youtube-down plugin is upgraded to 2.0.0 with built-in parsing, no longer depending on the yt-dlp component or an external JS runtime
  • Added Ctrl+W as an alternate shortcut for closing the window on desktop
  • Errors for failed POST task recovery and POST-only endpoints are now localized (desktop, Web, Android, iOS)
  • The iOS store build no longer offers P2P or plugin features, for local and any remote host alike

🐛 Bug Fixes

  • Fixed taken-over POST downloads being re-probed with HEAD/GET on resume or retry; they now fail clearly, and POST-only endpoints (405) stop immediately with a readable error
  • Fixed downloads failing when a resolver returns an empty audioUrl to declare no audio track
  • Fixed alert sounds not playing on Windows when the path contains Chinese characters
  • Fixed the alert sound player continuing to play after quitting on macOS / Linux; a single playback is capped at 60 seconds
  • Fixed large icons overflowing the selection highlight at relaxed / comfortable density (desktop and Web)
  • Fixed the OpenWrt LuCI interface always showing English
  • Hardened the Windows installer's wait for uninstalling older all-users installs; the app is relaunched if a silent update is aborted
  • Android in-app updates are now handed to the system installer, launching only when the UI is visible
  • The New button in the Web downloads top bar is now an icon button with a hover tooltip
Check out latest releases or
releases around zerx-lab/FluxDown v0.6.2

Don't miss a new FluxDown release

NewReleases is sending notifications on new releases.

Get notifications