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

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

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

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

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

1. 安装Python 3.9以上版本，然后在项目根目录执行pip install -r requirements.txt安装全部依赖（包括Flask、lxml、ebooklib等）。
2. 进入src目录，运行python server.py，看到提示后，用浏览器打开http://localhost:12930。
3. 在"搜索"页面输入小说名称，点搜索；或者在"直接下载"框里粘贴小说ID或链接，点下载。
4. 观察弹出的下载进度条，等进度走满后，到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单文件版本可在手机终端运行，通勤路上也能顺手下载。

三、一个完整实战案例：从零下载《某本连载小说》到EPUB

把前面零散的功能串起来，走一遍完整流程。假设我要把一本连载中的小说保存成EPUB放进电子书阅读器：

第1步：配置格式。进入设置页面，保存方式选择"EPUB格式"；段落占位符先保持默认，后面不满意再调；下载线程数填8（稍后解释为什么）。

第2步：找到目标。在搜索框输入书名关键词，从结果里确认作者和字数，认准后点下载。

第3步：排队等待。任务进入下载队列，进度弹窗实时显示当前章节、完成百分比和日志。EPUB的生成会额外拉取封面和作者信息，比TXT略慢，属正常现象。

第4步：验证成品。下载完成后，在下载目录里找到.epub文件，拷入阅读器或电脑打开，检查封面、目录跳转和正文排版。

第5步：持续追更。隔几天再打开Web界面，书库中这本书显示"最后更新"日期，点"更新"，程序只下载新增章节并重新打包EPUB，全程无需手动合并文件。

五步走完，一本会"自己长大"的电子书就诞生了。整个过程的核心体验是：搜索、下载、更新全在同一个界面完成，不用碰任何代码。

四、高手进阶与排雷：参数调优和常见问题

想让下载更快？控制好这三个参数

• 线程数（xc）：默认16，数值越大并发下载越快，但太猛容易被目标站点限制。日常使用建议8~16之间，网速一般就调低些。
• 请求延迟（delay）：设置50~150毫秒的随机间隔，模拟真人访问节奏。频繁报错就适当加大延迟。
• 段首占位符（kg/kgf）：控制正文每段开头的空格数量和类型，喜欢传统中文排版的可以设置成全角空格，导出效果更像纸质书。

遇到报错怎么办？四个高频问题直接对号入座

Q1：提示ProxyError: Unable to connect to proxy？A：网络或代理设置有问题。先关掉系统代理、加速器等工具再重试，大多数情况立竿见影。

Q2：章节下载失败或内容为空？A：先确认小说ID或链接没复制错，再检查网络稳定性；工具本身对失败章节有3次自动重试，偶尔一两个失败可以重新下载整本书补全。

Q3：修改设置后行为变得奇怪？A：设置中修改任意选项都会覆盖原数据，如果调乱了，删除data/config.json即可恢复默认值。

Q4：想换保存位置或备份数据？A：命令行版有专门的备份功能，Web版则直接复制data和novel_downloads两个目录就能整体迁移，Docker部署的对应两个卷。

两个容易忽略的小技巧

• Cookie自动续期：工具内置了cookie获取和失效自检机制，下载中途遇到内容异常会自动刷新cookie重试，普通用户无需手动干预。
• 定期清理缓存：Web界面顶部有"清理缓存"入口，跑久了点一下，避免本地积累过多中间文件。

五、写在最后：把喜欢的故事留在自己手里

这款下载器最适合三类人：每天追更、怕作品下架的连载读者；想在Kindle、阅读App里舒服看书的重度书虫；以及想折腾部署、研究Python爬虫技术的爱好者。它不要求你会写代码，Web界面点点鼠标就能完成全部操作；想深入钻研的，源码结构清晰，二次开发空间也很大。

需要提醒的是，下载内容仅限个人阅读与学习使用，请遵守网站政策、合理控制请求频率，别把工具用在商业用途上。打开终端跑起来，把你书架上的心爱之作都备份一份吧——安全感这东西，还是握在自己手里最踏实。

技术栈速览：Python + Flask + SocketIO + gevent 多线程并发 + ebooklib + lxml，项目源码与使用说明都在src目录和项目根目录的README.md中，想了解实现细节随时可查。

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