unreleased - 2026-09-06

🐛 问题修复

• 修复部分服务端把字符集错误标注为 Content-Encoding: utf-8/utf8（常见于某些国产手机 OTA 升级 CDN）时下载被误判为未知压缩而失败的问题，现按无操作编码放行，真正的未知/多层压缩编码仍会被拒绝
• 修复 macOS/Linux 上通过 Homebrew 安装的 ffmpeg/yt-dlp 有时无法被自动探测到的问题，PATH 中缺少对应目录时会自动回退查找 Homebrew 的固定安装路径（/opt/homebrew/bin、/usr/local/bin）

unreleased - 2026-09-06

🐛 Bug Fixes

• Fixed downloads failing when a server mislabels its character set as Content-Encoding: utf-8/utf8 (seen on some OEM phone OTA update CDNs) — this is now treated as a no-op encoding, while genuinely unknown or multi-layer compressed encodings are still rejected
• Fixed ffmpeg/yt-dlp installed via Homebrew sometimes not being auto-detected on macOS/Linux — detection now falls back to Homebrew's standard install locations (/opt/homebrew/bin, /usr/local/bin) when they're missing from PATH

📦 下载预编译二进制

解压后得到 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。

0.4.8-rc.5 - 2026-08-24

🐛 问题修复

• 修复任务列表中首次使用 Shift 键进行区间多选时，未能正确勾选选中区间的问题
• 修复 macOS / Linux 上因系统证书库异常导致部分网站 HTTPS 连接失败的问题，现已内置根证书作为备用信任源

0.4.8-rc.5 - 2026-08-24

🐛 Bug Fixes

• Fixed Shift-click range selection in the task list not selecting the correct tasks on the first use
• Fixed HTTPS connection failures on macOS / Linux caused by an incomplete system certificate store, by bundling root certificates as a fallback trust source

v0.4.8-rc.5 - 2026-08-24

🐛 问题修复

• 修复部分设备上因系统证书库读取异常导致的 HTTPS 下载失败（提示证书颁发者未知）；现在非 Windows 平台会内置 Mozilla 根证书作为兜底，无需依赖系统信任库即可正常访问 HTTPS 资源

v0.4.8-rc.5 - 2026-08-24

🐛 Bug Fixes

• Fixed HTTPS downloads failing with "unknown certificate issuer" on some systems where the OS trust store couldn't be read correctly; non-Windows builds now bundle Mozilla's root certificates as a fallback, so HTTPS access no longer depends solely on the system trust store

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

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

v0.4.8-rc.5 - 2026-08-24

🐛 问题修复

• 修复部分 Android 设备上因系统证书读取异常导致所有 HTTPS 下载失败（提示证书颁发者未知）的问题

v0.4.8-rc.5 - 2026-08-24

🐛 Bug Fixes

• Fixed HTTPS downloads failing on some Android devices with an unknown-certificate-issuer error caused by the system trust store being unreadable

[0.4.8-rc.5] - 2026-08-24

🐛 问题修复

• 修复部分系统（尤其是移动端）因本地证书信任链为空，导致 HTTPS 下载报"证书颁发者未知"错误而无法访问正常站点的问题；现已内置 Mozilla 根证书库作为兜底

[0.4.8-rc.5] - 2026-08-24

🐛 Bug Fixes

• Fixed HTTPS downloads failing with "unknown certificate issuer" errors on systems (especially mobile) where the local certificate trust store was empty; a bundled Mozilla root certificate store is now included as a fallback

📦 下载预编译二进制

解压后得到 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。

0.4.8-rc.4 - 2026-08-23

🚀 新功能

• 登录设备数达到上限时，验证码页面会提示即将自动登出最久未使用的设备，不再卡在登录环节
• BT 引擎新增 MSE（消息流加密）支持，可通过高级配置在禁用/启用/强制三种模式间切换（默认启用），并优化了握手超时、出网连接速率与失效节点清理策略，提升与其他客户端的连接稳定性
• 精简 DHT 引导节点列表，移除已失效的 router.bitcomet.net 节点

🐛 问题修复

• 修复 BT 监听端口被占用时可能导致引擎无法启动的问题：现在会在配置的端口范围内自动尝试回退，并在双栈/IPv4-only 之间自动适配

0.4.8-rc.4 - 2026-08-23

🚀 Features

• When your account hits the device limit, the sign-in verification screen now warns that continuing will sign out the least-recently-used device, so you're no longer stuck unable to log in
• The BitTorrent engine adds Message Stream Encryption (MSE) support, switchable between disabled/enabled/forced via advanced config (enabled by default), along with tuned handshake timeouts, outbound connection rate, and dead-peer eviction for more stable peer connections
• Trimmed the DHT bootstrap node list, removing the dead router.bitcomet.net entry

🐛 Bug Fixes

• Fixed BitTorrent failing to start when its listening port was already in use — it now automatically falls back across the configured port range and adapts between dual-stack and IPv4-only binding

[0.4.8-rc.4] - 2026-08-23

🚀 新功能

• 新增 BT 连接加密（MSE）三档开关，可通过配置项 bt_mse_mode 设置为 disabled（不加密）/enabled（优先加密，兼容明文）/forced（强制加密），用于应对运营商限速等场景（暂无独立设置页面，需通过配置接口/CLI 设置）

🐛 问题修复

• 修复 BT 监听端口被占用时可能直接启动失败的问题：现在会在配置的端口范围内自动尝试其他端口，双栈监听不可用时会自动回退到 IPv4-only
• 清理已失效的 router.bitcomet.net DHT 引导节点（该域名已停止提供服务），替换为一组当前可用的官方节点，改善 DHT 网络发现的成功率

