番茄小说下载器 fanqienovel-downloader：一键把整本书存成本地离线电子书

番茄小说下载器 fanqienovel-downloader：一键把整本书存成本地离线电子书

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

想把番茄小说存到本地、断网也能看，是不是你的日常痛点？fanqienovel-downloader 是一个 Python 写的下载工具：输入小说 id 或完整链接，它自动把整本书按章抓下来，存成 TXT、EPUB 等格式放到本地，以后离线也能读。Web 版还带搜索、批量下载队列和在线阅读，适合想把书存到手机或阅读器里的普通读者，也适合想在 NAS 上长期挂机的轻度技术用户。

下载下来的书长什么样：文件格式对照

下载完，一本书可以按你的阅读场景输出成 5 种格式，照着表选就行：

格式在设置的save_mode字段选，1 到 5 一一对应，不用懂原理。

电脑、NAS、手机：分别怎么跑起来

电脑上跑

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，就是一个带进度条的 Web 页面，输入 id 或书名即可开下。

丢到 NAS 上

cd fanqienovel-downloader docker compose up -d

同样访问http://localhost:12930。下载的书和配置分别存在fanqie_downloads、fanqie_data两个卷里，重启容器也不会丢。

手机上跑

pip install requests lxml ebooklib tqdm beautifulsoup4 python src/ref_main.py

lxml 编译报错的话，先apt install clang libxml2 libxslt再CFLAGS="-O0" pip install lxml。跑起来是命令行界面，按提示输入 id 或链接、选保存方式，书就直接落在手机存储里。

跑起来之后怎么用：搜索、队列、API

Web 页面就四个功能区：搜索、下载、书库、设置。知道 id 直接输入就开下；不知道就先按书名搜书拿到 id。可以把多本书加入队列批量下载，进度条会实时显示正在下哪一章；下完的书还能直接在浏览器里在线阅读。

核心服务代码在src/server.py，对外暴露了几个 REST 接口：/api/search?keyword=搜书、/api/download/<novel_id>发起下载、/api/settings读写配置、/api/queue/status查队列进度。想拿脚本批量管书，一条就够：

curl "http://localhost:12930/api/search?keyword=剑来"

返回 JSON 列表，里面有每本书的 id，直接拿去调下载接口就行。

最值得调的 2 个设置：延迟和并发数

配置字段不多，真正影响体验的就两个（外加一个格式开关）：

{ "delay": [50, 150], "xc": 8, "save_mode": 3 }

• delay（章节间隔延迟，毫秒）：调大每章之间歇得久，总速度慢但基本不会被限；调小飞快，但请求太密容易被风控，章节开始抓空。网络稳用[50, 150]，老被断就放宽到[200, 500]。
• xc（并发章节数）：调大就是多只手同时抓，快但压力也大；调小更温和。家宽和手机网络给 4~8，带宽足给 8~16 就够，再往上收益很小。
• save_mode（格式）：1 整本 TXT、2 分章 TXT、3 EPUB、4 HTML、5 LaTeX，没有性能差异，纯粹按阅读器选；先选 EPUB 或整本 TXT，准没错。

底层其实就是随机延迟加多个请求身份轮换来降低被风控的概率，参数调温和一点，比什么技巧都管用。

常见问题：4 个症状对号入座

lxml 装不上：Termux 先apt install clang libxml2 libxslt再CFLAGS="-O0" pip install lxml；Windows/Linux 重建一个干净的 venv 再重装依赖。

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

TXT 打开乱码、段首空格怪：用 VS Code、记事本等 UTF-8 编辑器打开；缩进不对就删掉config.json恢复默认，或在设置里把段首缩进改回 2 个全角空格。

日志刷 ProxyError：多半是你开了代理或加速器，关掉再试。

fanqienovel-downloader 就是干一件事：把番茄小说离线保存下来——选个格式、跑起来、等下完。适合想把书存到本地慢慢看的读者，和想把服务挂在 NAS/手机上长期跑书的轻度技术用户；不适合需要商用内容分发、或指望它下载番茄以外平台的人。

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