zerx-lab/FluxDown server-v0.4.9-rc.1

FluxDown Server v0.4.9-rc.1

on GitHub

[0.4.9-rc.1] - 2026-09-23

🚀 新功能

• 任务支持直接更换下载地址（原地换链续传），HTTP(S)/FTP 任务可用，新链接需与原链接同协议，进行中或已完成的任务及 BT 任务暂不支持
• 新增文件存在处理策略「跳过下载」，与原有的自动重命名、覆盖并列可选
• 新增“空闲时扫描文件”开关：关闭后没有任务下载时不再定期唤醒磁盘检查文件是否还在，NAS/网络硬盘可借此在空闲时休眠；有任务活跃或页面重新聚焦时仍会正常扫描
• 组件（ffmpeg、yt-dlp 等）下载支持设置 GitHub 镜像地址，缓解 GitHub API 限流环境下的托管安装失败问题；页面同时提供官方 Release 下载页入口，可配合“手动指定路径”使用
• 新增 FLUXDOWN_TOKEN_FORCE 环境变量：显式开启后每次启动都用 FLUXDOWN_TOKEN 强制覆盖数据库中保存的访问密钥（默认行为不变）
• 支持解析 thunder:// 迅雷链接并转换为可下载地址
• 群晖 DSM 7 套件安装/升级向导新增下载共享文件夹选择，首次启动自动播种保存目录（FLUXDOWN_SAVE_DIR），避免套件用户因无权限访问共享文件夹而误判为“目录不存在”；Web 目录选择器对无权限的目录会明确提示需要授权，不再显示成空目录

🐛 问题修复

• 修复一批下载稳定性问题：5xx/408 响应纳入自动重试；416 响应不再无谓耗尽重试次数；分段下载无进度时自动回退为单流，单流续传改为整文件重新下载；服务端返回的 Last-Modified 在跨 CDN 场景下出现漂移时仅告警，不再误判文件失效并清空已下载内容
• 修复 HLS 下载对 fMP4/CMAF（EXT-X-MAP）分片的支持，避免初始化片段重复拉取；直链形式的非播放列表 .m3u8 会自动回落为普通文件下载
• 修复 BT 任务部分勾选文件下载时未保留原始目录结构的问题
• 修复代理相关问题：yt-dlp 下载正确使用已配置代理；RSS 自动模式下直连失败会按候选代理重试；系统代理地址若已带协议前缀不再被错误拼接成重复前缀；macOS/Linux 下可正确读取系统代理设置
• 修复删除任务后 RSS 订阅已读状态与任务队列位置未同步的问题
• 修复群晖 DSM 7 套件用户默认无 HOME/Downloads 目录导致下载保存目录不可写的问题

[0.4.9-rc.1] - 2026-09-23

🚀 Features

• Tasks can now have their download URL changed in place to resume the same task with a new link. Works for HTTP(S)/FTP tasks (new link must use the same protocol as the original); not yet supported for active or completed tasks, or BT tasks
• Added a "skip download" option for existing-file handling, alongside the existing auto-rename and overwrite behaviors
• Added an "idle file scan" toggle: when off, disk is no longer polled periodically to check completed files while nothing is downloading, letting NAS/network drives sleep during idle periods; scanning still runs normally whenever a task is active or the page regains focus
• Component downloads (ffmpeg, yt-dlp, etc.) now support a configurable GitHub mirror base URL to work around GitHub API rate limiting; the page also links to the official release page as a fallback, for use with the existing "manual path" option
• Added the FLUXDOWN_TOKEN_FORCE environment variable: when explicitly enabled, FLUXDOWN_TOKEN overwrites the access token stored in the database on every startup (default behavior unchanged)
• Added support for resolving thunder:// links into downloadable URLs
• Synology DSM 7 package install/upgrade wizard now lets you pick a download shared folder, and seeds the save directory (FLUXDOWN_SAVE_DIR) on first launch, avoiding the case where the package user lacks permission on the shared folder and the directory appears to be missing; the web directory picker now clearly flags folders you lack permission on instead of showing them as empty

🐛 Bug Fixes

• Fixed a batch of download reliability issues: 5xx/408 responses are now retried automatically; 416 responses no longer exhaust retries needlessly; segmented downloads with no progress now fall back to a single stream, and single-stream resume now re-downloads the whole file instead of corrupting it; a drifting Last-Modified header across CDN nodes now only triggers a warning instead of wiping already-downloaded data
• Fixed HLS downloads to support fMP4/CMAF streams (EXT-X-MAP) and avoid re-fetching duplicate init segments; direct-link .m3u8 files that aren't playlists now automatically fall back to a plain file download
• Fixed BT downloads not preserving the original folder structure when only some files in a torrent are selected
• Fixed several proxy issues: yt-dlp downloads now correctly use the configured proxy; RSS auto mode retries via candidate proxies when a direct connection fails; system proxy addresses that already include a scheme are no longer duplicated; system proxy settings are now read correctly on macOS/Linux
• Fixed RSS read state and task queue position not staying in sync after deleting a task
• Fixed the Synology DSM 7 package user having no writable HOME/Downloads directory, which left the default save directory unwritable

📦 直接下载运行（免 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.9-rc.1
docker run -d -p 17800:17800 -v fluxdown-data:/data \
  ghcr.io/zerx-lab/fluxdown-server:0.4.9-rc.1

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