fanqienovel-downloader 使用指南：3 分钟如何把番茄小说整本变离线文件

fanqienovel-downloader 使用指南3 分钟如何把番茄小说整本变离线文件【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader一趟夜车手机流量用光你追更的小说刷不出一个字或者平台调整目录你收藏的书说没就没。这种时刻你最需要的是一个能把整本番茄小说离线保存下来的工具——fanqienovel-downloader 就是专为番茄小说写的 Python 下载器逐章抓取正文转成 TXT、EPUB、HTML 等格式存进你的设备。30 秒认识 fanqienovel-downloader一句话定位给它小说 ID 或目录页链接它把整本书搬到你自己的硬盘上。三个核心卖点批量抓取一本书一次搞定TXT、EPUB 等 5 种输出格式记住下载记录更新只补新章节代码全部在src/目录记住 4 个文件就够了src/main.py命令行主程序src/server.pyWeb 版服务端口 12930src/ref_main.py给手机 Termux 用的精简版src/charset.json正文乱码问题的解码表它把每本书的 ID 记在data/record.json里这是后面只补不重下的基础。最短路径跑起来3 分钟完成首次下载全程一条流水线拉代码 → 装依赖 → 首次运行没有任何图形界面操作。git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader这一条把项目克隆到本地。cd fanqienovel-downloader python -m venv venv source venv/bin/activate pip install -r src/requirements.txt虚拟环境 依赖一次装齐requests、lxml、ebooklib、Flask 等都在src/requirements.txt里。cd src python main.py首次运行会自动获取 Cookie然后弹出数字菜单——直接粘贴小说链接或输入 ID回车即下文件默认落在src/novel_downloads/。⚠️ 版本坑v1.1.5 及以下因平台 API 变更已经失效请直接用 v1.1.6 及以上版本。⚠️ Python 3.8 及以下克隆后需删掉src/里的main.py把main2.py改名为main.py再运行。按场景选对用法一次性快速下载命令行直给只下几本时main.py里输入 ID 或目录页链接直接开下。菜单其余选项一句话记清1 更新旧书、2 按书名搜索、3 从urls.txt批量下载一行一个链接、4 设置、5 备份、6 退出。适合临时想抓一本来读的人。批量队列管理Web 版python server.py浏览器打开http://localhost:12930。多本书扔进队列按顺序处理每章进度通过 WebSocket 实时推到页面书库里一键更新所有补新章节。适合一次管理整套书、边下边看进度的场景。下完直接读内置在线阅读器书库里点阅读浏览器直接开读不用导出文件界面是 Bootstrap 风格手机浏览器打开也能正常操作。适合懒得往阅读器里导文件的人。服务器长期驻留Dockerdocker compose up -d构建完成后访问http://服务器IP:12930。fanqie_data配置、书库索引对应容器内src/data和fanqie_downloads小说文件对应src/novel_downloads两个卷分别持久化改存放位置只需编辑docker-compose.yml的 volumes 段。适合有云服务器或 NAS、想 24 小时跑任务的用户。手机应急下载Termuxpip install requests ebooklib tqdm beautifulsoup4 python ref_main.pylxml 安装报错时换CFLAGS-O0 pip install lxml重试。只有命令行没有图形界面适合手上暂时没有电脑、想应急存书的人。保存格式与参数调优5 种保存方式在命令行菜单 4 或 Web 设置页切换选项适合谁一句话特点整本 TXT想一次读完的人所有章节合并成单文件什么阅读器都能导分章 TXT做笔记、精读的人一章一个文件定位管理最方便EPUB用电子书阅读器的人标准格式Kindle、iBooks 直接打开HTML习惯浏览器看的人保留网页样式带章节跳转LaTeX有排版需求的人面向高质量文档输出场景参数建议三条请求间隔默认 50~150 毫秒随机延迟报错频繁就先把它调大。下载线程数默认 16Web 设置里可在 1-16 之间下调。设置改乱了删掉data/config.json即恢复默认值不用重装。卡住了4 个常见报错的修复方法 每条按现象 → 原因 → 一招解决来ProxyError / 无法连接→ 本地代理没关干净 → 关掉系统代理或加速工具再重试。频繁报错、疑似被限制→ 请求太密集 → 调大章节下载间隔、调低线程数。个别章节缺失→ 网络瞬时抖动 → 内置自动重试重跑一次更新即可补齐。运行即报错无响应→ 版本过旧 → 升级到 v1.1.6 及以上。最后开始前的 3 句提醒回到开头那趟夜车——只要整本书躺在本地文件里信号好坏就不再是问题。动手前记住三件事✅ 仅限个人学习研究 Python 爬虫技术勿商用勿高频抓取影响平台正常运行。下载的书按作者或分类整理重要作品多留一份备份。平台页面结构会调整遇到失效先检查程序版本是否为最新。配置好 fanqienovel-downloader你的离线书库就真正归自己管了——信号死角里打开文件继续读。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考