企业官网建设流程全解析

用番茄小说下载神器把追更永久保存：新手到高手的完整上手路线

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

你有没有想过，自己追了半年的那本小说，某天打开页面却显示"已下架"？收藏夹里 20 多本书，停电断网时一本都打不开？这几乎是每个在线追更读者的共同焦虑。今天要聊的 fanqienovel-downloader（番茄小说下载神器），正是一款能把这种焦虑连根拔起的开源工具——它用 Python 实现，支持网页、命令行、Docker 三种玩法，让你把整本小说存进自己的硬盘。

一句话认识它

它就是一个"小说搬运工"：你给出小说 ID 或链接，它自动抓取全部章节，按你选定的格式存到本地。TXT、EPUB、HTML、LaTeX，五种格式任你挑，从此阅读不再依赖网络和平台。

为什么值得用？看三个"改变"就够了

从"每天刷新等更新"到"一条命令收全部"。过去你要在 App 里一章章翻，现在把 ID 丢给它，几百章内容自动排队下载，你去泡杯咖啡回来就完事了。

从"平台说了算"到"你自己说了算"。章节解锁限制、下架风险、广告干扰，这些都在本地文件面前失去意义。书在你手里，阅读节奏由你定。

从"一个设备锁死"到"全设备自由"。同样的内容，你可以导出 EPUB 喂给 Kindle，导出 TXT 塞进老式 MP4，导出 HTML 放在任何浏览器里看。一份书稿，处处可读。

上手路径：按你的水平选一条路走

新手首选：3 分钟跑起 Web 界面版

这是对小白最友好的一条路，全程有图形界面和进度条，不需要写任何命令之外的东西。

1. 确认电脑有 Python 3.8 及以上版本；
2. 在项目根目录执行pip install -r requirements.txt装好依赖；
3. 进入src目录，运行python server.py；
4. 浏览器打开http://localhost:12930，一个清爽的下载面板就出现了。

Web 版能干的事不少：用书名直接搜索、用小说 ID 精准下载、把好几本书加进队列批量处理、在网页里在线预览已下载的章节，还能一键更新之前下过的书。所有小说文件都保存在服务器端，你随时点下载就能拿回本地——这意味着你甚至可以把服务架在云服务器上，走到哪儿浏览器都是你的书库入口。

进阶玩家：命令行版的六键操作

如果你习惯键盘，python main.py启动后会进入一个简洁的交互菜单。核心玩法就六个入口：

• 直接输入小说 ID 或链接 → 立即开下；
• 输入1→ 读取记录自动更新已下载小说；
• 输入2→ 关键词搜索，列出来让你挑；
• 输入3→ 批量下载（提前把链接一行一个写进urls.txt）；
• 输入4→ 进设置，调延迟、存书位置、保存格式和线程数；
• 输入5→ 把已下载内容和你的配置整体备份。

命令行版适合喜欢掌控感的用户：每一步都清楚发生了什么，出问题也能立刻看到日志。

专业部署：Docker 与手机端

需要长期稳定运行的场景，Docker 是答案。在项目根目录执行docker compose up -d，服务在后台启动，浏览器访问http://localhost:12930即可。下载的小说和个人数据会存进fanqie_data、fanqie_downloads两个卷里，容器删了数据还在，适合放在 NAS 或服务器上 7×24 小时挂着。

想在手机上用？装 Termux 后执行：

pkg install python pip install requests ebooklib tqdm beautifulsoup4 python ref_main.py

一套环境就能在安卓上跑起来，通勤路上顺手把书下了，回家直接导入阅读器。

效果看得见：使用前后对比

拿追更来说：以前手动对比更新可能要花 10 分钟反复翻目录，现在跑一次更新命令，只下载新增章节，几十秒收工。

进阶技巧：让体验质变的四个操作

1. 调线程数提速。设置里的xc参数控制并发线程数（1–32），网络条件好时调高，几百章的整本书下载时间能明显缩短；网络不稳就调低，稳字当头。

2. 用延迟区间保护自己。delay是两次请求之间的随机毫秒间隔，调小会更快但风险更高。建议保持一个合理区间，别为了快把间隔压到极限。

3. 善用备份功能。命令行菜单里的备份项会把小说文件和你的格式设置打包带走，换电脑、重装系统后一键还原，收藏不丢。

4. 远程化你的书库。Web 版天然支持远程部署：放在服务器或虚拟机里，任何设备的浏览器都能访问、搜索、下载、阅读，等于随身带了个私人图书馆。

避坑指南：四个常见错误与解决思路

错误一：报 ProxyError，连不上网站。多半是系统代理或网络加速软件干扰了请求。解决思路：关掉代理、加速器后再试。

错误二：改完设置，老数据被覆盖。设置里的每个选项保存时都会覆盖原有数据。想回到默认值？直接把config.json删掉，重新生成一份。

错误三：手机装 lxml 库报错。在 Termux 里用CFLAGS="-O0" pip install lxml绕过编译问题。

错误四：下载大量章节失败。先检查网络是否稳定、代理是否开启；程序内置了失败章节自动重试机制，通常过一会儿自己就能恢复。

生态与未来

这款工具可以和你已有的工作流拼在一起：配合文本搜索工具在已下载书库里快速定位内容，配合文件分割工具把超长小说按体积切开，再挂个定时任务就能实现"每日自动更新 + 定期备份"的无人值守。项目本身也在持续演进，格式支持更全、界面更顺手、多平台适配都是可期待的方向。如果你会 Python、前端或只是爱折腾，欢迎去 Issues 里提建议、报 bug，或者直接提 Pull Request 参与进来。

现在就动手：三步启动

1. 拉取项目：git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader，然后cd fanqienovel-downloader；
2. 安装依赖：pip install -r requirements.txt；
3. 开始使用：进src跑python server.py，浏览器开http://localhost:12930，搜一本你喜欢的书，点下载。

最后提醒一句：这是一款开源项目（遵循 AGPL-3.0 协议），由 Yck、Yqy、Lingo 几位开发者共同维护。请把它用在个人学习、研究和离线阅读上，尊重作者版权，合理控制下载频率，别让好工具因为滥用而消失。你的书库，从这一本开始。📚

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