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.txtWindows 下激活命令换成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 设置页里切换保存方式适合谁输出特点整本 TXT想一口气读完的人全部章节合并为一个文件导入阅读器方便分章 TXT精读、做笔记的人每章独立文件便于按章管理EPUB用电子阅读器的人标准电子书格式Kindle、iBooks 直接打开HTML习惯浏览器看的人保留网页排版带章节跳转LaTeX有学术排版需求的人适合高质量文档输出日常阅读选 EPUB 最均衡图省事就整本 TXT。在手机上用 Termux 应急下载身边没有电脑时给手机装个 Termux跑精简版src/ref_main.py记得先删掉文件里的 tkinter 导入pip install requests ebooklib tqdm beautifulsoup4 python ref_main.pylxml 安装报错的话改用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
