追更的小说一夜下架，我用这款免费的番茄小说下载器搭起了私人离线图书馆-育师

追更的小说一夜下架，我用这款免费的番茄小说下载器搭起了私人离线图书馆

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

上个月，我追了半年的《星河入梦》毫无征兆地在番茄小说上变成了"内容已下架"。七百多章，我还没看到结局，一夜之间全部消失。那种"追更断粮"的憋屈，追过书的人都懂。也是从那天起，我认真找了一款能把小说"搬回家"的工具——fanqienovel-downloader（番茄小说下载器）。它是一个免费开源、基于 Python 的离线下载工具，只要一个链接或小说 ID，就能把整本书保存为 TXT、EPUB、HTML 等格式，从此喜欢的故事牢牢握在自己手里。

一场"下架事故"，治好了我的在线阅读依赖

说来也巧，出事那天我正卡在高铁隧道里。网络信号一格都没有，想看的章节加载不出来；等信号恢复，点开小说详情页，页面已经提示"该作品已下架"。那一刻我突然想明白：在线平台上的书，本质上只是"借来的"——平台可以随时收走它，而我毫无办法。

所以当朋友把番茄小说下载器丢给我时，我的第一反应是：真的能行？而它给我的回答，是一次干净利落的实测。

亲测记录：十几分钟，整本书落地 ⚡

我按照项目 README 的指引一步步来，全程没有遇到任何门槛：

把项目克隆到本地：git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
在项目根目录执行pip install -r requirements.txt，把依赖一次性装齐
进入src目录，运行python server.py，终端提示我打开http://localhost:12930
在网页里搜出书名，加入下载队列，点下"下载"

接下来的画面让我印象很深：网页上的进度条一路往前跑，几百章的章节以并发方式（默认 16 线程）被快速抓取，中间偶有失败的章节，程序会自动重试，最多三次。几分钟后，一本完整的 EPUB 文件出现在下载目录里。

把这本 EPUB 拖进手机阅读器的那一刻，我知道自己的阅读习惯回不去了：

场景	以前在线追更	现在离线阅读
地铁、高铁没信号	只能干瞪眼	随时翻开，毫无压力
平台下架、锁章	直接断粮	文件早已存进本地
换手机、换阅读器	进度迁移麻烦	一个文件带走

三条上手路径：新手走网页版最省心

对于绝大多数人，我的建议是直接用 Web 界面版——这也是项目里最"傻瓜"的入口，核心服务在src/server.py，启动后就是一个跑在本地的小型网站。

安装 Python 3.8 及以上版本
安装依赖并启动服务（上面已经演示过）
浏览器打开http://localhost:12930，粘贴小说 ID 或书名搜索，点下载即可

如果你喜欢键盘操作，命令行版src/main.py也很有意思：启动后输入数字就能选择"直接下载、更新、搜索、批量下载、设置、备份"，一个菜单走天下。而如果你有一台长期在线的服务器，Docker 版一行docker compose up -d就能跑起来，下载的数据存放在 Docker 卷里（fanqie_data和fanqie_downloads），特别适合搭一个家庭书库。

方式	适合谁	亮点
Web 界面版	新手、日常使用	进度条、队列、在线预览，所见即所得
命令行版	极客、批量管理	菜单化操作，方便写脚本自动化
Docker 版	服务器长期运行	数据持久化，开箱即用

这 5 个细节，用过的读者都会反复回看 💡

使用一段时间后，我整理了最常被问到、也最实用的小知识：

能存成哪些格式？目前支持五种：整本 TXT、分章 TXT、EPUB、HTML、LaTeX。手机和电子书阅读器首选 EPUB，排版和目录最友好。
追更怎么办？已下载的小说会记录在record.json里，一键更新只会补拉新增章节，不用整本重下。
想批量囤书？网页版自带下载队列，把几本书依次加进去，排队挂机即可，人完全可以走开。
下载慢、有章节失败？网络好的时候可以调高并发数xc、缩短请求延时delay；偶发失败的章节会自动重试，通常不用手动干预。
设置改坏了怎么恢复？直接把config.json删掉就能回到默认配置。另外，手机用户可以在 Termux 里运行ref_main.py，通勤路上也能随时更新书库。