番茄小说下载器离线阅读手册一本书五种导出格式三条启动路径一次讲透【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloaderfanqienovel-downloader番茄小说下载器是一个用 Python 写成的开源工具作用很纯粹把番茄小说平台上的整本书抓取下来以 TXT、EPUB、HTML 等格式永久保存在本地。从此追更不怕章节被锁、通勤不怕没信号、换设备不用重新找书。接下来这篇文章会按它有什么用 → 怎么快速装好 → 三个运行环境怎么选 → 参数怎么调 → 踩坑怎么躲 → 还能怎么玩的顺序带你从零把它跑起来。它解决的痛点把在线阅读变成本地资产在线看小说你有过这些经历吗地铁隧道里刷着刷着转圈圈追了一半的书突然下架换了新手机收藏夹里一堆链接全失效。这些问题的根源只有一个——内容不在你手里。番茄小说下载器就是为此而生的。你只需要给程序一个目录页链接或一串书籍 ID它会自动识别章节结构把正文一章一章抓回来存到本地。下载完成后这本书就真正属于你了断网能读、下架不怕、手机平板电纸书随意分发。更贴心的是它不是一个一次性工具。程序自带更新检测会读取record.json里记录过的书籍 ID自动对比并补抓新增章节。追连载小说时每天跑一次就等于自动帮你把新章节收进书库完全不用手动对比。能力全景一张表看懂它能干什么打开工具你会发现它能做的事比想象中多。这里把核心能力整理成一张速查表功能说明单本下载输入小说目录页链接或 ID立即下载整本书一键更新读取record.json中的记录批量补齐新增章节关键词搜索直接搜书名找到后即可下载批量下载把多本书加入队列依次处理设置项调整自定义段首占位符、请求延时、保存路径、保存格式、线程数配置备份一键备份已下载小说与下载格式、段首设置等在线阅读Web 版内置阅读器下载完直接在浏览器里看五种输出格式按阅读习惯自由切换目前版本v1.1.14支持五种保存方式对应不同人群的阅读习惯保存方式输出形态适合谁整本保存单文件 TXT追求简单一个文件装下全书分章保存每章一个 TXT习惯按章节整理、做批注的用户EPUB 格式标准电子书Kindle、微信读书等阅读器用户HTML 格式带目录和翻页链接的网页想用浏览器直接阅读的用户LaTeX 格式.tex源文件排版控、需要二次编辑的用户日常手机阅读推荐 EPUB体验最接近原生电子书空间紧张就退回 TXT体积最小要做内容处理再考虑分章与 LaTeX。这些选项在设置里随时切换不需要安装任何额外转换工具。上手第一步三分钟跑通命令行版命令行版是所有玩法的基础进入项目src目录后运行主程序即可git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src python main.py程序启动后交互菜单只认六个选项跟着中文提示走就行输入 ID 或链接——立即下载单本书输入 1——读取record.json更新已下载书籍输入 2——关键词搜索小说输入 3——批量下载多本书输入 4——进入设置段首占位符、延时、保存路径、保存模式、线程数输入 5——备份小说文件与下载配置输入 6——退出程序每一步都有清晰的中文提示几乎不需要翻文档就能上手。想要图形界面一行命令启动 Web 服务命令行对新手不太友好项目还提供了完整的 Web 版。在项目src目录下运行python server.py然后用浏览器打开http://localhost:12930就能看到一个简洁的管理界面。它具备完整的图形化操作按 ID 下载也能按书名搜索后直接下载实时进度条每章状态一目了然下载队列把好几本书加进去批量处理一键更新已下载的小说在线阅读器下载完直接在浏览器里看Web 版下载完成后会直接把文件交给你因此它可以部署在远程服务器或容器里随时通过浏览器调用相当于给家里 NAS 装了一个专属的小说下载服务。放服务器上长期跑Docker 一步到位想 7×24 小时常驻运行用 Docker 最省心。项目根目录已经备好Dockerfile和docker-compose.yml一条命令搞定docker compose up -d构建完成后访问http://localhost:12930即可使用。几个值得注意的细节下载的小说和个人数据分别存放在名为fanqie_data、fanqie_downloads的 Docker 卷中容器销毁数据不丢想改存储位置编辑docker-compose.yml中的卷映射即可镜像默认设置了 1G 内存上限避免长期运行挤占主机资源。手机也能离线下载Termux 三步走在 Android 设备上装好 Termux 终端就能把命令行版跑起来运行的是ref_main.pypip install requests ebooklib tqdm beautifulsoup4两个易错点提前提醒先删掉ref_main.py里的 tkinter 导入若安装 lxml 报错改用CFLAGS-O0 pip install lxml重装。完成后运行python ref_main.py通勤路上离线阅读完全够用。更详细的换源与依赖安装步骤见项目根目录的 phone.md。几个关键参数决定下载体验src/main.py中的Config定义了下载核心参数修改后保存在config.json参数默认值含义delay[50, 150]章节请求间隔毫秒网络差可调大xc16并发下载线程数过高易触发限制save_mode1保存方式对应上文五种格式save_path默认下载目录小说保存位置网络状况良好时可以适当降低延时、把线程数提到 24 左右提速手机端建议调低线程数避免过热。注意修改设置的任意一项都会整体覆盖原配置文件改前先看清楚想恢复默认直接删除config.json后重启程序即可。常见报错与排雷清单根据项目文档和社区反馈这几个坑出现频率最高旧版本直接失效v1.1.5 及以下版本因网站 API 变动已无法使用务必使用 v1.1.6 及以上版本。代理导致的连接失败报ProxyError/MaxRetryError时多半是系统代理或加速器拦截了请求关闭代理、检查网络后重试。老版本 Python 的兼容处理Python 3.8 及以下环境按 README.md 的说明操作进入src目录删除原main.py把main2.py改名为main.py再运行当前快照中相关说明以官方文档为准。lxml 编译报错在手机上安装依赖时常见用CFLAGS-O0 pip install lxml重装即可。进阶玩法让它更合你的手追更自动化。连载小说的追更只需要一条习惯每次想更新时输入 1程序会读取record.json中所有记录过的书籍 ID 并自动补抓新章节。把这条命令放进定时任务你的书库就能做到每日自动追更。批量收藏脚本。面对整批想收藏的书可以写一个简单的循环逐本调用novel_ids(7143038691944959011 7123456789012345678) for id in ${novel_ids[]} do echo 开始下载$id python main.py $id sleep 2 done配套小工具接力。项目还衍生了几款实用工具用于检测番茄小说网页结构变化的检测程序、在已下载小说中做全文搜索的搜索工具、按文件大小切分超长小说的分割工具。下载、搜索、分卷三步串联就能搭起一套完整的个人小说管理流水线相关说明集中在项目根目录的 README.md 中。写在最后说到底这个工具的价值不在抓取本身而在于把阅读的主动权交还给你不受信号摆布、不惧内容下架、不被单一设备绑架。项目遵循 AGPL-3.0 协议开源由 Yck、Yqy、Lingo 三位开发者共同维护欢迎在 Issues 中反馈问题或提出建议也可加入交流群 428582738 与其他使用者一起讨论。动手之前记得守住边界仅用于个人学习、研究与离线阅读不要高频抓取、不要商用传播尊重作者版权。现在就按上面的步骤跑通第一本书吧——几分钟之后你的专属离线书库就正式开张了。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考