番茄小说下载器 fanqienovel-downloader 完整指南：输入一个 id，整本书存成离线电子书

番茄小说下载器 fanqienovel-downloader 完整指南：输入一个 id，整本书存成离线电子书

【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader

坐地铁没网，想用手机继续看番茄小说，本地却只剩两章。fanqienovel-downloader 是个 Python 写的番茄小说下载器：输入书名或 id，它把整本书抓下来存成 TXT、EPUB，落在你手机或 NAS 上，随时离线看。

📦 先把成品拿在手里

跑完之后，你手里拿到的是现成的文件，不是看不见的“下载任务”：

• 整本 TXT 或 EPUB 是单个文件，手机点开就读，发给阅读器也能直接打开；
• 分章 TXT 是一个以书名命名的文件夹，一章一个文件，长书查起来方便；
• Web 版下载完成后，文件直接出现在浏览器下载框里，页面上还能先在线翻几页；
• Docker 版把东西存在两个卷里：fanqie_downloads放书，fanqie_data放配置和下载记录，容器重启都不丢。

一句话：跑完，书或记录都在你自己的硬盘上，不在云端。

🚀 挑一种最省事的跑法

推荐：电脑里有 Python 就选本地跑法，最透明；什么都没装过就直奔 Docker。

本地 Python是最标准的跑法：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src && python server.py

跑完后浏览器打开http://localhost:12930，是一个带搜索框和进度条的页面，输书名查 id，或直接输 id 就能开下，每章进度实时显示。

Docker：适合想挂在 NAS 或云服务器上长期挂机的人。项目目录里一句docker compose up -d就行，端口相同，书和配置自动落在卷里，挂几天不管也没事。

Termux：适合手机端。装好几个依赖后运行python src/ref_main.py，纯命令行界面，按提示输 id、选保存方式，书直接落在手机存储里。

📖 按你的阅读设备对号入座

格式在设置的save_mode里选，1~5 对应五种格式。先看你设备，再挑：

我的建议：拿不准就先选 EPUB（3），它覆盖墨水屏和大多数标准阅读器；手机只有简单 TXT 阅读器再退回整本 TXT（1）。HTML（4）给习惯浏览器看书的人，LaTeX（5）非打印刚需别碰。

🎛️ 三个值得动的开关

配置文件字段不多，真正值得动的就这三个，其余保持默认：

• delay（章节间延迟）：默认[50, 150]毫秒。什么时候调：发现章节抓空、中途断连，就放宽到[200, 500]。调大更慢，但稳。
• xc（同时抓的章节数）：默认 16。普通家宽给 4~8 就够，再往上速度没多少收益，风控压力反而更大，宁可低不要高。
• save_mode（保存格式）：默认 1。按上一节的表格选，纯粹看你的阅读设备，不影响下载速度。

底层逻辑就是给每次请求加随机延迟、再轮换请求身份来降低风控概率，所以参数往温和里调，比什么技巧都管用。

🔧 跑不动时按这个清单查

• 现象：lxml装不上（Termux 常见）→原因：缺编译工具链 →解决：先apt install clang libxml2 libxslt，再CFLAGS="-O0" pip install lxml。
• 现象：页面打不开 →原因：12930 端口被占 →解决：Docker 把 部署配置 里的映射改成12931:12930再重启；本机跑就停掉占端口的进程。
• 现象：TXT 乱码或段首缩进怪 →原因：编辑器编码问题，或配置被改过 →解决：用 UTF-8 编辑器（VS Code、记事本）打开；缩进不对就删掉config.json恢复默认。
• 现象：日志刷ProxyError→原因：你开了代理或加速器 →解决：关掉再跑，基本就好了。

🔌 想用脚本批量管书

Web 版本质是个 Flask 服务，服务端源码 里暴露了几个 REST 接口，常用的三条：

curl "http://localhost:12930/api/search?keyword=剑来" curl http://localhost:12930/api/download/7143038691944959011 curl http://localhost:12930/api/queue/status

第一条按书名搜索拿 novel_id，第二条用 id 发起下载，第三条查队列进度，串起来就是一套批量管书的小脚本。

写在最后

fanqienovel-downloader 只干一件事：把番茄小说离线保存下来。选个格式、挑种跑法，书就是你的，还能长期挂在 NAS 上挂机。适合想把书存到本地慢慢看的读者，和想在 NAS、手机上挂机的轻度技术用户；不适合指望它做内容商用的分发，也不支持番茄以外的平台。更多使用说明和设置细节，看 官方 README。

【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader