番茄小说下载器完整上手指南3分钟跑通批量下载与Web管理【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader番茄小说下载器是一款用 Python 编写的开源工具核心功能是把番茄小说平台的整本书保存到本地支持 TXT、EPUB、HTML、LaTeX 等多种格式并自带一个浏览器操作界面让你在手机、电脑或服务器上都能批量下载和管理小说。这篇文章会带你从零跑通再逐步深入配置与排错。深夜追更的痛一台小工具就能解决想象一下这个场景你追的一本连载明天就要上架收费今晚必须把前 200 章存下来或者你要坐 6 小时高铁手机里却没缓存几章正文再或者你辛苦整理的书单因为平台改版一夜之间全成了加载失败。这些问题的共同根源是内容不在你手里阅读体验被平台规则牵着走。番茄小说下载器就是为此而生的——它把在线阅读变成本地资产下载一次永久可用。它不只是一个爬虫脚本还附带完整的网页管理端把搜索、排队下载、进度查看、在线阅读串成一条顺畅的流水线。一条命令启动 Web 版浏览器里直接干活最快的路径是 Docker 部署全程三步适合没有 Python 经验的朋友。先克隆仓库git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader接着启动容器docker compose up -d最后打开浏览器访问http://localhost:12930界面就出现了。容器会自动处理所有依赖包括 gevent、lxml、ebooklib 这些容易出问题的库你不用装任何 Python 环境。想用本机 Python 跑也简单装好依赖后进入src目录执行python server.py同样在http://localhost:12930打开网页。两种方式的差异在于环境隔离Docker 更适合放在 NAS 或云服务器上长期挂机源码运行则方便你随手改代码。五个核心能力每个都对应一个真实痛点1. 五种保存格式一次满足不同设备整本 TXT 适合电脑和墨水屏阅读器分章 TXT 方便你单独分享某一章EPUB 能给电子书添加封面和目录HTML 版自带目录跳转和上一章/下一章导航LaTeX 则适合打印或做学术排版。它解决什么问题同一本书按场景导出不同形态。2. Web 界面让下载变成点鼠标网页版把命令行选项全部图形化输入小说 ID 或完整链接直接下载输入书名关键词搜索结果卡片上直接点下载入队。它解决什么问题不熟悉终端的人也能 1 分钟内上手。3. 下载队列与实时进度把好几本书依次加进队列后台线程逐个处理页面上的进度条通过 SocketIO 实时刷新你能看到当前正在下载第几章、完成百分比。它解决什么问题批量任务不用人盯挂机等通知即可。4. 增量更新追更不再重复劳动书库页面提供更新所有小说按钮程序读取record.json里记录的小说 ID只补下载新增章节老章节直接复用本地缓存。它解决什么问题连载每天更两章你只需要每天点一次更新。5. 内置在线阅读器下载完的书不急着导出直接在网页里打开阅读章节内容从本地 JSON 读取响应很快翻页不卡。它解决什么问题把下载和阅读合并成同一套流程。实战从搜书到导出 EPUB 的完整流程下面走一遍最常见的任务搜索一本书下载导出成 EPUB 放进手机阅读器。第一步进入搜索页在搜索框输入书名关键词点击搜索。结果卡片会显示书名、作者、字数确认无误后点击卡片上的下载按钮这本小说就被加入下载队列。第二步点右上角的下载队列按钮可以看到排队情况和当前正在下载的书籍。此时页面底部的进度条会实时增长旁边的日志区会滚动输出每一章的下载状态。一本几百章的小说在多线程并发下通常几分钟内完成。第三步切到书库页找到刚下载的书点击阅读按钮就能在浏览器里直接看正文。想导出到本地进入设置页把保存模式改成 EPUB重新触发一次下载之后在novel_downloads目录Docker 部署时在fanqie_downloads卷里就能拿到.epub文件拷进手机即可。这一套流程的关键点在于搜索、下载、阅读、导出都在同一个页面里完成不需要切换任何工具。进阶定制四个配置项改出你的专属体验网页版的配置保存在src/data/web_config.json命令行版对应src/data/config.json。核心参数如下save_mode保存模式1 整本 TXT、2 分章 TXT、3 EPUB、4 HTML、5 LaTeX。改这里决定导出文件的形态比如给墨水屏用户选 1给手机阅读器用户选 3。xc并发线程数默认 16。网络好可以调到 24 提速网络差或频繁失败就降到 8。这个参数直接影响请求频率改的时候要考虑对方服务器的承受能力。delay请求间隔一个两元素数组如[50, 150]单位毫秒。每个章节下载后随机等待这段时间用于模拟真人访问节奏。频繁被限流时把它调大到[300, 500]往往立竿见影。kg / kgf段首格式kg是段首空格的个数kgf是空格字符类型默认全角空格。想要传统中文排版的每段缩进两格把kg设为 2 即可。需要提醒的是网页设置页每次保存都会用当前表单覆盖整个配置文件修改前先想清楚所有选项误改后删掉配置文件重启即可恢复默认。踩坑指南老手替你趟过的五个坑问题一报错ProxyError: Unable to connect to proxy。原因本机开了代理或加速器requests 走了不存在的代理通道。 解法关闭系统代理和各类加速软件或在代码中移除代理环境变量后重启服务。这是新手遇到频率最高的问题先查它。问题二下载返回空内容或者章节标题拿到了正文却为空。原因网站结构更新或 cookie 失效。 解法确认使用的是最新版本旧版v1.1.5 及以下的 API 已失效新版会自动获取和测试 cookie并内置章节完整性校验发现问题章节会自动重试修复。问题三用 Python 3.8 及以下版本启动报错。原因部分语法需要高版本 Python。 解法进入src目录把原main.py改名备份再把main2.py重命名为main.py后启动。问题四网页下载进度卡住不动。原因批量任务里某个章节请求超时。 解法先观察日志区是否在重试再检查网络同时把xc调小、delay调大让请求节奏慢下来。问题五设置页改完参数后行为异常。原因设置保存是整份覆盖。 解法记住每个选项的当前值再改动想彻底回到出厂状态删除config.json或web_config.json后重启。最佳实践让下载器稳定跑一年的五条建议别把xc拉满。16 线程已经很快盲目调到 64 只会让请求被限流得不偿失。稳定比速度重要。给 Docker 配上持久化卷。项目默认用fanqie_data和fanqie_downloads两个命名卷保存配置和下载文件容器删了数据还在。换机器前记得把这两个卷一起迁移。养成每天一更的习惯。连载书每天用更新所有小说跑一次增量更新几百章的书只需几十秒数据始终是最新的。按用途选格式而不是全都要。手机阅读选 EPUB备份存档选整本 TXT需要分享单章选分章 TXT。全格式都导一遍只是浪费磁盘。下载高峰期错开时段。晚上八点到十一点是网站访问高峰把批量任务放在凌晨跑成功率明显更高。扩展与生态从使用者到二次开发者如果你懂一点 Python这个项目的扩展点其实很清晰。核心逻辑集中在src/main.pySaveMode枚举定义了五种输出格式NovelDownloader类负责章节抓取与文件生成Config数据类承载全部可调参数。想新增一种保存格式照着_download_epub或_download_latex的写法补一个方法即可框架会自动接入。Web 端则暴露了一组干净的 HTTP 接口方便你接入自己的脚本或自动化流程/api/search做关键词搜索/api/download/id触发下载/api/novels列出书库/api/read/id/章节名读取章节正文。写个定时任务每天自动调用更新接口就能把追更完全自动化。项目作者还提供了几个配套小工具检测网页结构变化的检测器、按内容关键词搜索小说的搜索器、按文件大小分割小说的分割器都可以和本工具搭配使用。遇到问题或想法去项目 Issues 区讨论即可项目采用 AGPL-3.0 协议二次开发时请遵守同样的开源条款。现在就开始把第一本书存进本地番茄小说下载器的价值一句话概括把平台上的内容变成你自己的数字资产搜索、下载、阅读、导出全流程在一套界面里闭环。你不需要理解爬虫原理也不用配置复杂的运行环境——Docker 一条命令浏览器打开就能用。下一步很明确克隆仓库docker compose up -d打开http://localhost:12930搜索你正在追的那本书点一下下载。几分钟后一本完整的 EPUB 就会出现在你的下载目录里。如果觉得好用顺手给项目点个 Star让更多被下架焦虑困扰的读者找到它。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考