告别在线追更焦虑：番茄小说下载器5分钟把整本书存进本地

告别在线追更焦虑：番茄小说下载器5分钟把整本书存进本地

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

番茄小说下载器（fanqienovel-downloader）是一个免费开源的 Python 小工具，能把番茄小说整本书批量抓到本地，支持 TXT、EPUB、HTML、LaTeX 四种格式。说白了，它就像一台私人「离线书库搬运机」——你丢给它一个链接，它还给你一个文件，慢则几十分钟、快则几分钟，整本书就到手了。

周五晚上九点，你最想看的章节偏偏加载不出来

先讲个真实到扎心的场景。周五晚上九点，你洗漱完毕、调暗灯光、躺进被窝，终于到了每天最期待的追更时间。结果翻页翻到一半，页面转起了圈圈；Wi-Fi 信号满格，可番茄小说就是卡在原地。你刷新一次、两次、三次，再往后刷，弹出来一个广告，把好不容易加载出来的正文又挤走了。

这一刻你会不会想：要是这本书在我手机里，离线也能看，该多好？

而等你想重温某本完结小说的高光桥段时，更麻烦——目录翻半天、划屏划半天、广告弹窗还一路捣乱。在线阅读方便是方便，但书永远「寄居」在别人的服务器上，网络一波动，或者平台内容一调整，你手里的「阅读体验」说没就没。

动手之前，先把两个误区说破

很多朋友一听「下载小说」就摆手：「这得会爬虫吧？我没学过编程。」这其实是两个最常见的误会。

• 误区一：以为要自己写抓取代码。实际上，抓取、清洗、格式化、分页处理这些脏活累活，工具全都包了，你不需要理解任何一行爬虫逻辑。
• 误区二：以为只有技术宅才玩得转。它有三种使用方式，其中网页版全程鼠标点按，跟逛淘宝一样简单；想用命令行也行，但那只是「可选操作」，不是「必选门槛」。

正确的心态是：把它当成一个搬运工。你只需要做三件事——给链接、选格式、点下载，剩下的交给程序去跑。

认识一下这位「搬运工」：能力一览

想看源码的朋友，入口也就三个：下载引擎在src/main.py，网页服务在src/server.py，所有可调参数汇聚在src/data/config.json。顺着这三个文件看下去，实现思路一目了然。

上手地图：动手前先确认这三件事

第一件事，检查 Python 版本。命令行里敲一句python --version，3.8 及以上即可。个别旧环境若报语法错误，可参考项目说明把src目录里的main2.py改名为main.py再运行（需核实）。

第二件事，把源码请到本地：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt

第三件事，心里有个目录概念：主程序在src目录下，下载的书和配置会落在src/data（含config.json、record.json、bookstore），下载成品则存在src/novel_downloads。

三件事确认完，就可以挑通道了。

三条上路通道，总有一条适合你

不用纠结选哪个，直接对号入座：

怕敲命令、就想点点鼠标？→ 走Web 通道。 喜欢键盘效率、想要全键盘操作？→ 走命令行通道。 手里有服务器、想随时随地远程取书？→ 走容器通道。

通道一：Web 界面，5 分钟跑通

对新手最友好的一条路：

1. 进入src目录，运行python server.py
2. 浏览器打开http://localhost:12930
3. 在「搜索下载」框输入书名关键词，或在「直接下载」框粘贴小说目录页链接 / 数字 ID
4. 点下载，看进度条跑完，把文件存到本地

因为它是网页服务器架构，所以也能跑在远程服务器或容器里——你在哪都能访问，下载完直接取文件就行。界面里还内置了下载队列和在线阅读，多本书排队下载时，你甚至可以先把已下载的部分打开读起来。

通道二：命令行，一份菜单走天下

在项目根目录运行python main.py，会进入交互菜单，常用指令如下：

通道三：容器部署，一劳永逸

有容器基础的朋友，一条命令就能起飞：

docker compose up -d

启动后同样访问http://localhost:12930。小说数据与下载文件分别存在fanqie_data、fanqie_downloads两个卷里，想换存储位置，改一下docker-compose.yml的卷映射即可。

一次完整下载的路线图：四个动作，缺一不可

不管走哪条通道，核心流程都是这四步：

① 拿编号。打开小说目录页，链接末尾那串数字就是 ID；不想手动提取也行，整条链接直接粘进去，程序自己会解析。

② 选格式。手机随手看，TXT 最省心；Kindle 这类阅读器，EPUB 自带目录跳转；想保留排版和插图，HTML 更完整；学术或打印场景，LaTeX 的排版质量最高。

③ 定节奏。赶时间就把线程数调高，想低调些就加大章节间隔延迟，给服务器留点余地。

④ 收文件。剩下的交给程序：识别章节、处理分页、格式化正文、按设定逐章抓取，完成后到存储目录取走文件。

提速心法：五个值得一试的细节

细节一：把「更新」当成追更专用按钮。连载书下载过一次，隔几天再进菜单选1，程序会读record.json，只把新章节补进去，不用整本重跑。

细节二：线程数与延迟是一对搭档。xc可设 1 到 16。网好、赶时间就拉高线程；不想给服务器太大压力，就把延迟往上调，找到自己舒服的平衡点。

细节三：分章 TXT 更灵活。整本 TXT 适合一口气读；分章 TXT 每章一个文件，方便按章节整理、分享、二次加工，后续想合并拆分都容易。

细节四：格式随时可换。设置里改一下保存模式，再更新一次，就能拿到另一种格式的成品，不需要重新找书。

细节五：配置改乱了一键复位。设置里的每一项改动都会覆盖原数据，调乱了别慌，直接删掉src/data/config.json，下次启动程序会自动生成默认配置，不用重装。

对号入座：这份工具更适合谁

适合你，如果：你是番茄小说的常驻读者，想给心爱的书留一份本地备份；你习惯用 Kindle 等阅读器，需要把在线内容转成 EPUB；你手上正好有台服务器，想搭一个随时能取书的下载服务。

可以绕道，如果：你只是偶尔翻一本、并不在意离线阅读，那官方 App 完全够用；你对装 Python、装依赖这件事零耐心，那即便是最友好的 Web 界面，第一步环境配置也需要一点耐心。

急救手册：三个高频问题的处理姿势

问题一：报 ProxyError（代理错误）？十有八九是系统里开着代理或加速工具，跟程序抢网络通道了。关掉代理再试，通常立刻就好。

问题二：部分章节下载失败？程序内置重试机制，失败章节会跳过并记录。看一下日志里的具体原因，网络恢复后对这本书重新执行一次更新即可补上。

问题三：下载出来的正文排版不对劲？检查设置里的「正文段首占位符」和「占位符数量」两项，那是控制每段开头空格的开关，按自己阅读习惯调一下再更新。

写在最后

把喜欢的书留在自己手里，从来不是什么高深的技术活。这个工具真正的价值，是把「抓取、清洗、格式化、封装」这一整套工程藏在背后，让你把精力留给阅读本身。挑一个周末，clone 一份源码，选一本最近在追的小说，花五分钟体验一次从「在线追更」到「本地收藏」的转变。下次想重温某个情节时，打开本地文件，几秒钟就能翻到——那种踏实的掌控感，值得一试。

最后必须多说一句：任何下载工具，都请只用于个人学习与收藏，尊重作者版权和平台规则。理性使用，让好工具带来便利，而不是困扰。

备选标题（供选用）：

1. 整本搬空只需 5 分钟：用番茄小说下载器搭建自己的离线书库
2. 没有 Wi-Fi 也能看得爽：番茄小说下载器从安装到批量下载全攻略

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