fanqienovel-downloader：把番茄小说存到本地，多格式离线阅读
【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
fanqienovel-downloader 是一个用 Python 写的番茄小说下载器，输入小说 ID 或目录页链接，就能把整本书抓下来，存成 TXT、EPUB、HTML 或 LaTeX。它同时提供 Web 界面、命令行交互和 Docker 部署三种入口，支持队列批量处理和增量更新，下载完的文件直接推送到浏览器保存到本地，追连载、换设备阅读都不用再依赖平台在线状态。
先解决什么问题
- 追连载时地铁、高铁里信号断断续续，本地已有的章节才能接着读；
- 关注的书某天从平台下架，想再读却找不到入口；
- 手机、阅读器、电脑需要的文件格式不一样，手动复制排版又费时。
能力一览
这张表列出核心功能，方便你判断是否够用：
| 能力 | 解决什么 | 适合谁 |
|---|---|---|
| 按 ID 或链接下载 | 不记得书名也能拿到整本书 | 知道小说 ID 的用户 |
| 五种格式保存 | 整本 TXT、分章 TXT、EPUB、HTML、LaTeX 可选 | 不同阅读设备用户 |
| 增量更新 | 连载书只补新章节，不用整本重抓 | 长期追更的读者 |
| 队列批量下载 | 多本书排队依次处理，失败章节自动重试 | 一次存多本的人 |
| 浏览器在线阅读 | 下载的同时在网页里翻章节 | 临时查看内容的用户 |
第一次运行
三步就能跑通 Web 版，全程只需要一条启动命令：
git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txtcd src python server.py启动成功后，浏览器打开http://localhost:12930，在页面里输入小说 ID 或目录页链接，选择保存格式，开始下载。下载完成后点页面上的文件链接，浏览器会直接弹出保存窗口。
三种入口怎么挑
项目提供三种启动方式，按使用环境选一种即可：
| 入口 | 启动方式 | 适用场景 | 数据存在哪 |
|---|---|---|---|
| 命令行交互版 | 运行 src 目录下的 main.py | 本地快速单本下载，输入 ID 或链接即可 | 程序所在目录下的 novel_downloads |
| Web 版 | 运行 src 目录下的 server.py | 要进度条、队列、在线阅读，或放到远程机器上 | 同上，另含 data 目录的记录 |
| Docker | 项目根目录执行 docker compose up -d | 服务器或 NAS 长期运行，其他设备远程访问 | 数据卷 fanqie_data 与 fanqie_downloads |
Docker 方式不需要装 Python 环境，镜像构建完成后端口 12930 对外，配置里已写好两个数据卷，重新部署不会丢书。
批量下载：用队列把多本书排起来
Web 界面支持队列。把几本书依次加入队列后，后台按顺序逐本处理：当前这本完成才轮到下一本，单章失败会自动重试，页面上能实时看到进度和日志。放在远程机器上跑时，你在自己电脑的浏览器里就能操作，下载完的文件从页面直接取回本地。
更新已下载的书：只补新章节
连载书不需要每次整本重下。Web 版对已下载的书提供更新操作；命令行版输入 1 即可读取 record.json 里记录的 ID 逐个补新章节。每次下载还会在 data 目录生成 JSON 记录文件，存了全书章节内容，方便断点续传，也方便自己再加工。
容易卡住的点
Q1：报错里出现 ProxyError、Unable to connect to proxy 怎么办？多半是系统代理或加速器没关干净，关掉后重跑即可。
Q2：老版本直接抓不到内容？平台接口有变动，v1.1.5 及以前的版本已失效，请升级到 v1.1.6 及以上。
Q3：Python 3.8 及以下版本启动报错？把 src 目录下的 main.py 删掉，再把 main2.py 改名为 main.py 即可。
Q4：手机端 Termux 安装 lxml 失败？用CFLAGS="-O0" pip install lxml装，一般能过。
Q5：付费或会员章节能下吗？不能，工具只抓取公开免费的章节。
Q6：改乱了设置文件怎么恢复？删掉 config.json，程序下次运行会重建默认配置。
使用建议
- 先确认版本号再开始，老版本会白白浪费一次尝试；
- 按目标设备选保存模式：阅读器用 EPUB，手机上按章翻看用分章 TXT；
- 批量任务安排在空闲时段跑，并发线程数和请求延时在设置里都可以调；
- 放到远程机器上，务必把 data 目录和 novel_downloads 目录挂到数据卷或固定目录，避免重建容器后丢书；
- 提前规划保存目录，书多了方便按作者或状态整理；
- 控制下载频率，只抓自己会读的内容。
工具基于 Python 爬虫实现，适合个人学习研究使用，请遵守平台规则和当地法律。下一步建议先按上面的步骤跑通第一本，再根据需求决定用命令行还是 Docker 长期运行；手机端的 Termux 配置可参考项目里的 phone.md，使用细节见 README.md。
【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
