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

FluxDown CLI v0.4.8-rc.1

on GitHub

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

🚀 新功能

• BitTorrent 下载现已支持 MSE 协议加密握手，并在对端不支持时自动回退明文连接，提升在限制/干扰未加密 BT 流量的网络环境下的连接成功率与兼容性。
• 本地服务与 CLI 的错误日志改为统一持久化记录，每条错误都带有可关联的诊断 ID，便于反馈问题时排查；导出日志会自动脱敏认证头、Cookie、代理凭据和本地用户目录等敏感信息。

🐛 问题修复

• 修复自动选路模式下可能频繁来回切换的问题：现在会在后台并行采样直连与代理线路，仅在确认故障时切换一次，下载更稳定。
• 修复断点续传一次性签名直链（如临时授权 URL）时，续传请求携带的 If-Range 可能导致链接提前失效、续传失败的问题；续传改为直接使用 Range 请求并校验服务器响应是否匹配。
• 修复自适应分段收缩后又立即回弹、反复震荡导致下载速度不稳定的问题：收缩后会进入短暂冷却，并在恢复下载时复用此前已验证的分段信息，避免重新探测失败。

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

🚀 Features

• BitTorrent downloads now support MSE protocol encryption handshakes, automatically falling back to plaintext when a peer doesn't support it — improving connectivity and compatibility on networks that throttle or block unencrypted BT traffic.
• Error logging for the local service and CLI is now unified into persistent storage, with every error tagged with a correlation ID to aid troubleshooting; exported logs automatically redact auth headers, cookies, proxy credentials, and local user paths.

🐛 Bug Fixes

• Fixed automatic route switching flapping back and forth between direct and proxy connections; it now samples both routes in the background and switches only once on a confirmed failure, making downloads more stable.
• Fixed resuming downloads on one-time signed links (e.g. temporary authorized URLs) failing because the If-Range header sent on resume could invalidate the link early; resuming now uses a plain Range request and verifies the server's response matches.
• Fixed adaptive segment sizing immediately rebounding after shrinking, causing download speed to oscillate; shrinking now enters a brief cooldown and reuses previously verified segment info when resuming, avoiding re-probe failures.

📦 下载预编译二进制

解压后得到 fluxdown（Windows 为 fluxdown.exe），放入 PATH 即可使用。文件校验见 SHA256SUMS.txt。

🛠️ 从源码安装

cargo install --git https://github.com/zerx-lab/FluxDown fluxdown_cli

🚀 快速开始

fluxdown ping                         # 探活（需 FluxDown App / server 运行中）
fluxdown add https://example.com/f.zip
fluxdown ls

服务地址经 --url 或 FLUXDOWN_URL（默认 http://127.0.0.1:17800），
管理 token 经 --token 或 FLUXDOWN_TOKEN。