SuperAPI AI 工具集

FluxDown

FluxDown 是一款 Rust 驱动的开源多协议下载管理器,可作为 IDM 的免费替代方案。它支持 HTTP/HTTPS、FTP、BitTorrent 磁力链接、eD2K、HLS 与 DASH 流媒体下载,采用 Rust 与 Tokio 引擎实现动态分段加速和慢段补救。产品提供原生 GPUI 桌面端、Kotlin Android、SwiftUI iOS、React Web UI 及命令行界面,并可通过浏览器扩展(Chrome/Edge/Firefox)与用户脚本接管浏览器下载。其内置 MCP(模型上下文协议)服务器,可供 Claude、Cursor 等 AI 客户端管理下载任务。此外还具备 RSS 订阅、定时队列、Webhook、插件与可选的 FluxCloud 设备协作功能,本地下载无需账号,免费开源且无广告,采用 AGPL v3.0 许可。

访问官网

工具介绍

用途

FluxDown 是一个多协议下载管理器,定位为免费、开源的 IDM 替代品,用于在桌面、移动端或服务器上统一管理各类下载任务。

主要能力

  • 动态下载加速:Rust + Tokio 引擎,支持自适应分段与慢段补救。
  • 多协议支持:HTTP/HTTPS、FTP、BitTorrent、eD2K、HLS 与 DASH 流媒体。
  • 多客户端:原生 GPUI 桌面端、Kotlin Android、SwiftUI iOS 应用、React Web UI 与 CLI。
  • 浏览器集成:Chrome / Edge / Firefox 扩展,具备三层拦截引擎,另提供用户脚本。
  • 面向 AI 智能体:内置 MCP(模型上下文协议)服务器,可让 Claude、Cursor 等 AI 客户端管理下载。
  • 自动化与远程管理:RSS 订阅、定时队列、Webhook、插件,以及可选的 FluxCloud 设备协作。
  • 本地优先:免费开源,无广告,本地下载无需账号;可恢复状态默认存储在本地。

使用方式

浏览器扩展:安装扩展后,FluxDown 可通过 Native Messaging 自动接管浏览器下载;也提供 Tampermonkey 用户脚本。

服务端部署:无头服务由 fluxdown-agent --server 加 fluxdownd 组成,内置 Web UI。Docker 镜像保留名称 ghcr.io/zerx-lab/fluxdown-server。使用提供的 Compose 配置启动后,访问 http://<server>:17800/,在首次运行向导中设置访问密钥(需为 8–128 个可见 ASCII 字符,且同时包含字母与数字)。服务端模式默认监听 0.0.0.0:17800,可用 FLUXDOWN_BIND 覆盖。持久化 /data(数据库、日志与访问密钥)和 /root/Downloads(下载内容)。原生部署需将 fluxdown-agent 与 fluxdownd 放在同一目录。

CLI 与 HTTP API:fluxdown CLI 默认连接运行中的桌面端或服务端 HTTP API。桌面端需先在“设置 → API 服务”中启用管理 API;通过 FLUXDOWN_TOKEN 提供访问密钥,使用 FLUXDOWN_URL 或 --url 选择远程服务器。桌面端默认地址为 127.0.0.1:17800。

MCP 服务器:在同一 API 端口上实现无状态 Streamable HTTP 子集(JSON-RPC 2.0,POST /mcp)。默认桌面配置端点为 http://127.0.0.1:17800/mcp。认证使用 Bearer token(Authorization: Bearer <token> 或 X-FluxDown-Token),与管理 API 共享。桌面端可在“设置 → API 服务”中开启 MCP 端点;无头服务器默认启用。

从源码构建:需 Rust 工具链及平台原生构建工具(Windows 用 MSVC,macOS 用 Xcode 命令行工具),Linux 桌面构建还需图形、音频与托盘相关开发库;Web UI 需要 Bun。Android 使用 Android Studio 的 JBR、Android SDK/NDK 与 cargo-ndk;iOS 使用 Xcode。

架构要点

  • Daemon 负责下载本身:引擎、下载数据库、队列、RSS、插件与 Webhook。
  • Agent 负责集成:UI 网关、FluxCloud 账号/同步、设备协作、浏览器捕获与桌面托盘/生命周期。
  • 共享契约:native/protocol 定义与传输无关的 DTO、方法与事件;native/api 通过 ApiHost 暴露 REST、aria2 与 MCP。
  • 引擎独立性:EventSink 与 HostSelection 连接引擎与宿主。同一数据目录同一时间只能由一个引擎写入。
  • 桌面端路径:fluxdown-desktop → fluxdown-agent → fluxdownd;无头部署复用 agent 与 daemon,搭配 React Web UI。原生 Android 与 iOS 客户端通过 UniFFI(native/mobile)连接。

适用场景

需要跨桌面、移动与服务器统一管理多协议下载任务的用户;希望通过浏览器扩展自动接管下载的用户;希望通过 MCP 让 AI 客户端管理下载流程的用户;需要 RSS 订阅、定时队列或 Webhook 自动化下载的用户。

限制与说明

  • 本地下载无需 FluxCloud 账号;云功能为可选。匿名安装与日活统计由 analytics_enabled 控制,可关闭,且不收集下载/任务信息;但官方明确说明这并非零遥测应用。
  • 独立模式不能与运行中的引擎共享同一数据目录,需先停止使用该目录的服务。
  • 服务端应在可信网络中完成首次密钥设置后再对外暴露,远程访问建议使用 HTTPS 反向代理;无人值守部署时通过部署环境或密钥管理器提供 FLUXDOWN_TOKEN,不要写入提交的文件。
  • 若下载磁盘需要休眠,建议将 /data 放在 SSD/缓存存储上。
  • 旧的 native/server crate 已冻结,不再是部署入口。
  • 官方 Android 版本使用原生项目的 ANDROID_NATIVE_* 签名凭据,无法覆盖安装旧的 Flutter APK,卸载旧应用前需备份数据。
  • 项目采用 GNU Affero 通用公共许可证 v3.0 分发。

其他

  • 官网与下载:https://fluxdown.zerx.dev
  • 源码仓库:https://github.com/zerx-lab/FluxDown
  • 反馈渠道:GitHub Issues 或官网反馈页;QQ 群 832143651。
  • 贡献流程参见仓库中的 CONTRIBUTING.md。