番茄小说下载器使用指南5分钟跑通你的第一本离线小说【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader番茄小说下载器fanqienovel-downloader是一款基于 Python 的开源工具核心用途只有一个把番茄小说平台的书籍完整下载到本地支持 TXT、EPUB、HTML、LaTeX 五种格式。如果你收藏过几百章的小说、却担心它哪天悄悄下架或者想换个阅读器却导不出文件这篇指南就是为你准备的。全文按照先想清楚→再动手→后优化的顺序展开读完大约需要 10 分钟。动手之前先回答三个问题很多新手拿到工具就急着敲命令结果下载完才发现格式不对、位置不对、更新不了。与其返工不如先花一分钟做三个决定。第一你要哪种文件格式整本 TXT 体积最小、任何设备都能打开分章 TXT 适合逐章校对和编辑EPUB 是 Kindle、多看等专业阅读器的通用格式HTML 方便在浏览器里翻阅和分享LaTeX 则适合做排版输出。普通读者首选整本 TXT 或 EPUB后面随时可以改。第二你打算把书存在哪本地目录、外接硬盘还是服务器这决定了你选 Web 版还是命令行版下文会说。第三你会不会追更如果会下载后记得保留记录文件这样下次一键就能更新全书而不是重新下载。5 分钟跑通第一次下载三条路径任选番茄小说下载器提供了三条启动路径按你的环境选一条最快的。路径一Docker 一键启动最省心git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader docker compose up -d这三条命令依次做的是拉取项目源码、进入项目目录、后台启动容器。启动后浏览器访问http://localhost:12930就能看到 Web 界面。小说文件和个人数据会存入 Docker 卷fanqie_downloads与fanqie_data重装系统也不丢。路径二Python 直接运行适合开发者pip install -r requirements.txt cd src python server.py同样访问http://localhost:12930。这种方式方便你随时改源码、看日志适合想深入了解实现细节的人。路径三直接运行 exe零配置Windows 用户可以直接使用打包好的可执行文件双击启动即可无需安装 Python 或 Docker。命令行版六步把下载玩明白Web 版适合鼠标点击命令行版则适合批量与自动化。启动后程序会显示一个数字菜单记住这六个入口你就能掌控全部流程输入链接或 ID——直接下载单本小说支持完整页面链接和纯数字 ID 两种形式输入 1——根据data/record.json里的记录更新所有已下载书籍追更专用输入 2——按书名或关键词搜索找到后直接下载输入 3——批量下载把多本小说的 ID 一次性交给程序排队处理输入 4——进入设置调整段首占位符、下载间隔、保存位置和格式输入 5——备份下载内容与配置防止误删。举个例子你只需在提示符后粘贴一本书的 ID回车剩下的章节抓取、去重、排序都由程序完成进度条会实时显示当前章节。这就是番茄小说下载器命令行版最典型的用法一个 ID一本完整的书。把下载升级成收藏的三个习惯下载完成只是开始真正值钱的是长期维护。下面三个习惯能让你的书库长期可用。习惯一追更靠更新而不是重下。每次更新前程序会读取record.json中记录的书籍 ID只拉取新增章节速度快且不浪费流量。你的任务只是定期运行一次更新。习惯二善用断点续传。网络中断时不必从头再来程序会记录已完成的章节下次继续。下载大长篇时这个功能能省下大量时间。习惯三定期备份。命令行菜单里的备份功能会把小说文件、格式设置和段首空格配置一并打包。建议每月备份一次存到另一块磁盘。配置参数怎么调才不踩坑配置文件位于data/config.json下面五个参数是高频调节项参数默认值作用建议xc16下载线程数家用宽带 3-5网络差时降到 1-2delay[50, 150]章节间隔延迟毫秒频繁失败就调大比如 [200, 400]save_mode1保存格式1 整本 TXT2 分章3 EPUB4 HTML5 LaTeX阅读器不支持再换不用频繁切换kgf全角空格正文段首占位符保持默认即可space_modehalfwidth空格宽度模式对排版有要求时再改其中最容易出问题的是xc和delay的组合线程数开满但延迟太低容易被平台限流。稳妥的做法是先按建议值跑一本观察日志里是否有大量重试再微调。高频故障自查清单遇到问题先别慌对照下面四项排查八成能自己解决。报错ProxyError: Unable to connect to proxy。这是最常见的网络错误通常是系统代理或加速工具未正确关闭。检查代理设置后重试即可。Web 界面打不开。优先检查 12930 端口是否被占用。Docker 用户可修改docker-compose.yml中的端口映射比如改成12931:12930再重启容器。提示 API 失效无法下载。番茄小说下载器曾因平台接口变动导致旧版本集体失效遇到这类提示先升级到最新版本v1.1.6 及以上不要纠结旧版本。章节内容乱码或格式错乱。先确认系统编码为 UTF-8再尝试切换保存格式最后检查网络环境是否稳定。src/charset.json是内置的字符映射表正常情况下无需手动修改。进阶玩法手机端与远程部署手机上用命令行版。安卓用户可在 Termux 中安装 Python 环境然后运行python ref_main.py。这条命令启动的是精简版命令行程序不依赖图形界面适合在手机终端里下载和更新。远程部署到服务器。Web 版下载完成后会直接生成文件供你下载因此很适合放在云服务器或容器中运行。你在任何设备上打开浏览器都能管理书库下载结果即点即取。批量管理书单。整理一个包含多个小说 ID 的文本文件配合批量下载入口一次跑完整个书单适合开学季、长假前一次性囤书。写在最后让收藏成为习惯而不是负担番茄小说下载器能帮你解决的问题其实很朴素书是你的不该因为平台变动而消失。从下载第一本开始逐步建立自己的书库和更新节奏你会发现离线阅读的体验远好于在 App 里随时担心书被下架。建议你今天就用 Docker 或 Python 跑通第一本然后顺手做一次备份为你的书库开个正式的头。请记住合理使用、尊重版权让工具服务于个人阅读需求。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考