番茄小说离线下载指南从零跑通 fanqienovel-downloader 完整教程【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader追更的长篇突然从书架下架地铁深处又刷不出两行正文fanqienovel-downloader 是一款 Python 写的番茄小说下载器抓取用 requests、服务用 Flask把整部书转成本地 TXT、EPUB 等文件一次导入长期离线阅读。它是什么工作原理与源码结构先弄清工具在做什么后面的配置才有依据。你提供小说 ID 或目录页链接程序先解析出章节清单再并发请求每章正文用charset.json映射表还原乱码文本最后按选定格式落盘。它替你省掉三件事批量抓取几百章的书一次跑完不用逐章点开格式整理自动合并成整本文件、按章拆分或直接输出标准 EPUB增量更新已下载的内容有记录二次运行只拉新章节源码集中在src/目录共三个入口main.py命令行版、server.pyWeb 服务版、ref_main.py供手机端用的精简版。三分钟安装与依赖配置这一节的目标让程序在本地第一次成功跑起来。克隆仓库git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader建虚拟环境并安装依赖清单在src/requirements.txt含 requests、lxml、ebooklib、Flask 等cd fanqienovel-downloader python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate pip install -r src/requirements.txt首次运行把目录页链接或小说 ID 粘贴进菜单cd src python main.py完成后文件默认落在src下的novel_downloads目录。⚠️ 注意版本v1.1.5 及更早的版本接口已失效请安装 v1.1.6 及以上再运行否则会持续报错。命令行、Web 与 Docker 三种模式怎么选装好之后按场景挑一个入口即可模式适用场景启动命令入口文件命令行一次性任务、脚本化调用cd src python main.pymain.pyWeb批量管理、边下边读cd src python server.pyserver.pyDocker 部署服务器或 NAS 长期运行docker compose up -dDockerfile命令行版内置更新、搜索、批量下载、设置、备份、退出六项菜单设置改乱了删掉data目录里的config.json重启即恢复默认。Web 版默认监听 12930 端口浏览器访问即可用进度实时推送、多本书排队下载、书库中直接在线阅读。Docker 部署把数据拆成两个卷fanqie_data存配置与书库索引fanqie_downloads存小说文件重建容器不丢数据。五种保存格式对比TXT、EPUB 转换与 HTML下载前先定输出格式免得下完再转。命令行菜单 4 或 Web 设置页均可切换格式适合谁特点整本 TXT想一次导入读完的人全章合并为单文件兼容性最好分章 TXT精读、做笔记的人一章一文件便于单独管理EPUB电纸书用户EPUB 转换后为通用电子书Kindle、iBooks 直接打开HTML想在浏览器看的人保留网页样式附章节跳转LaTeX学术排版需求面向高质量文档输出场景电纸书通勤阅读选 EPUB只在电脑上看整本 TXT 最省事。需要按章检索或二次编辑分章 TXT 或 HTML 更方便。进阶用法增量更新与 Termux 手机方案追连载和无电脑场景这一节覆盖。增量更新机制每次下载的小说 ID 会记入data目录的record.json。之后选菜单1或 Web 版的更新所有程序只抓取新增章节十几秒即可完成不整本重下。建议每周跑一次书架常新。Termux 手机方案没有 PC 时装好 Termux 后运行精简版ref_main.pypip install requests ebooklib tqdm beautifulsoup4 python ref_main.py若 lxml 编译报错先补依赖再带编译参数重装apt install clang libxml2 libxslt CFLAGS-O0 pip install lxml这套方案无图形界面适合应急日常主力仍是 Web 版。实战常见问题报错、限流、代理与漏章运行一直报接口错误先核对版本平台接口调整后旧版本全部失效把代码更新到 v1.1.6 以上再试。下载频繁失败或被限制默认请求间隔是 50~150 毫秒的随机值太密就调大间隔同时把下载线程数1~16往下调。提示 ProxyError 或连不上多半是本地代理没关干净关掉系统代理或加速工具后重试即可。个别章节漏下载失败章节会自动重试至多 3 次完成后仍有缺漏重跑一次增量更新即可补齐。使用前的三条提醒工具定位是 Python 爬虫技术的练习项目请仅用于个人学习勿商用或高频抓取。下载文件建议按作者或分类归档重要作品多留一份备份。平台页面结构会调整遇到失效先查版本后续更新会跟进适配。流程走完通勤路上与信号死角里就多了一个完全属于自己的离线书库。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考