企业官网建设流程全解析

番茄小说离线下载指南：从零跑通 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供手机端用的精简版。

三分钟安装与依赖配置

这一节的目标：让程序在本地第一次成功跑起来。

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader

2. 建虚拟环境并安装依赖（清单在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

3. 首次运行，把目录页链接或小说 ID 粘贴进菜单：

cd src && python main.py

完成后文件默认落在src下的novel_downloads目录。⚠️ 注意版本：v1.1.5 及更早的版本接口已失效，请安装 v1.1.6 及以上再运行，否则会持续报错。

命令行、Web 与 Docker 三种模式怎么选

装好之后按场景挑一个入口即可：

• 命令行版内置更新、搜索、批量下载、设置、备份、退出六项菜单；设置改乱了，删掉data目录里的config.json，重启即恢复默认。
• Web 版默认监听 12930 端口，浏览器访问即可用：进度实时推送、多本书排队下载、书库中直接在线阅读。
• Docker 部署把数据拆成两个卷：fanqie_data存配置与书库索引，fanqie_downloads存小说文件，重建容器不丢数据。

五种保存格式对比：TXT、EPUB 转换与 HTML

下载前先定输出格式，免得下完再转。命令行菜单 4 或 Web 设置页均可切换：

• 电纸书通勤阅读选 EPUB；只在电脑上看，整本 TXT 最省事。
• 需要按章检索或二次编辑，分章 TXT 或 HTML 更方便。

进阶用法：增量更新与 Termux 手机方案

追连载和无电脑场景，这一节覆盖。

增量更新机制

每次下载的小说 ID 会记入data目录的record.json。之后选菜单"1"或 Web 版的"更新所有"，程序只抓取新增章节，十几秒即可完成，不整本重下。建议每周跑一次，书架常新。

Termux 手机方案

没有 PC 时，装好 Termux 后运行精简版ref_main.py：

pip 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