⚡ 性能优化

• 优化 BT 对等连接（peer）的建立与淘汰策略：连接建立更平滑、失效连接淘汰更快，减少大量节点环境下的无效连接占用，提升连接稳定性

[0.4.8-rc.4] - 2026-08-23

🚀 Features

• Added a three-way BitTorrent connection encryption (MSE) switch via the bt_mse_mode config key: disabled (plaintext only) / enabled (prefer encryption, allow plaintext) / forced (encryption required) — useful against ISP throttling; no Settings page yet, set it through the config API/CLI

🐛 Bug Fixes

• Fixed BT sessions failing to start when the listen port was already in use: FluxDown now automatically retries other ports within the configured range, and falls back to IPv4-only listening when dual-stack binding isn't available
• Removed the dead router.bitcomet.net DHT bootstrap node (the domain no longer serves that role) and replaced it with a set of currently-working official nodes, improving DHT peer discovery success rate

⚡ Performance

• Tuned BitTorrent peer connection handling: smoother connection ramp-up and faster eviction of dead peers, reducing wasted connections and improving stability under heavy swarms

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

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

0.4.8-rc.4 - 2026-08-23

🚀 新功能

• 从其他 App 分享链接或点击直链打开 FluxDown 时,现在会像悬浮层一样直接弹出下载确认层,不用先切换到主界面才能开始下载;覆盖范围也扩展到 Firefox 等更多浏览器与通用 http/https 直链。
• 通过 X 浏览器分享直链下载时,会自动读取该浏览器携带的 User-Agent、Cookie、Referer 并预填到新建下载弹层(Cookie 填入高级选项、UA/Referer 填入自定义请求头),可在弹层内编辑后再提交。
• BT 下载默认开启协议头加密(MSE),提升在部分限制或干扰 BT 流量的网络下的连接成功率。

🐛 问题修复

• 修复分享/直链弹出下载确认层后,返回或重新打开主界面偶发出现黑屏、白色启动闪烁的问题。
• 修复浅色主题下状态栏与导航栏图标对比度过低、看不清的问题,并更换为更清晰的通知小图标。
• 修复 BT 引擎升级后端口被占用时未能正确回退的问题。

⚡ 性能优化

• 分享/直链解析改为异步处理并截断超长内容,减少弹出下载确认层时的卡顿。
• 优化 BT 节点连接速率与失效节点淘汰策略,并移除已失效的 DHT 引导节点,加快建立可用下载连接。

0.4.8-rc.4 - 2026-08-23

🚀 Features

• Opening FluxDown via a shared link or direct link from another app now pops up the download confirmation sheet directly over the source app, like a floating overlay, instead of switching to the main screen first; coverage now also extends to more browsers such as Firefox and generic http/https links.
• Sharing a direct link from the X browser now carries over its User-Agent, Cookie, and Referer and prefills them into the new download sheet (Cookie into the advanced Cookie field, UA/Referer into custom request headers), editable before you submit.
• BitTorrent downloads now enable protocol header encryption (MSE) by default, improving connection success on networks that restrict or interfere with BT traffic.

🐛 Bug Fixes

• Fixed an occasional black screen or white splash flash when returning to or reopening the main screen after the share/direct-link download sheet.
• Fixed low-contrast status bar and navigation bar icons on light themes, and switched to a clearer notification icon.
• Fixed a port fallback issue after the BitTorrent engine upgrade where a busy port could fail to fall back correctly.

⚡ Performance

• Share/direct-link parsing is now handled asynchronously with oversized payloads truncated, reducing lag when the download sheet pops up.
• Tuned BitTorrent peer connection rate and dead-peer eviction, and removed a defunct DHT bootstrap node, so usable connections are established faster.

0.4.8-rc.4 - 2026-08-23

🚀 新功能

• BitTorrent 连接加密（MSE）现支持三档策略：禁用 / 启用（默认）/ 强制，可通过配置项 bt_mse_mode 设置，用于兼容特定网络环境或运营商限速策略
• 优化 BT 节点连接调度：加快剔除失效 peer、平滑外连速率，并移除了列表中已失效多年的 bitcomet DHT 引导节点，DHT 引导更快更可靠

🐛 问题修复

• 修复 BT 监听端口在配置端口被占用时不再自动尝试下一个端口的问题；同时在主机不支持 IPv6 双栈监听时，会自动回退为纯 IPv4 监听，避免部分环境下 BT 任务无法建立连接

0.4.8-rc.4 - 2026-08-23

🚀 Features

• BitTorrent peer encryption (MSE) now supports three modes: disabled / enabled (default) / forced, configurable via bt_mse_mode — useful for networks or ISPs that restrict unencrypted BT traffic
• Improved BT peer connection handling: faster eviction of dead peers, smoother outgoing connection pacing, and removal of a long-dead bitcomet DHT bootstrap node for quicker, more reliable DHT bootstrapping

🐛 Bug Fixes

• Fixed BT listening failing to try the next port in the configured range when the first one was already in use; hosts without usable dual-stack IPv6 now correctly fall back to IPv4-only listening, preventing BT tasks from failing to connect on some setups

📦 下载预编译二进制

解压后得到 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。

[0.4.8-rc.3] - 2026-08-20

🐛 问题修复

• 订阅购买对话框不再显示已下架的套餐，避免选中后无法完成购买

[0.4.8-rc.3] - 2026-08-20

🐛 Bug Fixes

• The subscription purchase dialog no longer lists discontinued plans, preventing purchases that fail after selection