3种方式快速上手番茄小说下载器从零基础到参数调优的完整教程【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader想让一本几十万字的番茄小说变成可以离线反复读的 TXT 或 EPUB过去只能一章一章复制粘贴格式还常常乱掉。而fanqienovel-downloader番茄小说下载器把这个过程压缩成了几步操作输入书籍 ID 或关键词搜索它会自动抓取全书章节、清洗文本再按你选的格式落盘。对想要离线阅读和电子书转换的人来说这就是目前比较省事的 Python 工具方案。它能帮你做什么5种保存格式一次看懂先说结论这个小说下载器解决的不是能不能下的问题而是下完怎么用。下载引擎会自动轮换请求特征、按设定延迟限速、失败章节自动重试你基本不用盯着它。真正需要你决策的只有保存格式保存格式产物长什么样适合谁整本 TXT一个文件装下全书手机备忘录类阅读器、快速通读分章 TXT每章一个文件的目录树想单独管理章节的人EPUB标准电子书带目录和封面Kindle 等电纸书读者HTML带样式的网页文件浏览器里看、方便二次编辑LaTeX文档源码需要专业排版的场景选 EPUB 时它还会顺手把书名、作者、封面和章节导航写进电子书文件拿到阅读器里就能直接翻目录不用再手动整理。快速上手按你的水平选一条路新手区Docker 一键部署10分钟跑通 Web 版最省事的路子是用 Docker。你只需要会复制粘贴命令git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader docker compose up -d启动后打开浏览器访问http://localhost:12930就能看到 Web 界面。它给你的是完整的图形化工作台搜索框找书、ID 直接下载、把多本书丢进队列批量跑、实时看进度条甚至能在线试读已下载的章节。两个持久化卷帮你兜底数据——fanqie_data存配置和下载记录fanqie_downloads存成品文件。也就是说容器删了重建书库也还在。想把文件存到指定目录改一下docker-compose.yml里的 volumes 部分即可。进阶区源码部署 参数调优想改代码或者调试问题就从源码跑。流程是标准 Python 三步克隆仓库后创建虚拟环境python -m venv venv装依赖pip install -r requirements.txt启动 Web 服务cd src python server.py跑起来之后真正的功夫在config.json里。核心参数就这几个{ kg: 2, kgf: , delay: [50, 150], save_path: ./downloads, save_mode: 3, xc: 16, space_mode: halfwidth }save_mode1 整本 TXT、2 分章 TXT、3 EPUB、4 HTML、5 LaTeX和上面表格一一对应xc并发线程数默认 16。网络一般就调小机器好可以再拉高delay每次请求之间的随机延迟区间毫秒怕被限速就调大kg/kgf段首缩进的空格数量和填充字符追求排版舒服就保留全角空格缩进space_mode半角或全角空格处理习惯调参思路一句话网络稳就delay调小、xc调大换速度网络飘或频繁失败就反过来。改完不生效直接删掉config.json让它重新生成默认值。手机区Termux 跑命令行版想在 Android 上直接用Termux 里装好 Python 后安装 requests、ebooklib、tqdm、beautifulsoup4 等依赖然后运行src/ref_main.py这个命令行精简版。注意手机端用不到 GUI需要把里面的 tkinter 导入删掉。避坑清单症状对上了照做就行症状解法报 ProxyError、Unable to connect to proxy你系统里挂了代理但代理没开清掉代理环境变量再跑Termux 装 lxml 编译报错用CFLAGS-O0 pip install lxml低优化模式安装手机端 ref_main.py 启动报错删掉文件顶部的 tkinter 导入行设置改乱了想恢复默认删除config.json程序会重新生成以前能用现在搜不到书 / 请求失败网页结构或接口变了更新到仓库最新代码下完的文件段落间距怪异调kg、kgf两个缩进参数别只怪格式本身Web 版和命令行版怎么选维度Web 版server.py命令行版ref_main.py 等操作方式浏览器点选有进度条和队列终端里输 ID、敲命令功能覆盖搜索、批量队列、在线试读、备份下载下载、搜索、更新、简单设置部署门槛高适合 Docker 或长期挂着的机器低Termux 手机也能跑推荐人群要下多本书、想远程挂机就下一两本、环境受限判断标准很直接书多、想挂机 → Web 版书少、环境是手机 → 命令行版。写在最后一句话总结fanqienovel-downloader 把搜书—下载—转格式整条链路自动化了Web 版和 Docker 部署让完全不懂爬虫的人也能在 10 分钟内拿到自己的离线书库。接下来建议你做三件事先用 Docker 把 Web 版跑通、下一本短书验证 5 种格式的观感然后按自己网络情况把delay和xc调到合适位置最后把fanqie_data卷所在目录纳入定期备份书库和配置都不怕丢。提醒一句下载的内容仅供个人离线阅读请尊重原作者的版权也控制请求频率别把工具用成骚扰机器的东西。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
