[0.2.5-rc.4] - 2026-07-28
⚠️ 注意事项
- 首次运行不再自动生成访问密钥并打印到控制台：请打开 Web 界面按向导设置密钥；NAS（群晖/QNAP/Unraid 等）等看不到容器日志的部署方式请改用向导。无人值守部署（docker-compose / k8s / CI）可通过环境变量
FLUXDOWN_TOKEN预置密钥以跳过向导。
🚀 新功能
- 首次运行改为通过 Web 向导设置访问密钥，向导完成、重新生成或在设置页修改密钥后立即生效，无需重启服务。
- 新增任务事件 Webhook 通知：可订阅任务创建、开始、完成、失败、暂停及队列清空共 6 类事件，内置 ntfy、Gotify、Bark、Server 酱、Telegram、Discord、Slack 等 8 种常见服务的预设模板，支持自定义占位符模板、HMAC 签名校验和投递记录查询，桌面端与 Web 端均可配置。
- 优化多线程下载的并发调度：长任务在提速无望时不再直接锁死连接数，而是冷却后再谨慎多试一次，减少长时间下载中的速度抖动；下载进度改为批量写入，降低崩溃或断电导致的进度丢失风险。
🐛 问题修复
- 修复通知设置弹窗中按钮被其他元素遮挡、输入框尺寸错位以及模板占位符缺失的显示问题。
[0.2.5-rc.4] - 2026-07-28
⚠️ Notes
- The server no longer auto-generates an access key and prints it to the console on first run. Open the Web UI and follow the setup wizard to set one — this matters especially for NAS deployments (Synology/QNAP/Unraid, etc.) where container logs aren't visible. For unattended deployments (docker-compose / k8s / CI), preset the key via the
FLUXDOWN_TOKENenvironment variable to skip the wizard.
🚀 Features
- First-run setup now happens through a Web wizard instead of an auto-generated key; changes from the wizard, key regeneration, or the settings page take effect immediately without restarting the server.
- Added webhook notifications for task events: subscribe to task created, started, completed, failed, paused, and queue-drained (6 events total), with built-in presets for ntfy, Gotify, Bark, Server酱, Telegram, Discord, Slack and more (8 services). Supports custom placeholder templates, HMAC signature verification, and a delivery log, configurable from both the desktop app and Web UI.
- Improved concurrency scheduling for multi-threaded downloads: when throughput stops improving on a long-running task, the engine now cools down and cautiously probes for one more connection instead of freezing outright, reducing speed jitter; download progress is now written in batches to reduce the risk of progress loss on crash or power loss.
🐛 Bug Fixes
- Fixed the notification settings dialog where buttons were hidden behind other elements, the text field was misaligned, and template placeholders were missing.
📦 直接下载运行（免 Docker）
| 平台 | 资产 |
|---|---|
| Windows x64 / ARM64 | FluxDown-Server-0.2.5-rc.4-windows-{x64,arm64}.zip
|
| macOS Intel / Apple Silicon | FluxDown-Server-0.2.5-rc.4-macos-{x64,arm64}.tar.gz
|
| Linux x64 / ARM64（musl 静态链接，任意发行版可用） | FluxDown-Server-0.2.5-rc.4-linux-{x64,arm64}.tar.gz
|
| OpenWrt 软路由（x86_64 / aarch64 各子架构） | fluxdown-server_0.2.5-rc.4_<arch>.ipk + luci-app-fluxdown_0.2.5-rc.4_all.ipk
|
| QNAP NAS（QTS x86_64 / ARM64） | FluxDown-Server-0.2.5-rc.4-qnap-{x64,arm64}.qpkg
|
| 群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） | FluxDown-Server-0.2.5-rc.4-synology-{dsm7,dsm6}-{x64,arm64}.spk
|
解压后直接运行 fluxdown-server（Windows 为 fluxdown-server.exe），浏览器访问 http://127.0.0.1:17800。
首次启动会在终端打印管理 token，务必保存。文件校验见 SHA256SUMS.txt。
OpenWrt：opkg install fluxdown-server_*.ipk luci-app-fluxdown_*.ipk，LuCI「服务 → FluxDown」页管理，Web 界面在 http://路由器IP:17800。二进制含完整 Web UI（约 20MB+），需 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.2.5-rc.4
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.2.5-rc.4Compose 部署见仓库 docker/docker-compose.yml。首次启动会在容器日志打印管理 token。