★ FEATURED ARTICLE 【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载ReadMeABook 是一款功能完整的有声书请求与自动化下载引擎相当于有声书界的 Radarr/Sonarr Overseerr。它通过 Prowlarr 搜索资源位再交给下载客户端完成下载。本文将一次性讲清它支持的6 种下载客户端方案qBittorrent、Transmission、Deluge、SABnzbd、NZBGet 和内置直连下载帮助你快速选对客户端并完成配置。一、下载客户端在 ReadMeABook 中扮演什么角色ReadMeABook 的完整工作流是请求有声书 → Prowlarr 搜索资源 → 下载客户端下载 → 文件整理入库。下载客户端就是整条流水线的手脚。项目用一个统一接口 IDownloadClient 定义所有客户端的能力连接测试、添加下载、查询进度、暂停/恢复/删除、导入后清理因此新增客户端不需要改动任何消费方代码。所有客户端类型集中定义在 download-client.interface.tsexport const SUPPORTED_CLIENT_TYPES [qbittorrent, sabnzbd, nzbget, transmission, deluge] as const;二、6 种下载方案总览方案协议认证方式分类机制典型场景qBittorrentTorrentCookie 登录账号密码Categories最主流功能最全TransmissionTorrentHTTP Basic Auth CSRF 会话Labels轻量级、macOS 生态DelugeTorrentJSON-RPC仅密码标签/分类插件化灵活SABnzbdUsenet/NZBAPI KeyCategories路径式Usenet 行业标准NZBGetUsenet/NZBHTTP Basic AuthJSON-RPC配置式分类追求性能与低资源占用内置直连下载HTTP无需客户端无电子书旁车文件下载前 5 种通过 DownloadClientManager 统一管理第 6 种直连下载是项目内置的 HTTP 下载器无需任何外部服务。三、Torrent 三兄弟qBittorrent、Transmission、Deluge1. qBittorrent蓝色标签⭐ 首选开源 BitTorrent 客户端Web API 最完善是官方默认推荐方案。认证Cookie 登录制先调/auth/login获取会话 Cookie再操作http://qbt:8080/api/v2特色处理qBittorrent 添加种子只返回 Ok. 不带哈希项目会自行解析 magnet 或 .torrent 文件用 bencode 解码器提取info_hash实现确定性追踪彻底避免竞态问题自动分类每次添加下载都会自动创建/同步readmeabook分类并让分类保存路径始终跟随你配置的下载目录完整文档qbittorrent.md2. Transmission绿色标签认证HTTP Basic Auth且自动处理 CSRF——首次 RPC 调用收到 409 后捕获X-Transmission-Session-Id头并重试分类使用labels数组而非分类实现transmission.service.ts适用已运行 Transmission 的环境如 macOS 内置、轻量 NAS不想再装 qBittorrent 时选它3. Deluge青色标签认证JSON-RPC 接口POST /json仅用密码认证用户名留空即可智能重连会话失效错误码 1自动重新登录并重试守护进程断开错误码 2自动强制重连实现deluge.service.ts 注意三种 Torrent 客户端只能启用一个——每种协议限一个客户端添加第二个 Torrent 客户端时对应卡片会置灰并提示Protocol already configured。四、Usenet 双雄SABnzbd、NZBGetUsenet/NZB 下载不依赖 P2P速度稳定且无需做种适合有新闻源订阅的用户。4. SABnzbd紫色标签⭐ Usenet 首选认证仅需 API Key填在密码栏无需用户名最大优势内置自动后处理pp3——par2 修复损坏、自动解压 .rar/.zip、清理 .par2/.nfo 垃圾文件下载完成后downloadPath直接指向解压好的目录可无缝进入文件整理流程ID 机制SABnzbd 立即返回 NZB ID如SABnzbd_nzo_abc123无需像 qBittorrent 那样提取哈希状态追踪先查队列queue不在队列再查历史history覆盖 Downloading/Queued/Paused/Extracting/Completed/Failed 全状态完整文档sabnzbd.md5. NZBGet橙色标签认证HTTP Basic Auth JSON-RPCPOST /jsonrpc分类通过config()读取Category1.Name、Category1.DestDir等配置式分类可经config()saveconfig()自动管理后处理状态通过PP_*系列状态精细追踪修复/解压进度实现nzbget.service.ts五、第六种方案内置直连下载Direct Download除 5 种外部客户端外ReadMeABook 还内置了Direct Download处理器 direct-download.processor.ts用于电子书旁车e-book sidecar等场景由项目自己通过 HTTP 直接下载文件到指定路径完全不需要任何下载客户端带重试机制最多 5 次尝试和实时进度上报每 2 秒更新一次在管理端看到的进度条体验与 qBittorrent/SABnzbd 一致对新手最友好纯 Docker 部署下零外部依赖即可体验完整流程六、下载客户端如何配置配置入口两种方式安装向导首次部署时DownloadClientStep.tsx 会引导你添加至少一个客户端必填项管理后台Admin → Settings → Downloads标签页DownloadClientManagement.tsx 提供 41 列添加卡片qBittorrent / Transmission / SABnzbd / NZBGet / Deluge 已配置客户端卡片网格配置步骤以最常用的 qBittorrent 为例点击 qBittorrent 卡片的Add弹出 DownloadClientModal.tsx填写 Web UI 地址如http://qbt:8080、用户名、密码点击Test Connection测试连接测试通过后才允许保存返回版本号如 Successfully connected (v5.x)可选配置自定义子路径、远程路径映射、SSL 验证开关保存。API 层通过/api/admin/settings/download-clients的 CRUD 接口持久化到数据库旧版单客户端配置会在首次访问时自动迁移为新的 JSON 数组格式关键配置项速查配置项说明customPath每个客户端可设独立子目录如torrents→/downloads/torrents弹窗中实时预览最终路径remotePathMapping客户端与 ReadMeABook 文件系统视角不同时如 Docker vs Windows 宿主机的双向路径映射disableSSLVerify自签名证书常见于 seedbox可关闭 SSL 验证界面会给出安全警告category默认readmeabook每次下载自动创建/同步postImportCategory导入完成后将种子移动到指定分类便于按策略做种/清理⚠️路径一致性是关键你的下载客户端与 ReadMeABook 必须看到同一路径。Docker 部署时请确保 compose 中的./downloads卷映射到客户端容器的相同路径详见 volume-mapping.md。七、协议路由双客户端如何协同工作ReadMeABook 允许同时配置一个 Torrent 客户端 一个 Usenet 客户端系统会跨协议挑选最优资源。协议映射表 CLIENT_PROTOCOL_MAPqbittorrent → torrent transmission → torrent deluge → torrent sabnzbd → usenet nzbget → usenet双客户端搜索结果同时包含 Torrent 和 NZB由排名算法跨协议选出最佳发布单客户端只过滤该协议的搜索结果下载路由download-torrent.processor.ts 根据结果类型isNZBResult()自动把任务路由给正确客户端禁用客户端该协议的资源会被自动过滤不会报错八、6 种方案怎么选你的情况推荐方案首次部署、有 DockerqBittorrent默认推荐最省心已有 Transmission/Deluge 不想换直接接入现有客户端体验一致有 Usenet 订阅NewsNet 等SABnzbd自动解压修复下载体验最完整Usenet 且追求低资源占用NZBGet只要 Torrent Usenet 双通道qBittorrent SABnzbd 组合跨协议择优只下电子书旁车、零依赖内置直连下载九、延伸阅读多客户端架构完整文档download-clients.mdqBittorrent 深度集成路径映射、CSRF、种子状态等 17 个问题的修复细节qbittorrent.mdSABnzbd 集成与自动清理机制sabnzbd.md统一下载客户端接口与状态模型download-client.interface.ts客户端管理器工厂 单例缓存 协议路由download-client-manager.service.ts各客户端服务实现目录src/lib/integrations/配置好任意一种下载客户端ReadMeABook 的搜索 → 下载 → 整理 → 入库全自动流水线即可开始运转。赞分享【免费下载链接】ReadMeABookFully Featured audiobook request and downloading engine to bring audiobooks up to speed with the modern automation standards项目地址https://gitcode.com/gh_mirrors/re/ReadMeABook点击查看免费下载相关推荐CouchPotatoServer下载客户端配置Deluge、Transmission、qBittorrent详解CouchPotatoServer下载客户端配置Deluge、Transmission、qBittorrent详解 CouchPotatoServer是一款强后端PeerBanHelper 下载器配置终极指南快速连接 qBittorrent、Transmission、BiglyBT、Deluge 四大客户端PeerBanHelper 下载器配置终极指南快速连接 qBittorrent、Transmission、BiglyBT、Deluge 四大客户端 想要轻松配网络安全后端Lidarr下载客户端配置SABnzbd和NZBGet完美对接Lidarr下载客户端配置SABnzbd和NZBGet完美对接 Lidarr是一款专门为音乐爱好者设计的自动化媒体管理工具它可以自动搜索、下载和组织您的音乐后端上一篇Dopamine 中的 WrappedPrioritizedReplayBufferTensorFlow 图内采样的优先级经验回放详解下一篇Python内置函数优化LeetCode算法效率提升的10个实用技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
