想把番茄小说整本离线保存？这个免费开源工具几分钟就能帮你搞定
【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
周末晚上，你靠在沙发上想重温某本完结小说的高潮章节，结果呢——先被广告糊脸，再被"加载失败"劝退，最后在目录页里翻得头晕眼花。更扎心的是另一种情况：你收藏夹里那本追了好久的小说，某天突然就搜不到了。是不是很眼熟？说实话，这些糟心事几乎每个人都遇到过。其实有个免费开源的 Python 工具——fanqienovel-downloader（番茄小说下载器），专门解决这类麻烦：你把小说目录页的链接或数字 ID 丢给它，它就把整本书逐章抓下来，转成 TXT、EPUB、HTML 或 LaTeX 格式，安安稳稳躺在你电脑里，离线随便看。
三步尝到甜头：最快的一次下载体验
先别急着研究安装，记住这个工具的"日常三连"就够了：
- 打开番茄小说的目录页，把链接复制下来（或者只复制末尾那一串数字 ID，程序会自动解析）。
- 启动程序（命令行或网页版都行，下面会讲到）。
- 把链接粘进去，点一下下载，等进度条走完。
就这三步，一本书就到手了。下载好的文件会自动按你选的格式保存好，手机、Kindle、电脑都能看。至于环境怎么搭、命令怎么敲，那是"一次性工程"，搭好一次，以后每次都是这三步——咱们下一节再说。
这个工具到底替你干了哪些活
说白了，它解决的是四类具体的麻烦，不是一堆花里胡哨的功能堆砌：
麻烦一：书突然没了，想看的时候找不到。在线阅读平台的资源随时可能变动，与其赌运气，不如把喜欢的作品提前存一份在本地。这才是真正的"书在自己手里"。
麻烦二：想换设备看，格式对不上。手机上看整本 TXT 最省事；Kindle 这类阅读器要带目录跳转，得用 EPUB；想保留排版和插图选 HTML；做打印或学术用途，LaTeX 排版最漂亮。这个工具五种格式都给你备好了，选中即用。
麻烦三：追更太累，每章都要手动找。连载小说下载过一次后，隔几天跑一下"更新"功能，程序会读record.json里的记录，只把新章节增量补进来，不用整本重下。
麻烦四：怕下载太慢、怕失败、怕被盯上。它支持多线程下载（线程数 1 到 16 可调）、内置随机延迟、章节失败自动重试并记录，你只管在旁边等着。
看完这些，再上一张速览表，心里更有底：
| 能力 | 具体说明 |
|---|---|
| 五种保存格式 | 整本TXT、分章TXT、EPUB、HTML、LaTeX，总有一款合你心意 |
| 三种运行方式 | 网页版、命令行、Docker 容器，按习惯挑 |
| 智能抓取 | 自动识别章节结构、处理分页内容、多线程并发下载 |
| 断点续更 | 靠record.json记录进度，追更只需一键增量更新 |
| 批量入队 | 网页版可以把好几本书加进下载队列，排队依次处理 |
| 本地在线阅读 | 下载完直接在浏览器里翻，不用再开 App |
想深挖实现细节的读者注意了：下载引擎在
src/main.py，Web 服务在src/server.py，配置项统一存在src/data/config.json。顺着这三个文件看，思路就很清楚了。
从零到一的完整实战：照着走就行
先说前置条件：电脑上装好 Python 3.8 或更高版本，命令行输入python --version能确认。然后把源码拉下来：
git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt依赖装完，三条路随你选。
路线一：网页版，新手最省心。进入src目录，运行python server.py，然后浏览器打开http://localhost:12930。页面上有搜索框（按书名关键词找书）、直接下载框（粘链接或数字 ID）、下载队列、书库和在线阅读，全程鼠标操作，进度条一目了然。因为本质是个网页服务器，它也能放到远程服务器或容器里跑，你人在哪都能访问，下载完直接存文件。
路线二：命令行，效率党首选。进入src目录，运行python main.py，会进入交互菜单：
- 直接输入链接或 ID：立即下载
- 输入
1：读取record.json更新已下载的小说 - 输入
2：按关键词搜索 - 输入
3：批量下载多本书 - 输入
4：进设置，调整段首占位符、请求延迟、存储位置、保存模式 - 输入
5：备份已下载的小说及配置
路线三：Docker，一劳永逸。有容器经验的话，在项目根目录执行：
docker compose up -d启动后同样访问http://localhost:12930。小说数据和下载文件分别存在fanqie_data、fanqie_downloads两个卷里，想换目录就改docker-compose.yml的卷映射。
三条路跑通之后，核心流程都是一样的：拿链接 → 选格式 → 确认下载。剩下的章节识别、分页处理、正文格式化、多线程抓取，全交给程序。
让体验更进一步的小心思
小心思一：把"更新"当成你的追更按钮。连载中的书下载过一次，隔几天跑python main.py输入1，程序自动对比record.json，只补新章节。追更从此不用整本重下，省心到离谱。
小心思二：线程数和延迟，找到你的舒适区。设置里下载线程数（xc）在 1 到 16 之间。网速好、赶时间就调大；想低调一点、不给服务器添压力，就把章节间隔延迟调高。这个平衡点只有你自己最清楚。
小心思三：保存方式选"分章TXT"更灵活。整本 TXT 适合一口气读完，分章 TXT 则是每章一个文件，方便按章整理、分享或二次加工。后面想合并、想拆开都很顺手。
小心思四：改坏了配置？删掉就恢复。设置里每一项改动都会覆盖原数据，真调乱了也别慌——把src/data/config.json删掉，程序下次启动会自动生成一份默认配置，不用重装。
快问快答
Q：下载时报 ProxyError 代理错误怎么办？A：十有八九是系统里开着代理或加速工具，和程序的网络请求冲突了。把代理关掉再试一次，大多数情况立刻就好。
Q：有章节下载失败会怎样？A：程序内置重试机制，失败的章节会跳过并记录。看看日志里的原因，网络恢复后对这本书重新执行一次更新，就能补回来。
Q：下载的文件存在哪？A：源码运行的话，默认在src/novel_downloads目录；Docker 部署则在fanqie_downloads卷里。都可以在设置里改成你喜欢的路径。
Q：这个工具需要什么电脑水平？A：环境配置这一步（装 Python、装依赖）需要一点点耐心，但照着上面的命令复制粘贴就行。之后的操作，网页版全程鼠标，零门槛。
写在最后
回到开头那个场景：下次你深夜想重温某个情节，不用再跟广告和加载转圈较劲了——打开本地文件，几秒钟翻到那一页，那种踏实感，只有体验过才知道。把喜欢的书留在自己手里，从来都不是什么复杂的事，这个工具把抓取、清洗、格式化、封装这一整套技术活都藏在了背后，把时间留给你阅读本身。
最后照例提醒一句：任何下载工具都请只用于个人学习与收藏，尊重作者版权和平台规则。理性使用，让好工具带来便利，而不是困扰。
【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
