zerx-lab/FluxDown server-v0.4.8-rc.6

FluxDown Server v0.4.8-rc.6

on GitHub

[0.4.8-rc.6] - 2026-09-06

⚠️ 注意事项

• Server 启动时会对数据目录加独占锁：若同一份数据目录（或同一个数据库）被另一个正在运行的实例占用——例如误把多个容器指向了同一个挂载卷——新实例会直接报错退出，而不是继续运行并可能悄悄破坏数据库。请确保每份数据目录只对应一个正在运行的 Server 进程。

🚀 新功能

• Web 控制台顶栏新增浅色/深色主题一键切换按钮。
• Web 控制台任务详情面板新增「删除并删除文件」按钮，行为与右键菜单一致。

🐛 问题修复

• 修复 Docker 构建 Server 镜像失败的问题（此前因构建上下文缺少 crates/ workspace 成员导致构建报错）。
• 修复 macOS/Linux 上 PATH 未包含 Homebrew 安装目录时，无法探测到已安装的 ffmpeg/yt-dlp 的问题，现在会自动回退到 /opt/homebrew/bin、/usr/local/bin 等常见安装路径。
• 修复部分 CDN（如某些 OPPO/一加 OTA 服务器）在响应头里把字符集误写进 Content-Encoding，导致下载被错误拒绝的问题。

[0.4.8-rc.6] - 2026-09-06

⚠️ Notes

• The server now takes an exclusive lock on its data directory at startup. If the same data directory (or database) is already in use by another running instance — for example, multiple containers accidentally pointed at the same mounted volume — the new instance now fails immediately with a clear error instead of continuing and potentially corrupting the database. Make sure each data directory is only used by one running Server instance at a time.

🚀 Features

• Added a one-click light/dark theme toggle button to the Web Console's top bar.
• Added a "delete and remove files" button to the task detail panel in the Web Console, matching the existing right-click menu behavior.

🐛 Bug Fixes

• Fixed a Docker build failure when building the Server image, caused by the build context missing the crates/ workspace members.
• Fixed ffmpeg/yt-dlp installed via Homebrew not being detected on macOS/Linux when PATH doesn't include Homebrew's directories; the server now falls back to common install locations such as /opt/homebrew/bin and /usr/local/bin.
• Fixed downloads being incorrectly rejected when certain CDNs (e.g. some OPPO/OnePlus OTA servers) mistakenly send a charset value in the Content-Encoding header.

📦 直接下载运行（免 Docker）

解压后直接运行 fluxdown-server（Windows 为 fluxdown-server.exe），浏览器访问 http://127.0.0.1:17800。
单文件分发：Web 控制台已编译进二进制，包内只有可执行文件本身，无需附带任何静态资源目录。
首次启动请在浏览器里完成「初始化 FluxDown Server」向导设置访问密钥（无人值守部署可用 FLUXDOWN_TOKEN 预置）。文件校验见 SHA256SUMS.txt。

OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。二进制含完整 Web UI（约 30MB），需 overlay 空间充足的软路由设备。
QNAP：App Center → 手动安装 .qpkg（需在设置中允许安装未经验证的应用），装完点应用图标直达 Web 界面。
群晖：套件中心 → 手动安装 .spk（需在「设置 → 信任来源」允许任何发行者）。DSM 7.x 装 dsm7 包（以套件专属用户运行），DSM 6.x 装 dsm6 包；Intel/AMD 机型选 x64，ARM 机型（rtd1296/rtd1619b 等）选 arm64。装完在套件中心点「打开」直达 Web 界面（端口 17800）。

🐳 Docker（linux/amd64 · linux/arm64）

docker pull ghcr.io/zerx-lab/fluxdown-server:0.4.8-rc.6
docker run -d -p 17800:17800 -v fluxdown-data:/data \
  ghcr.io/zerx-lab/fluxdown-server:0.4.8-rc.6

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