fanqienovel-downloader 完整上手指南：把整本番茄小说存到本地

fanqienovel-downloader 完整上手指南：把整本番茄小说存到本地

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

追更到一半的小说突然下架，或者地铁里信号差得刷不出两行字？用 fanqienovel-downloader 就能把整本番茄小说下载到本地。这个 Python 工具支持命令行、Web 界面、Docker 三种运行方式，能把章节正文转成 TXT、EPUB、HTML 等离线格式，一次抓取，反复回看。

确认它能替你做的三件事

你给它一个小说 ID 或目录页链接，它逐章抓取正文，按你选的格式存进电脑。相比手动复制粘贴，它替你省掉三件麻烦事：

• 批量抓取：几百章用多线程一次处理，终端和网页端都有实时进度条
• 格式整理：整本 TXT、分章 TXT、EPUB、HTML、LaTeX 共 5 种输出任选
• 增量更新：下载过的小说 ID 会写进记录文件，再运行只抓新增章节，不整本重下

拉取代码并把依赖装齐

先把仓库拉到本地：

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 pip install -r src/requirements.txt

Windows 下激活命令换成venv\Scripts\activate就行。

**注意：**v1.1.5 及以下的旧版本因平台接口变更已经失效，务必确认你装的是 v1.1.6 以上版本，否则会从头报错。

跑通第一次命令行下载

cd src python main.py

程序会先自动获取 Cookie，然后进入数字菜单。第一次下载直接把小说目录页链接粘贴进去回车；手头没有链接就用菜单 2 按书名搜索。下载完的文件默认落在src/novel_downloads/目录里。

菜单里其余选项值得记一下：

• 1：增量更新，只补新增章节
• 2：按书名或关键词搜索小说
• 3：批量下载多本小说
• 4：设置段首占位、请求延迟、保存位置与模式
• 5：打包备份已下载小说和配置
• 6：退出

**注意：**菜单 4 里每改一个选项都会覆盖原数据，动之前先看清楚。万一把设置改乱了，删掉src/data/config.json就能恢复默认值，不用重装。

启动 Web 界面管理下载队列

一次性任务用命令行就够，想批量管理就切到 Web 版。仍在src目录下：

python src/server.py

浏览器打开http://localhost:12930即可。它把命令行流程整体搬进了浏览器，几个体验点：

• 章节进度通过 WebSocket 实时推到页面，能看到"已下载 128/356 章"
• 队列设计：一次加几本书，后台按顺序处理，随时查状态
• 在线阅读器：下完的书点"阅读"直接看，不用导文件
• "更新所有"一键补全书库里每本连载的新章节

搜索、书库、阅读、设置四个模块的页面模板分别放在src/templates/components/下，想改界面可以从这里入手。

**提示：**Python 版本在 3.8 及以下时，需要删掉src里原有的 main.py，把 main2.py 改名成 main.py 才能正常运行。

用 Docker 挂到 NAS 或云服务器上跑

想让下载任务 24 小时在远端跑，直接：

docker compose up -d

项目根目录已备好 Dockerfile 和 docker-compose.yml，不用自己写配置。镜像构建完访问http://<服务器IP>:12930。数据分成两个卷持久化：fanqie_data存配置和书库索引，fanqie_downloads存小说文件；想换挂载路径，改 docker-compose.yml 里的 volumes 部分即可。Web 版下载完可以直接把文件存到本地，所以服务放在家里 NAS 上、人在外面点下载也是成立的用法。

对比 5 种保存格式再选一种

命令行菜单 4 或 Web 设置页里切换：

日常阅读选 EPUB 最均衡，图省事就整本 TXT。

在手机上用 Termux 应急下载

身边没有电脑时，给手机装个 Termux，跑精简版src/ref_main.py（记得先删掉文件里的 tkinter 导入）：

pip install requests ebooklib tqdm beautifulsoup4 python ref_main.py

lxml 安装报错的话，改用CFLAGS="-O0" pip install lxml重试。这套方案只有命令行、没有界面，适合应急，日常主力还是 Web 版。

按症状排查下载报错

• 症状：报ProxyError、连不上。原因：本地代理或加速工具没关干净。处理：关掉系统代理和加速器再重试。
• 症状：频繁报错、像被限制。原因：请求间隔太小、线程数太高。处理：在设置里把请求延迟调大（默认随机 50~150 毫秒），线程数调低（范围 1-16）。
• 症状：个别章节缺失。原因：网络瞬时失败。处理：程序内置最多重试 3 次，仍漏的章节重新跑一次更新即可补齐。
• 症状：首次运行就报错、Cookie 获取失败。原因：版本过旧或平台接口又变了。处理：升级到 v1.1.6 以上的最新版再试。

遵守使用边界并顺手备份

这个工具定位是学习和研究爬虫技术，仅用于个人学习，不要商用，也不要高频恶意抓取。下载的小说建议按作者或分类整理，重要作品用菜单 5 多打一份备份包。平台页面结构随时可能调整，遇到失效先查程序版本，维护者会在后续版本里修复适配。

下次通勤路上信号断掉，打开本地那份 EPUB 就能接着翻没读完的章节——书在本地，阅读不打烊。

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