⚡ FluxDown 详细部署教程

FluxDown 是一款由 Rust 驱动的多协议下载管理器，是开源且免费的 IDM 替代品。它支持 HTTP、FTP、BitTorrent（含磁力链）、eD2K 以及 HLS/DASH 流媒体，并具备智能多线程加速和浏览器无缝集成功能。本教程将指导您在不同平台上完成安装与配置。

📋 部署前准备

  • 操作系统：支持 Windows、macOS、Linux、Android，以及 NAS/服务器（如 x86_64 和 ARM64 架构） 。
  • 浏览器：如需使用接管下载功能，需安装 Chrome、Edge 或 Firefox 的浏览器扩展 。
  • （可选）Docker：如需在服务器上部署无界面 (headless) 版本，请确保已安装 Docker 环境。

📦 第一步：常规安装（推荐）

你可以从项目的 GitHub Releases 页面 或官网下载对应平台的安装包。

桌面端安装

操作系统 推荐安装包 说明
Windows setup.exe 安装程序 标准安装，可关联浏览器。另有便携版 .zip 可供选择 。
macOS .dmg 镜像文件 支持 Intel 和 Apple Silicon 芯片，下载后拖入 Applications 文件夹即可 。
Linux .AppImage 或 .deb .AppImage 无需安装，赋予执行权限后即可运行；.deb 适用于 Debian/Ubuntu 系列发行版 。
Arch Linux .pkg.tar.zst 可通过 AUR 或直接安装此包 。

浏览器扩展（以 Chrome 为例）

安装桌面端后，强烈建议安装浏览器扩展，以便 FluxDown 自动接管浏览器中的下载任务。

  1. 下载扩展：从项目网站或 Releases 中获取适用于你浏览器的扩展包（通常为 .crx 或 .xpi 文件）。
  2. 安装扩展：
    • 在 Chrome/Edge 中，打开 chrome://extensions/，开启“开发者模式”，然后将 .crx 文件拖入页面进行安装。
    • 在 Firefox 中，打开 about:addons，点击齿轮图标选择“从文件安装附加组件”，然后选择 .xpi 文件。
  3. 连接：安装后，浏览器扩展会自动与本地运行的 FluxDown 主程序通信，实现下载拦截。

🐳 第二步：无界面服务器部署 (Headless Server)

FluxDown 也支持在服务器（如 NAS）上以守护进程模式运行，并提供 Web UI 进行管理。

使用 Docker（推荐）

项目提供了官方 Docker 镜像。

1
2
3
4
5
6
7
8
# 拉取并运行容器
docker run -d \
  --name fluxdown \
  -p 17800:17800 \          # 映射 API 和 Web UI 端口
  -v /path/to/downloads:/downloads \ # 映射下载目录
  -v /path/to/config:/config \       # 映射配置目录
  --restart unless-stopped \
  zerxlab/fluxdown:latest
  • 默认端口：17800 是默认的 Web UI 和 API 服务端口。
  • 访问：在浏览器中访问 http://<你的服务器IP>:17800 即可打开 Web 界面。

其他 NAS 平台

FluxDown 也提供了针对特定 NAS 系统的安装包：

  • Synology DSM：下载 .spk 文件，在套件中心手动安装。
  • QNAP：下载 .qpkg 文件，在 App Center 手动安装。
  • OpenWrt：下载 .ipk 文件，使用 opkg install 命令安装。
  • Unraid：可在社区应用 (Community Applications) 中搜索 FluxDown 并安装。
  • CasaOS / ZimaOS：可在其内置的应用商店中找到并一键安装。

🤖 第三步：AI 集成 (MCP Server)

FluxDown 内置了一个 MCP (Model Context Protocol) 服务器，允许 AI 代理（如 Claude Desktop、Cursor）直接管理您的下载任务 。

启用与配置

  1. 启用：在 FluxDown 桌面端的 设置 → API 服务 中，开启“MCP 端点”开关。系统会自动生成一个访问令牌 (Bearer Token)。

  2. 配置客户端：以 Claude Desktop 为例，编辑其配置文件 claude_desktop_config.json：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    {
      "mcpServers": {
        "fluxdown": {
          "url": "http://127.0.0.1:17800/mcp",
          "headers": {
            "Authorization": "Bearer <你的访问令牌>"
          }
        }
      }
    }

  3. 使用：配置成功后，您可以在对话中让 AI 执行如“添加下载任务” (download_add)、“列出所有下载” (download_list) 等操作。

🛠️ 第四步：从源码构建（开发者）

如果您想自己编译或参与开发，可以遵循以下步骤。

环境准备

  • Flutter SDK：版本需符合项目要求。

  • Rust 工具链：确保 rustc 和 cargo 已安装。

  • Rinf CLI：用于生成 FFI 桥接代码，通过 cargo install rinf_cli 安装。

  • Linux 系统依赖（如果使用 Linux 构建）：

    1
    2
    3
    4
    5
    # Debian/Ubuntu
    sudo apt-get install cmake ninja-build clang pkg-config \
      libgtk-3-dev libayatana-appindicator3-dev libnotify-dev libsecret-1-dev patchelf zstd
    # Arch Linux
    sudo pacman -S cmake ninja clang pkgconf gtk3 libayatana-appindicator libnotify libsecret patchelf zstd

构建步骤

  1. 克隆仓库：

    1
    2
    git clone -b main https://github.com/zerx-lab/FluxDown.git
    cd FluxDown

    注意：main 分支是开发分支，如需构建稳定版本，请切换到 stable 分支。

  2. 获取依赖并生成绑定：

    1
    2
    flutter pub get
    rinf gen

  3. 运行或构建：

    1
    2
    flutter run         # 运行调试版本
    flutter build windows --release   # 构建 Windows 发布版，其他平台类似 (macos, linux)

🐛 常见问题与排障

  • 浏览器扩展无法拦截下载？
    • 请确保 FluxDown 主程序正在运行。
    • 检查浏览器扩展的权限设置，确保其已开启“读取和更改浏览数据”等所需权限。
    • 尝试重新启动浏览器或重新安装扩展。
  • Linux 下 AppImage 无法运行？
    • 需要先赋予执行权限：chmod +x FluxDown-*.AppImage。
    • 如果提示 FUSE 错误，请尝试使用 --appimage-extract 命令将其解压后，运行解压出的可执行文件。
  • MCP 工具不可用？
    • 确保已在设置中启用 MCP 端点。
    • 检查客户端的配置，包括 URL 和认证头信息是否完全正确。
  • 下载速度不理想？
    • 检查 设置 → 速度控制 中的全局限速选项。
    • 对于 BT 下载，可以尝试添加更多的 Tracker 服务器。

通过以上步骤，您就可以在各种设备上成功部署并使用 FluxDown 了。它是一款功能强大、完全免费的下载管理工具，无论是日常使用还是作为服务器组件都非常出色。