番茄小说下载器：怎么把整本小说快速离线搞定

番茄小说下载器：怎么把整本小说快速离线搞定

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

想把番茄小说存到手机或阅读器里？fanqienovel-downloader 是一个 Python 写的番茄小说下载器：输入书 id 或链接，它自动抓完整本书，存成 TXT、EPUB 等离线能看的文件。

📌 一句话定位：fanqienovel-downloader 只干一件事

把整本番茄小说从网上抓下来，存到本地，产出你随时能离线读的格式。它不做格式转换、不管其他小说网站，别指望它干别的。Web 版额外带了搜索、队列批量下载和在线阅读，下完可以边下边看。

场景选路：哪种跑法适合你

🚀 最快跑起来：Docker 一条路走通

最省事的默认路径是 Docker，不用碰 Python 环境：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader docker compose up -d

浏览器打开http://localhost:12930，输入书 id 或按名字搜，页面上能看到进度条，下完直接拿走文件。另外两种跑法，各一行说清：

• 本地 Python：pip install -r requirements.txt之后运行python src/server.py，入口地址同上
• Termux：pip install requests lxml ebooklib tqdm beautifulsoup4后运行python src/ref_main.py，纯命令行界面

📦 5 种输出格式速查：你能拿到什么文件

在设置页选保存模式，编号 1~5 一一对应：

拿不准就选 EPUB 或整本 TXT，这两个用的人最多。

⚙️ 关键设置：delay 和 xc，调之前先看懂

config.json里字段不少，真正影响体验的就这两个：

{ "delay": [50, 150], "xc": 16 }

• delay：每章之间的随机延迟（毫秒）。调大（如[200, 500]）总速度变慢，但基本不会被风控盯上；调小飞快，可请求太密容易触发风控，章节开始抓空。网络稳就用默认[50, 150]，老断就放宽区间。
• xc：并发抓取的章节数。调大（16 往上）速度快，但对网络压力也大；调小到 4~8 更温和，家宽和手机网络都能稳住。再往上加收益很小。

🩹 翻车自救：3 个高频问题直接给解法

lxml 装不上，报编译错：Termux 上最常见，先装编译工具再带参数装：

• apt install clang libxml2 libxslt
• CFLAGS="-O0" pip install lxml

端口 12930 被占，页面打不开：Docker 用户把docker-compose.yml里的映射改成12931:12930，再docker compose up -d一次；本机跑就把占着端口的进程停掉。

日志一直刷 ProxyError：多半是开了代理或加速器，关掉再试，多数情况直接恢复。

顺带一提：设置改乱了不知道回哪去，直接删掉config.json，下次启动自动恢复默认值。

进阶玩法：用 REST API 管书

Web 版本质是个 Flask 服务，对外暴露了 REST 接口：/api/search搜书、/api/download/<id>发起下载、/api/queue/status查进度，写脚本就能批量管书：

curl "http://localhost:12930/api/search?keyword=凡人修仙传"

fanqienovel-downloader 只做一件事：把番茄小说离线保存下来。适合想把书存在本地慢慢看的读者，和想挂机在 NAS、手机上的轻度技术用户；要做商用分发，或者下载番茄以外平台的内容，它不适合你。

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