v0.4.8 - 2026-09-20
🚀 新功能
- 订阅来源支持插件提供：新建或管理订阅时可以选择插件作为订阅来源，而不局限于内置 RSS。插件按自身逻辑发现新资源并自动创建下载任务，共享与内置 RSS 相同的过滤、去重、重试与任务管理能力；使用前需先在“设置 > 插件”中启用并配置对应插件。
- 插件登录认证：需要登录才能使用的插件现在提供统一的登录面板，支持扫码登录，或按插件要求填写账号、验证码等信息，可使用 Cookie、Basic、Bearer 或自定义请求头等认证方式。登录成功后凭据会自动附加到该插件后续的请求上，会话过期会提示重新登录，也可随时手动注销。
🐛 问题修复
- 修复部分服务器返回的文件名下载后出现乱码的问题：修正了 Content-Disposition 响应头中原始字节被二次编码导致的乱码，并改进了繁体中文、GBK 等编码文件名的解析。
- 修复保存目录或其上级目录不存在时下载失败（Windows 上报错误代码 3）的问题：HTTP、DASH、HLS、FTP、ED2K 与 BitTorrent 任务在写入文件前都会自动创建所需目录。
- Web 控制台的插件安装文件选择器现在同时接受
.fxplug和.zip格式，不必再手动把插件包改成.zip后缀才能选中。 - 修复通过
PUT /api/v1/config写入配置时，若包含插件或站点凭据相关的键会被静默丢弃的问题，现在会直接返回错误提示。
v0.4.8 - 2026-09-20
🚀 Features
- Subscriptions can now use plugin-provided sources: when creating or managing a subscription, you can pick a plugin as the source instead of only plain RSS. Plugin-driven subscriptions discover new items on their own and automatically create download tasks, sharing the same filtering, deduplication, retry, and task-management pipeline as built-in RSS — enable and configure the plugin under Settings > Plugins first.
- Plugin login authentication: plugins that require signing in to a site now get a built-in login panel. Scan a QR code, or fill in the account/verification info the plugin asks for, using Cookie, Basic, Bearer, or custom-header authentication. Once logged in, credentials are automatically attached to that plugin's subsequent requests, you're prompted to log in again if the session expires, and you can log out manually at any time.
🐛 Bug Fixes
- Fixed garbled filenames for downloads from some servers: corrected double-encoding of raw bytes in the
Content-Dispositionheader, and improved filename parsing for Traditional Chinese, GBK, and similar encodings. - Fixed downloads failing (Windows error code 3) when the save directory or one of its parent directories didn't exist: HTTP, DASH, HLS, FTP, ED2K, and BitTorrent downloads now create the required directories automatically before writing files.
- The plugin install file picker in the web console now accepts
.fxplugfiles as well as.zip, so you no longer need to manually rename a plugin package to.zipbefore it can be selected. - Fixed
PUT /api/v1/configsilently discarding writes that included plugin or site-credential keys — it now returns an explicit error instead.
📦 直接下载运行（免 Docker）
| 平台 | 资产 |
|---|---|
| Windows x64 / ARM64 | FluxDown-Server-0.4.8-windows-{x64,arm64}.zip
|
| macOS Intel / Apple Silicon | FluxDown-Server-0.4.8-macos-{x64,arm64}.tar.gz
|
| Linux x64 / ARM64（musl 静态链接，任意发行版可用） | FluxDown-Server-0.4.8-linux-{x64,arm64}.tar.gz
|
| OpenWrt 软路由（x86_64 / aarch64 各子架构） | fluxdown-server_0.4.8_<arch>.ipk + luci-app-fluxdown_0.4.8_all.ipk
|
| QNAP NAS（QTS x86_64 / ARM64） | FluxDown-Server-0.4.8-qnap-{x64,arm64}.qpkg
|
| 群晖 NAS（DSM 7 / DSM 6，x86_64 / ARM64） | FluxDown-Server-0.4.8-synology-{dsm7,dsm6}-{x64,arm64}.spk
|
解压后直接运行 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
docker run -d -p 17800:17800 -v fluxdown-data:/data \
ghcr.io/zerx-lab/fluxdown-server:0.4.8Compose 部署见仓库 docker/docker-compose.yml。首次打开 Web 界面时按向导设置访问密钥，或用 -e FLUXDOWN_TOKEN=... 预置。