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

FluxDown Server v0.4.8-rc.1

on GitHub

[0.4.8-rc.1] - 2026-08-18

🚀 新功能

• BT 下载新增协议加密（MSE）：自研 RC4 双向加密握手，支持发起和接收两个方向，遇到不支持加密的 peer 会自动回退明文连接，提升在限速/屏蔽 BT 流量网络环境下的连接成功率。
• 新增全端日志诊断：设置页「关于」新增日志目录、写入健康状态展示，以及一键导出日志（自动脱敏认证头、Cookie、代理凭据和本地用户目录路径），排查问题更方便；同时修复了 BT 引擎中可能导致后台任务静默终止的崩溃点。

🐛 问题修复

• 修复分段下载在自适应收缩后立即回弹抖动的问题：收缩后进入冷却期，并复用已验证的分段信息，下载速度更稳定。
• 改进自动代理切换逻辑：直连与代理并行采样比较，传输失败时只切换一次线路，避免反复横跳；断点续传前会先校验响应内容，避免因缓存问题导致进度丢失。
• 修复签名/一次性链接（如网盘直链）断点续传易失败的问题：续传统一使用纯 Range 请求并校验响应版本，不再被 If-Range 判定为链接失效。
• 修复快速「暂停→继续」时可能出现同一文件被重复写入的问题；单任务自定义的 User-Agent 现在会在暂停、续传及重启后保持一致。

⚡ 性能优化

• 优化服务启动流程：复用引导阶段的数据库连接，避免重复打开数据库和执行初始化；文件扫描改为按并发上限并行探测，启动更快。

[0.4.8-rc.1] - 2026-08-18

🚀 Features

• Added BitTorrent protocol encryption (MSE): a from-scratch RC4 handshake supporting both outgoing and incoming connections, with automatic fallback to plaintext for peers that don't support encryption — improving connection success on networks that throttle or block BT traffic.
• Added end-to-end logging and diagnostics: the About settings page now shows the log directory, write health status, and a one-click log export (auth headers, cookies, proxy credentials, and local user paths are automatically redacted), making troubleshooting easier; also removed an unrecoverable panic in the BT engine that could silently kill background tasks.

🐛 Bug Fixes

• Fixed adaptive segmentation bouncing back immediately after shrinking — a cooldown period now follows a shrink and reuses already-verified segment metadata, giving smoother download speeds.
• Improved automatic proxy switching: direct and proxy connections are sampled and compared in the background, and a failed transfer switches route only once instead of flip-flopping; partial resumes now validate response content first, preventing stale caches from wiping progress.
• Fixed resume failures on signed/one-time links (e.g. cloud drive direct links): resume now issues a plain Range request and validates the response version, so If-Range no longer invalidates a one-time signed URL.
• Fixed a race where rapid pause-then-resume could let two writers touch the same temp file; a task's custom User-Agent now stays consistent across pause, resume, and restart.

⚡ Performance

• Faster server startup: the boot-time database connection is now reused instead of being reopened and re-initialized, and file scanning probes files in parallel up to the concurrency limit.

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

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