番茄小说下载器离线阅读手册：一本书五种导出格式，三条启动路径一次讲透

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

fanqienovel-downloader（番茄小说下载器）是一个用 Python 写成的开源工具，作用很纯粹：把番茄小说平台上的整本书抓取下来，以 TXT、EPUB、HTML 等格式永久保存在本地。从此追更不怕章节被锁、通勤不怕没信号、换设备不用重新找书。接下来这篇文章会按"它有什么用 → 怎么快速装好 → 三个运行环境怎么选 → 参数怎么调 → 踩坑怎么躲 → 还能怎么玩"的顺序，带你从零把它跑起来。

它解决的痛点：把"在线阅读"变成"本地资产"

在线看小说，你有过这些经历吗？地铁隧道里刷着刷着转圈圈；追了一半的书突然下架；换了新手机，收藏夹里一堆链接全失效。这些问题的根源只有一个——内容不在你手里。

番茄小说下载器就是为此而生的。你只需要给程序一个目录页链接或一串书籍 ID，它会自动识别章节结构，把正文一章一章抓回来存到本地。下载完成后，这本书就真正属于你了：断网能读、下架不怕、手机平板电纸书随意分发。

更贴心的是，它不是一个"一次性工具"。程序自带更新检测，会读取record.json里记录过的书籍 ID，自动对比并补抓新增章节。追连载小说时，每天跑一次就等于自动帮你把新章节收进书库，完全不用手动对比。

能力全景：一张表看懂它能干什么

打开工具，你会发现它能做的事比想象中多。这里把核心能力整理成一张速查表：

五种输出格式，按阅读习惯自由切换

目前版本（v1.1.14）支持五种保存方式，对应不同人群的阅读习惯：

日常手机阅读推荐 EPUB，体验最接近原生电子书；空间紧张就退回 TXT，体积最小；要做内容处理再考虑分章与 LaTeX。这些选项在设置里随时切换，不需要安装任何额外转换工具。

上手第一步：三分钟跑通命令行版

命令行版是所有玩法的基础，进入项目src目录后运行主程序即可：

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

程序启动后，交互菜单只认六个选项，跟着中文提示走就行：

1. 输入 ID 或链接——立即下载单本书
2. 输入 1——读取record.json更新已下载书籍
3. 输入 2——关键词搜索小说
4. 输入 3——批量下载多本书
5. 输入 4——进入设置（段首占位符、延时、保存路径、保存模式、线程数）
6. 输入 5——备份小说文件与下载配置
7. 输入 6——退出程序

每一步都有清晰的中文提示，几乎不需要翻文档就能上手。

想要图形界面：一行命令启动 Web 服务

命令行对新手不太友好？项目还提供了完整的 Web 版。在项目src目录下运行：

python server.py

然后用浏览器打开http://localhost:12930，就能看到一个简洁的管理界面。它具备完整的图形化操作：

• 按 ID 下载，也能按书名搜索后直接下载
• 实时进度条，每章状态一目了然
• 下载队列，把好几本书加进去批量处理
• 一键更新已下载的小说
• 在线阅读器，下载完直接在浏览器里看

Web 版下载完成后会直接把文件交给你，因此它可以部署在远程服务器或容器里，随时通过浏览器调用，相当于给家里 NAS 装了一个专属的小说下载服务。

放服务器上长期跑：Docker 一步到位

想 7×24 小时常驻运行，用 Docker 最省心。项目根目录已经备好Dockerfile和docker-compose.yml，一条命令搞定：

docker compose up -d

构建完成后访问http://localhost:12930即可使用。几个值得注意的细节：

• 下载的小说和个人数据分别存放在名为fanqie_data、fanqie_downloads的 Docker 卷中，容器销毁数据不丢；
• 想改存储位置，编辑docker-compose.yml中的卷映射即可；
• 镜像默认设置了 1G 内存上限，避免长期运行挤占主机资源。

手机也能离线下载：Termux 三步走

在 Android 设备上装好 Termux 终端，就能把命令行版跑起来（运行的是ref_main.py）：

pip install requests ebooklib tqdm beautifulsoup4

两个易错点提前提醒：先删掉ref_main.py里的 tkinter 导入；若安装 lxml 报错，改用CFLAGS="-O0" pip install lxml重装。完成后运行python ref_main.py，通勤路上离线阅读完全够用。更详细的换源与依赖安装步骤，见项目根目录的 phone.md。

几个关键参数，决定下载体验

src/main.py中的Config定义了下载核心参数，修改后保存在config.json：

网络状况良好时，可以适当降低延时、把线程数提到 24 左右提速；手机端建议调低线程数，避免过热。注意：修改设置的任意一项都会整体覆盖原配置文件，改前先看清楚；想恢复默认，直接删除config.json后重启程序即可。

常见报错与排雷清单

根据项目文档和社区反馈，这几个坑出现频率最高：

• 旧版本直接失效：v1.1.5 及以下版本因网站 API 变动已无法使用，务必使用 v1.1.6 及以上版本。
• 代理导致的连接失败：报ProxyError/MaxRetryError时，多半是系统代理或加速器拦截了请求，关闭代理、检查网络后重试。
• 老版本 Python 的兼容处理：Python 3.8 及以下环境，按 README.md 的说明操作：进入src目录删除原main.py，把main2.py改名为main.py再运行（当前快照中相关说明以官方文档为准）。
• lxml 编译报错：在手机上安装依赖时常见，用CFLAGS="-O0" pip install lxml重装即可。

进阶玩法：让它更合你的手

追更自动化。连载小说的追更只需要一条习惯：每次想更新时输入 1，程序会读取record.json中所有记录过的书籍 ID 并自动补抓新章节。把这条命令放进定时任务，你的书库就能做到"每日自动追更"。

批量收藏脚本。面对整批想收藏的书，可以写一个简单的循环逐本调用：

novel_ids=("7143038691944959011" "7123456789012345678") for id in "${novel_ids[@]}" do echo "开始下载：$id" python main.py <<< "$id" sleep 2 done

配套小工具接力。项目还衍生了几款实用工具：用于检测番茄小说网页结构变化的检测程序、在已下载小说中做全文搜索的搜索工具、按文件大小切分超长小说的分割工具。下载、搜索、分卷三步串联，就能搭起一套完整的个人小说管理流水线，相关说明集中在项目根目录的 README.md 中。

写在最后

说到底，这个工具的价值不在"抓取"本身，而在于把阅读的主动权交还给你：不受信号摆布、不惧内容下架、不被单一设备绑架。项目遵循 AGPL-3.0 协议开源，由 Yck、Yqy、Lingo 三位开发者共同维护，欢迎在 Issues 中反馈问题或提出建议，也可加入交流群 428582738 与其他使用者一起讨论。

动手之前记得守住边界：仅用于个人学习、研究与离线阅读，不要高频抓取、不要商用传播，尊重作者版权。现在就按上面的步骤跑通第一本书吧——几分钟之后，你的专属离线书库就正式开张了。

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