把整本小说搬进手机离线读：番茄小说下载器快速上手全攻略

【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader

你是不是也经历过这样的瞬间——地铁上追更正到高潮，隧道一进，页面转圈，书没了；或者某天兴冲冲点开收藏夹，发现心爱的小说静悄悄下架了，评论区里一片哀嚎。网一断、书就没了，这谁顶得住？

今天要聊的「番茄小说下载器」（fanqienovel-downloader）就是来解决这个问题的：它用 Python 把整本小说抓下来存到你本地，以后没网也能看、下架也不怕、换设备不用重下。下面我用一个新手视角，带你从零跑通第一本书。

这工具到底能给你带来什么

先别管技术细节，直接看它能给阅读习惯带来哪些改变：

• ✅断网照读：高铁、地铁、地下室，任何信号死角都能继续翻页。
• ✅防下架保险：平台删书、章节锁定，你本地那份永远在。
• ✅多设备同步：导出一次，手机、平板、电纸书、电脑各存一份。
• ✅自动追更：程序会记住下载记录，连载小说更新了能自动补抓新章节。
• ✅搜索+批量：想找书、想一次囤好几本，都是内置功能，不用另装工具。

一句话总结：把在线阅读变成本地资产，主动权回到你手里。

三种打开方式，选一个就能跑

上手方式一共有三条路，新手推荐第一条，爱折腾的可以往后看。

方式一：浏览器版，一条命令启动

这是最省心的入口，图形界面、实时进度条、下载队列、在线预览阅读器全都配齐了。先在电脑上装好 Python（3.9 以上都行），然后打开终端执行：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src python server.py

看到提示后，用浏览器访问http://localhost:12930，一个简洁的管理界面就出现了。在这里你可以：按 ID 下载、按书名搜索、更新已下载的小说、把好几本书加进队列批量处理。下载完成的文件直接由网页端交给你，所以它也能部署在远程服务器或容器里，随时远程调用。

方式二：命令行版，记住几个数字就行

喜欢键盘操作的话，进入src目录运行python main.py，交互菜单很简单：

1. 直接输入书籍 ID 或小说目录页链接，回车即下载。
2. 输入1：读取record.json里的记录，更新已下载的书籍。
3. 输入2：关键词搜索找书。
4. 输入3：批量下载多本书。
5. 输入4：进入设置，调整段首占位符、下载延时、保存路径、保存方式和线程数。
6. 输入5：备份已下载的小说和下载配置。
7. 输入6：退出程序。

每一步都有中文提示，基本不用看文档，跟着走就行。

方式三：Docker 版，扔服务器上长期服役

想在 NAS 或云服务器上常驻，用 Docker 最省事。项目根目录下直接执行：

docker compose up -d

构建完成后访问http://localhost:12930即可。下载的小说和个人数据存放在名为fanqie_data、fanqie_downloads的两个 Docker 卷里，容器删了数据还在；想换存储位置，改docker-compose.yml里的卷映射就行。镜像默认带 1G 内存上限，不用担心长期运行挤爆主机。

五个真实场景，照着做就行

场景一：通勤路上离线读

在设置里把保存方式切到 EPUB，下载完拷进手机，用微信读书或任意阅读器打开，地铁上随便刷。EPUB 的排版体验比纯 TXT 好不少，适合日常手机阅读。

场景二：追更连载小说

连载文最烦的就是每天惦记着"今天更没更"。用下载器的更新功能：每次运行后读取record.json里记过的书籍 ID，自动对比新增章节并补抓，跑一次就同步到位，每天花几秒就完事。

场景三：一次性囤下整个书架

把想看的书 ID 排进队列，批量下载，一次跑完。之后导出成 TXT 或 EPUB，分设备各放一份，等于给自己做了个离线书架。

场景四：存储空间紧张

如果手机空间告急，退回 TXT 整本保存，单文件体积最小，一个文件装下整本书，最省地方。

场景五：想二次编辑整理

有排版控需求的话，试试分章保存或 LaTeX 格式，每章一个文件、便于批注，后续处理素材更方便。HTML 格式则适合直接用浏览器打开阅读，样式友好。

五种保存方式，怎么选

目前（v1.1.14）程序共支持五种保存方式，对号入座即可：

进阶玩法：让效率再进一步

参数怎么调才不翻车

src/main.py里的Config定义了四个关键参数，改完保存在config.json：

网络状况好时，把延时调低、线程提到 24 左右能明显提速；手机端跑则建议调低线程数，免得机身发烫。

脚本批量收藏整批书

书多的时候，写个简单的循环脚本逐本调用即可：

novel_ids=("7143038691944959011" "7123456789012345678") for id in "${novel_ids[@]}" do echo "开始下载：$id" python main.py <<< "$id" sleep 2 done

手机端也能离线跑

在 Android 上装好 Termux 后，按顺序执行：

pip install requests ebooklib tqdm beautifulsoup4

注意先把ref_main.py里的 tkinter 导入删掉；如果装 lxml 编译报错，改用CFLAGS="-O0" pip install lxml重装。之后运行python ref_main.py，手机上直接下整本书，通勤路上离线阅读完全够用。

配套小工具接力

项目还带几个实用小工具：用于检测番茄小说网页结构变化的检测程序、在已下载小说里做全文搜索的搜索工具、按文件大小切分超长小说的分割工具。下载、搜索、分卷三步串联，就能搭一套完整的个人小说管理流水线，相关说明集中在项目根目录的README.md与phone.md。

先看这里，省得踩坑

• 旧版本直接失效：v1.1.5 及以下版本因网站 API 变动已无法使用，务必用 v1.1.6 及以上版本。
• 代理导致连不上：报ProxyError/MaxRetryError时，多半是系统代理或加速器拦了请求，关掉代理、检查网络再重试。
• 设置会被整体覆盖：改设置里的任意一项都会覆盖原配置文件，改前看清；想恢复默认，直接删掉config.json再重启。
• 老版本 Python 要换文件：Python 3.8 及以下环境，进src目录后删掉原main.py，把main2.py改名为main.py再运行。

最后说两句

说到底，这个工具的价值不在"爬取"本身，而在于把阅读的主动权还给你：不受信号摆布、不惧内容下架、不被单一设备绑架。项目遵循 AGPL-3.0 协议开源，由 Yck、Yqy、Lingo 三位开发者维护，使用源码时请注明来源并同样遵守该协议；有问题可以去项目 Issues 反馈，或加交流群 428582738 和开发者、其他用户一起讨论。

动手之前记得守住边界：仅用于个人学习、研究与离线阅读，不要高频抓取、不要商用传播，尊重作者版权。现在就按上面的步骤跑通第一本书吧——三分钟之后，你的专属离线阅读资料库就正式开张了。

【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader