番茄小说下载工具完全指南：5种导出格式、3种运行方式，把心爱小说永久留在本地

番茄小说下载工具完全指南：5种导出格式、3种运行方式，把心爱小说永久留在本地

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

整理数字书架，是每个重度阅读者迟早要面对的问题：收藏夹里攒下几十本小说，换一台设备、清一次缓存，可能就再也找不回来。番茄小说下载工具（fanqienovel-downloader）正是为「小说离线阅读」场景设计的开源方案——输入一本小说的ID或完整链接，它会自动抓取全部章节，以TXT、EPUB、HTML、LaTeX等格式保存到本地，让「把番茄小说下载到本地」这件事变得稳定可靠，从此离线也能随时翻阅。

认识工具：它本质上是一个本地书库管家 📦

先说清楚它能做什么。这个由Python编写的小工具，核心只有一件事：把番茄小说平台上的整本作品，完整、有序地搬进你自己的硬盘。围绕这个核心，它衍生出几条很实用的能力：

• 一次输入，整本打包：粘贴小说ID或详情页链接即可，无需逐章手动保存；
• 五种保存格式：整本TXT、分章TXT、EPUB、HTML、LaTeX，覆盖从日常阅读到排版印刷的常见需求；
• 追更与批量：记录已下载作品，一键更新最新章节；多本书排队下载，全程无需值守；
• 内置搜索与阅读：Web版可按书名搜索小说，下载完成后还能直接在浏览器里阅读；
• 三种运行方式：命令行、Web图形界面、Docker容器，手机端也有轻量方案。

值得一提的是，工具完全离线工作，没有账号体系，也没有任何广告。下载记录、配置、Cookie都以本地文件形式保存，随时可以整体搬迁到别的设备。

第一次下载的完整步骤：十分钟内拿到第一本书 ▶

对新手来说，最快的路径是Web版。它提供了图形界面，所有操作靠点击完成：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src && python server.py

终端出现提示后，用浏览器打开 http://localhost:12930，就能看到下载器界面。接下来只需三步：在搜索框输入书名，或粘贴小说详情页里的那串数字ID；选择保存格式；点击下载。界面上有实时进度条，下载完成后，文件会出现在 novel_downloads 目录里，这本书就正式归你所有了。整个流程不需要写一行代码，也无需理解任何底层机制。

把整本书导出为EPUB：五种格式怎么选

进入设置页面，可以看到「保存方式」这一项，对应五种输出格式：

1. 单个TXT文件：整本书合并成一个txt，兼容性最好，任何设备都能打开；
2. 分章节TXT文件：每章一个文件，适合需要按章节整理或做笔记的场景；
3. EPUB格式：带目录结构的主流电子书格式，Kindle和手机阅读器都能直接导入；
4. HTML格式：保留富文本排版，适合在浏览器里阅读或二次加工；
5. LaTeX格式：面向专业排版需求，方便进一步生成PDF等成品。

同一本书，随时可以换一种格式重新下载，不用重复做任何准备。如果你主要用电子书阅读器，EPUB几乎是最省心的选择——导入后自动生成目录，翻页体验与正版电子书无异。

进阶用法：批量排队、追更更新与在线阅读 ✅

用顺手之后，你会发现Web版还藏了不少提高效率的设计：

• 多书排队：把几本书依次加入下载队列，程序按顺序处理，批量搬家时非常省心；
• 一键追更：对已下载的作品选择更新，程序会读取本地记录，只补齐新章节，不必整本重下；
• 在线阅读：下载完成的作品可直接在网页阅读器里打开，相当于自带一个轻量书库；
• 清理缓存：界面提供一键清理入口，长期使用后可以顺手维护。

这些功能共同指向一个目标：让「下载」从一次性操作，变成可持续维护的日常习惯。

三种运行方式：本机、Docker与手机 🐳

Web版之外，工具还提供几种部署形态，适配不同场景。

命令行版适合熟悉终端的用户。启动后输入数字进入对应功能：直接输入ID或链接下载；输入1更新已下载作品；输入2按书名搜索；输入3批量下载；输入4进入设置；输入5备份下载记录与格式设置；输入6退出。菜单一目了然，记忆成本很低。

Docker版适合放在NAS或云服务器上长期运行。进入项目目录执行docker compose up -d，容器在后台启动并映射12930端口，小说文件与用户数据分别存放在两个数据卷中，重装系统也不丢失。部署后，任何设备打开浏览器访问服务器地址即可远程使用。

手机轻量版面向通勤场景：在Termux中安装requests、ebooklib、tqdm、beautifulsoup4这几个库，直接运行精简版脚本，不需要图形界面也能完成下载，依赖很轻。

常见问题排查与使用边界

使用过程中，有几个高频问题值得提前了解：

• 报ProxyError：绝大多数情况是系统代理或加速器干扰了请求，关闭代理后重试即可；
• lxml安装失败：部分Python环境下会出现编译问题，可尝试CFLAGS="-O0" pip install lxml；
• 设置改乱了：删除config.json文件，重启程序即可恢复默认配置；
• 版本过旧：番茄小说平台的接口会不定期调整，请使用较新版本，并建议在Python 3.8及以上环境运行。

最后说明使用边界：该项目定位为学习爬虫与网页处理技术的参考实现，请仅用于个人学习与备份，尊重作者和平台权益，不要用于商业用途。

结语：把喜欢的东西握在自己手里

数字内容最大的风险，从来不是「读不完」，而是「某一天再也打不开」。与其在平台调整时追悔，不如现在就花十分钟把这套工具跑起来：克隆项目、安装依赖、启动服务，第一本离线小说马上就能落地硬盘；之后的批量搬家、追更维护、远程部署，都只是顺手的事。

想继续深入了解，项目自带的README文档覆盖了完整的功能说明与常见问题解答，还介绍了几个配套的衍生小工具；遇到问题也可以在项目的交流群（QQ：428582738）里与开发者和使用者直接讨论。

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