番茄小说下载器上手指南：3步把追更的书变成离线书库

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

朋友上周来找我诉苦：追了三个月的书因为版权调整突然下架，收藏夹里只剩一个灰色封面。这种"书还在，入口没了"的滋味，追更的人都懂。后来我翻到一个叫fanqienovel-downloader（番茄小说下载器）的开源项目——一个用 Python 写成的番茄小说下载工具，能把整本小说拉到本地，从此阅读不再看网络和平台的脸色。

它解决的事情很简单：把你在番茄小说上喜欢的内容，变成永远属于你自己的离线文件。下面按三条成长路径，带你从零玩到熟。

第一关 入门：十分钟跑起一个网页版

适用人群：想开箱即用、一点代码都不想碰的你。

最省事的入口是 Web 版，只需要三步：

1. 获取项目：git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
2. 安装依赖：pip install -r requirements.txt
3. 启动服务：进入src目录，运行python server.py

然后浏览器打开http://localhost:12930，一个带搜索、书库、阅读器和设置页面的完整界面就出现在眼前。全程不需要配数据库、不需要写配置文件，跑起来就能用，比很多商业软件还省心。

真正的核心命令只有一行：

cd src && python server.py

这行命令负责启动一个本地网页服务，之后你在浏览器里做的所有操作——搜索、下载、阅读——都由它代为完成，就像给小说平台开了一个"自助提货窗口"。

第二关 进阶：把三个核心能力用到极致

过了上手这关，你会意识到这工具真正值钱的是下面三件事。

以前：想存整本书，得一章一章手动复制，还要忍受页面广告。现在：粘贴小说 ID 或目录链接，一键拉取全部章节，进度条实时滚动，下完自动归档到本地文件夹。

以前：追更的书每次都要整本重下，流量和时间双重浪费。现在：程序把下载记录写进record.json，按一下更新，只补齐新增章节，像手机 App 的增量更新一样精准——好比水果店老板记住你上次买了多少，这次只给你称新到的货，绝不让你重复买单。

以前：Kindle 要一种格式，手机要一种格式，换来换去很麻烦。现在：一种设置输出五种格式——整本 TXT、分章 TXT、EPUB、HTML、LaTeX，想投喂给哪个设备都行。

来一次完整演示：假设你看中一本正在连载的书，复制它的目录链接 → 在 Web 界面搜索框粘贴 → 选 EPUB 格式 → 点下载 → 看着进度条从 0 走到 100%。几分钟后，一本几百章的小说就静静躺在下载列表里，断网、下架、改版权，都跟你没关系了。

第三关 高手：部署、调优、玩出花样

愿意再多花五分钟的话，体验还能再上一个台阶。

挂到服务器上长期服役：项目自带docker-compose.yml，一条docker compose up -d完成部署。下载的书存在 Docker 卷（fanqie_data和fanqie_downloads）里，重启、换机器都不丢，适合放在 NAS 或云服务器上 7×24 小时运行。

提速就调配置：编辑config.json里的delay（请求间隔）和xc（并发线程数），网络状况好就把间隔调低、线程调到 16 到 24，下载速度立竿见影。改乱了也不慌，删掉配置文件即可恢复默认。

手机党专用：在 Termux 里配好 Python 环境后运行ref_main.py，命令行版照常工作，地铁上想收哪本就收哪本。

避坑三问：新手最容易踩的坑

Q1：报 ProxyError、连不上服务器？多半是电脑开着代理或加速器，关掉再试，项目的 README 里专门讲过这个问题。

Q2：设置改乱了怎么恢复？设置里每一项修改都会覆盖原数据，拿不准就别动，直接删除config.json一键还原。

Q3：老版本突然不能用了？番茄小说的接口会不定期变化，v1.1.5 及以下版本已确认失效，务必升级到最新版——这也是作者反复强调"且用且珍惜"的原因。

写在最后

工具免费、开源、持续更新，这就是它最打动人的地方。它解决的不仅是"怎么把书存下来"，更是"怎么让阅读不依赖网络和平台"。现在就去 clone 项目、跑起服务，把第一本书收进自己的书库吧。遇到问题可以去项目 Issues 里讨论，或者加 QQ 群 428582738 找同好交流。

项目遵循AGPL-3.0 协议开源，由 Yck、Yqy（qxqycb）、Lingo（lingo34）三位开发者共同维护。使用说明见仓库 README.md，命令行入口在src/main.py，Web 服务端在src/server.py。请记得：工具只用于个人学习与离线阅读，尊重版权，合理使用。📚

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