番茄小说下载器完整攻略：5种格式批量下载与Web界面部署实战-尧图网络科技

番茄小说下载器完整攻略：5种格式批量下载与Web界面部署实战

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

深夜追更到最新一章，第二天打开书架却提示"内容下架"——这种追书人最怕的遭遇，其实完全有办法避免。今天要聊的这款开源工具「番茄小说下载器」（fanqienovel-downloader），就是帮你把喜欢的作品一键搬到本地、彻底告别"书没了"焦虑的实用利器。它由Python编写，既能通过命令行干活，也带一个现代化的Web操作界面，支持整本TXT、分章TXT、EPUB、HTML、LaTeX五种格式导出，还能自动检测新章节做增量更新。下面这份攻略，从零开始带你把它跑起来。

一、三分钟上手：先让第一本小说落进硬盘

别急着研究原理，先把工具跑通，看到实际效果比什么都重要。推荐走Web版路线，因为它最直观。

安装Python 3.9以上版本，然后在项目根目录执行pip install -r requirements.txt安装全部依赖（包括Flask、lxml、ebooklib等）。
进入src目录，运行python server.py，看到提示后，用浏览器打开http://localhost:12930。
在"搜索"页面输入小说名称，点搜索；或者在"直接下载"框里粘贴小说ID或链接，点下载。
观察弹出的下载进度条，等进度走满后，到src/novel_downloads目录里就能看到成品文件。

预期结果：一本几百章的小说在几分钟内下载完成，文件按你选定的格式保存，书库里也能看到这本书，可以直接点"阅读"在线看。整个过程不到五分钟，工具的价值已经体现出来。

二、功能亮点巡礼：它到底解决了哪些追书痛点

想离线阅读？5种导出格式任你挑

下载只是第一步，关键是拿到手之后怎么用。这个工具最厚道的地方在于保存格式覆盖了几乎所有阅读场景：

整本TXT：全部章节合成一个文件，手机阅读器、Kindle、电脑记事本通吃。
分章TXT：每章一个文件，配一份目录.txt，适合喜欢按章节整理收藏的长篇小说。
EPUB：带封面、作者信息和可点击目录的电子书标准格式，电子书阅读器体验最佳。
HTML：保留排版和样式的网页版，浏览器里阅读最舒服。
LaTeX：学术级排版，适合想打印成册或自己排版成PDF的进阶用户。

切换方式很简单：在Web界面的"设置"里，把保存方式选成对应选项即可。

书荒找书？名字搜索、ID直下两条路都通

知道书名却不知道ID，就用关键词搜索，结果会显示作者和字数，一键加入下载；手里正好有小说链接或ID，直接粘贴进"直接下载"框，免去搜索步骤。两种入口对应两种使用习惯，总有一条适合你。

追更麻烦？增量更新只补新章节

这是很多追更党的刚需。书库页面点"更新"，工具会读取之前的下载记录，只拉取新增章节，已经下过的内容直接跳过，既不浪费流量也不重复劳动；"更新所有小说"按钮则一键处理整个书库。

批量下载？队列机制帮你排好队

Web版内置下载队列，可以把好几本书依次加入任务列表，一次设置统一格式，让程序一本本处理。挂机睡觉，醒来书库自动多出几本完整作品。

部署在哪？本地、Docker、手机都能跑

本地Python环境：开发调试最灵活，适合爱折腾的朋友。
Docker容器：一条docker compose up -d命令启动，自带1GB内存上限和256MB预留的资源配置，数据通过fanqie_data、fanqie_downloads两个独立卷持久化，重启不丢，特别适合扔在服务器或NAS上长期挂着。
手机Termux：项目提供的ref_main.py单文件版本可在手机终端运行，通勤路上也能顺手下载。