番茄小说离线下载完整教程3 条命令把整本书存进本地【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader正在追更的小说突然下架或者地铁里信号差到刷不出两行字别去翻聊天记录求资源。用开源的 fanqienovel-downloader一个用 Python 写的番茄小说下载工具就能把整本小说存到本地支持 TXT、EPUB 等 5 种格式命令行、网页界面、Docker 都能跑。这篇教程带你从装环境一直跑到长期部署。它到底帮你干什么核心逻辑就一句话你给小说 ID 或目录页链接它把每章正文抓下来按你选的格式存进电脑。整本批量抓取几百章一次处理不用一章章点开增量更新已下载的章节 ID 记在src/data/record.json下次只补新章节格式转换整本 TXT、分章 TXT、EPUB、HTML、LaTeX 任选适合谁想把小说存下来离线读、给追更书做备份的人。不适合谁想要双击即用、完全零配置的人——你至少需要 Python 环境或 Docker二选一即可。最快跑通路径一条最短路径拉代码 → 建虚拟环境装依赖 → 启动。依赖清单在src/requirements.txt主要是requests、lxml、ebooklib、Flask这些。把项目拉到本地并一次性装好依赖git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate pip install -r src/requirements.txt然后启动命令行主程序cd src python main.py第一次运行会先看到它自动获取 Cookie 的日志随后出现一个数字菜单。下载第一本书直接在菜单里粘贴目录页链接回车比如https://fanqienovel.com/page/7143038691944959011也可以只输小说 ID。程序先拉章节列表再用多线程逐章抓正文终端里有进度百分比完事文件落在src/novel_downloads/。两个关键提醒版本v1.1.5 及以下因平台接口变更已经失效请用 v1.1.6 及以上否则一直报错Python 版本如果你的 Python 是 3.8 及以下按 README 说明删掉src/main.py再把main2.py改名为main.py菜单里 1 到 6 分别对应1 增量更新、2 按关键词搜索小说、3 批量下载、4 设置段首占位符、下载延迟、存储位置、保存格式、线程数、5 备份已下载内容和配置、6 退出。日常最常碰的就是 1 和 4。按场景挑用法用鼠标管下载Web 版命令行适合一次性的任务。想边下边看、批量排队切到 Web 版同样在src目录下启动python server.py浏览器打开http://localhost:12930就是完整界面。搜索、直链下载、书库、在线阅读器、参数设置分别对应src/templates/components/下的search.html、library.html、reader.html、settings.html。它的几个好用点实时进度每章进度推送到页面能看到已下载 128/356 章这种直观数字下载队列一次塞进多本书后台按顺序自动处理在线阅读下完的书在书库里点阅读直接看不导文件一键更新书库里的书点一次更新自动补新章节界面走的是 Bootstrap 风格简洁手机上用浏览器打开也能操作。连载自动追更追连载最省事的就是增量更新。每次下载后小说 ID 都会记进src/data/record.json。想补章节时命令行输 1或者在 Web 版书库点更新它只抓新增部分十几秒结束不会整本重下。建议养成习惯每周固定跑一次追更的书永远停在最新章。把下载器挂在服务器上 24 小时跑想让任务放在云服务器或 NAS 上长期运行用 Docker 最省心。项目根目录已经备好Dockerfile和docker-compose.yml一条命令docker compose up -d镜像构建完访问http://服务器IP:12930。数据分成两块持久化fanqie_data卷存配置和书库容器内src/datafanqie_downloads卷存下载好的文件容器内src/novel_downloads。想改存放位置编辑docker-compose.yml里的 volumes 部分即可。Docker 版还有个隐藏福利Web 界面点下载文件直接存到远端机器上浏览器里取走就行家里有 NAS 的特别合适。没有电脑时Termux 应急下载手机上装 Termux 终端跑精简版src/ref_main.py也能下载。核心两条pip install requests ebooklib tqdm beautifulsoup4 python ref_main.py注意两点README 提到需要在ref_main.py里删掉 tkinter 的导入如果装lxml报错换CFLAGS-O0 pip install lxml重试。这套方案只有命令行没有界面适合应急日常主力还是推荐 Web 版。保存格式怎么选在菜单 4 或 Web 设置页切换5 种格式的区别如下格式长什么样选它的人EPUB标准电子书带章节目录用 Kindle、iBooks 等阅读器的人整本 TXT所有章节合成一个文件想省事、随手丢进任何阅读器的人分章 TXT每章一个独立文件精读、按章做笔记的人HTML保留网页排版可带章节跳转想在浏览器里直接翻的人LaTeX源码形式输出需自行编译排版有学术排版需求的人一句话推荐用阅读器就选 EPUB图省事选整本 TXT。高频问题速查现象报错出现ProxyError、连不上fanqienovel.com。原因本地代理或加速器没关干净程序走了失效的代理。解法关掉系统代理、加速工具后重试。现象频繁报错感觉被限制。原因请求太密集。章节延迟默认 50~150 毫秒随机线程默认 16。解法菜单 4或 Web 设置页把延迟区间调大线程数往下调比如降到 4~8 再观察。现象设置改乱了想恢复默认。原因所有设置都存在data/config.json改过的值会覆盖旧值。解法直接删除data/config.json下次运行自动回到默认不用重装。现象个别章节漏了。原因网络抖动导致单章失败。解法程序失败章节会自动重试仍有遗漏就再跑一次增量更新它只补缺的部分。结尾地铁深处信号死角你点开那个文件章节从上一章接着往下走。离线书库这个东西值得自己搭一次。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 番茄小说离线下载完整教程3 条命令把整本书存进本地【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader正在追更的小说突然下架或者地铁里信号差到刷不出两行字别去翻聊天记录求资源。用开源的 fanqienovel-downloader一个用 Python 写的番茄小说下载工具就能把整本小说存到本地支持 TXT、EPUB 等 5 种格式命令行、网页界面、Docker 都能跑。这篇教程带你从装环境一直跑到长期部署。它到底帮你干什么核心逻辑就一句话你给小说 ID 或目录页链接它把每章正文抓下来按你选的格式存进电脑。整本批量抓取几百章一次处理不用一章章点开增量更新已下载的章节 ID 记在src/data/record.json下次只补新章节格式转换整本 TXT、分章 TXT、EPUB、HTML、LaTeX 任选适合谁想把小说存下来离线读、给追更书做备份的人。不适合谁想要双击即用、完全零配置的人——你至少需要 Python 环境或 Docker二选一即可。最快跑通路径一条最短路径拉代码 → 建虚拟环境装依赖 → 启动。依赖清单在src/requirements.txt主要是requests、lxml、ebooklib、Flask这些。把项目拉到本地并一次性装好依赖git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader python -m venv venv source venv/bin/activate # Windows 用 venv\Scripts\activate pip install -r src/requirements.txt然后启动命令行主程序cd src python main.py第一次运行会先看到它自动获取 Cookie 的日志随后出现一个数字菜单。下载第一本书直接在菜单里粘贴目录页链接回车比如https://fanqienovel.com/page/7143038691944959011也可以只输小说 ID。程序先拉章节列表再用多线程逐章抓正文终端里有进度百分比完事文件落在src/novel_downloads/。两个关键提醒版本v1.1.5 及以下因平台接口变更已经失效请用 v1.1.6 及以上否则一直报错Python 版本如果你的 Python 是 3.8 及以下按 README 说明删掉src/main.py再把main2.py改名为main.py菜单里 1 到 6 分别对应1 增量更新、2 按关键词搜索小说、3 批量下载、4 设置段首占位符、下载延迟、存储位置、保存格式、线程数、5 备份已下载内容和配置、6 退出。日常最常碰的就是 1 和 4。按场景挑用法用鼠标管下载Web 版命令行适合一次性的任务。想边下边看、批量排队切到 Web 版同样在src目录下启动python server.py浏览器打开http://localhost:12930就是完整界面。搜索、直链下载、书库、在线阅读器、参数设置分别对应src/templates/components/下的search.html、library.html、reader.html、settings.html。它的几个好用点实时进度每章进度推送到页面能看到已下载 128/356 章这种直观数字下载队列一次塞进多本书后台按顺序自动处理在线阅读下完的书在书库里点阅读直接看不导文件一键更新书库里的书点一次更新自动补新章节界面走的是 Bootstrap 风格简洁手机上用浏览器打开也能操作。连载自动追更追连载最省事的就是增量更新。每次下载后小说 ID 都会记进src/data/record.json。想补章节时命令行输 1或者在 Web 版书库点更新它只抓新增部分十几秒结束不会整本重下。建议养成习惯每周固定跑一次追更的书永远停在最新章。把下载器挂在服务器上 24 小时跑想让任务放在云服务器或 NAS 上长期运行用 Docker 最省心。项目根目录已经备好Dockerfile和docker-compose.yml一条命令docker compose up -d镜像构建完访问http://服务器IP:12930。数据分成两块持久化fanqie_data卷存配置和书库容器内src/datafanqie_downloads卷存下载好的文件容器内src/novel_downloads。想改存放位置编辑docker-compose.yml里的 volumes 部分即可。Docker 版还有个隐藏福利Web 界面点下载文件直接存到远端机器上浏览器里取走就行家里有 NAS 的特别合适。没有电脑时Termux 应急下载手机上装 Termux 终端跑精简版src/ref_main.py也能下载。核心两条pip install requests ebooklib tqdm beautifulsoup4 python ref_main.py注意两点README 提到需要在ref_main.py里删掉 tkinter 的导入如果装lxml报错换CFLAGS-O0 pip install lxml重试。这套方案只有命令行没有界面适合应急日常主力还是推荐 Web 版。保存格式怎么选在菜单 4 或 Web 设置页切换5 种格式的区别如下格式长什么样选它的人EPUB标准电子书带章节目录用 Kindle、iBooks 等阅读器的人整本 TXT所有章节合成一个文件想省事、随手丢进任何阅读器的人分章 TXT每章一个独立文件精读、按章做笔记的人HTML保留网页排版可带章节跳转想在浏览器里直接翻的人LaTeX源码形式输出需自行编译排版有学术排版需求的人一句话推荐用阅读器就选 EPUB图省事选整本 TXT。高频问题速查现象报错出现ProxyError、连不上fanqienovel.com。原因本地代理或加速器没关干净程序走了失效的代理。解法关掉系统代理、加速工具后重试。现象频繁报错感觉被限制。原因请求太密集。章节延迟默认 50~150 毫秒随机线程默认 16。解法菜单 4或 Web 设置页把延迟区间调大线程数往下调比如降到 4~8 再观察。现象设置改乱了想恢复默认。原因所有设置都存在data/config.json改过的值会覆盖旧值。解法直接删除data/config.json下次运行自动回到默认不用重装。现象个别章节漏了。原因网络抖动导致单章失败。解法程序失败章节会自动重试仍有遗漏就再跑一次增量更新它只补缺的部分。结尾地铁深处信号死角你点开那个文件章节从上一章接着往下走。离线书库这个东西值得自己搭一次。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
)
