如何用番茄小说下载器保存你的每一本心头好：一篇从零到跑通的完整教程

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

一个你可能也经历过的瞬间

深夜十一点，你刚把一本追了两个月的小说看到精彩处，翻回目录想看看还剩多少章，却发现书名已经变成了灰色——平台下架了。收藏夹里的链接点开只有一行冷冰冰的"作品已删除"。那一刻的失落，大概只有追书的人能懂。

我的一位朋友就吃过这个亏。此后他养成了一个习惯：但凡遇到喜欢的书，先想办法存一份本地副本，再慢慢看。而他用的工具，正是本文的主角——番茄小说下载器（fanqienovel-downloader）。它是一款开源、免费、纯 Python 实现的下载工具，支持整本保存、分章保存、EPUB 电子书等多种格式，还附带一个带进度条、书库和在线阅读器的 Web 界面。

在接下来的文章里，我会带你从零开始，把这款工具安装到自己的电脑上，完成一次完整的下载实操，再进阶到批量下载、个性化配置和手机端使用。全程不写代码，只讲"怎么做"和"为什么这么做"。

先搞清楚：这款工具到底适合谁

一句话概括：番茄小说下载器能把番茄小说平台的书籍内容保存到本地，变成你随时能打开的文件。

它适合这几类人：

• 追更党：担心作品下架，想留一份完整备份
• 电子书用户：想把小说转成 EPUB，放进 Kindle 等阅读器
• 离线阅读爱好者：通勤路上没有网络，照样能看
• 喜欢折腾的技术派：愿意花十分钟配置，换来自动化批量下载

需要说明的是，工具本身免费开源，但下载内容请仅限个人学习与研究使用，不要用于商业用途，也要控制下载频率，别给服务器添麻烦——README 里作者那句"请勿滥用，且用且珍惜"是有道理的。

三步完成环境搭建：从空电脑到能跑起来

第一步：确认 Python 版本

这是整个过程中最容易忽略、也最容易卡住的一步。请先打开终端，输入：

python --version

看到3.8 及以上版本就可以放心往下走。如果版本偏低或提示找不到命令，去 Python 官网装一个新版再回来。

第二步：获取项目源码

在终端中执行下面这行命令，把项目拉取到本地：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader

命令执行后，你的当前目录下会出现一个fanqienovel-downloader文件夹，项目代码就在里面。如果不方便用 git，也可以直接下载项目压缩包解压，效果相同。

第三步：安装依赖包

进入项目文件夹，安装它运行所需的 Python 依赖库：

cd fanqienovel-downloader pip install -r requirements.txt

这一步会装上requests、lxml、ebooklib、flask等一整套库，分别负责网络请求、网页解析、EPUB 生成和 Web 界面，一条命令全部搞定。

小贴士：如果安装过程提示权限问题，可以给命令加上--user参数，或者先创建一个 Python 虚拟环境再安装，能避免不少环境冲突。

第一次实操：用 Web 版完成你的首次下载

如果你是新手，强烈建议走 Web 版这条路径。它有图形界面、实时进度条、搜索功能，还有书库管理，几乎没有学习成本。

启动 Web 服务

在项目目录下执行：

cd src python server.py

启动成功后，打开浏览器，输入地址：

http://localhost:12930

此时你会看到番茄小说下载器的操作界面，顶部分别有搜索、书库、阅读、设置四个入口。只要服务窗口不关闭，页面就可以一直访问。

找到小说的 ID 或链接

打开番茄小说 App，进入你想下载的作品详情页，复制它的网址。网址中的那串纯数字，就是这本书的 ID。举个例子，链接里/page/7143038691944959011这样的数字段就是 ID。

发起下载

把 ID 或完整链接粘贴进下载输入框，选择保存格式，点击开始。

下载过程中你会看到：

• 一个实时更新的进度条，当前章节、百分比一目了然
• 一个下载队列，可以提前把好几本书加进去，排队依次下载
• 下载完成后，小说文件会出现在项目的novel_downloads文件夹里

用内置阅读器直接看

下载完成的书籍会进入"书库"，你可以直接在 Web 界面里点开阅读，体验和在线看书差不多，但内容已经存在本地了。这一步很关键——它意味着即使之后这本书在平台上消失，你的书库里依然有完整的副本。

进阶玩法：把命令行版玩出效率

如果你是技术用户，习惯在终端里操作，命令行版main.py更适合你。它在src目录下，运行方式：

cd src python main.py

程序启动后会先自动获取 Cookie，然后显示一个数字菜单，你只需要输入对应数字：

命令行版最值得玩的三个操作

更新已下载的小说：追更党的日常。选择 1，程序会读取之前的下载记录，只把新更新的章节补下来，不用整本重下。

搜索书名：如果你忘了 ID，选 2 输入关键词，它会列出匹配结果供你挑选，确认后直接下载。

批量囤书：选 3，把多本书的 ID 一次性导入，程序按队列逐本处理，适合集中整理一批想看的书。

两台设备的特殊方案：Docker 与手机

用 Docker 把服务常驻运行

如果你希望下载服务 7×24 小时在线，或者想部署在服务器/虚拟机里，Docker 是最省心的方案。在项目根目录执行：

docker compose up -d

-d参数表示后台运行，构建完成后同样访问http://localhost:12930。你下载的小说和个人数据会存放在 Docker 卷里（名为fanqie_data和fanqie_downloads），想换存储位置的话，改一下docker-compose.yml中的持久化配置即可。

用 Termux 在安卓手机上跑

想躺床上用手机下载？可以。在手机上安装 Termux 终端应用，然后依次执行三条命令完成配置和安装：

sed -i 's@^(.*deb.*stable main)$@#\1\ndeb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list

apt update && apt upgrade

pip install requests ebooklib tqdm beautifulsoup4

最后运行手机专用的精简版：

python ref_main.py

注意：ref_main.py是手机精简版，运行前需要删掉其中的 tkinter 导入。如果安装 lxml 库报错，可以用CFLAGS="-O0" pip install lxml重试。

配置调优：把下载调成最舒服的状态

无论是 Web 版还是命令行版，你都可以进入"设置"，调整这些关键参数：

保存格式怎么选

三个直接影响体验的参数

• 正文段首占位符：控制每段开头的缩进数量和字符，默认是中文全角空格，想改成两个空格也可以
• 章节下载间隔延迟：默认在 50～150 毫秒之间随机，适当调大一些能降低请求频率，减少失败概率
• 下载线程数：范围 1～16，调大下载更快，但也会给服务器更大压力，建议按需设置，别拉满

小贴士：设置里每次修改都会覆盖原来的数据，改之前先想清楚。如果想恢复默认配置，直接删除data/config.json文件，下次启动会自动重建。

避坑手册：六个高频问题的情景问答

问：启动后报错ProxyError: Unable to connect to proxy，怎么办？

答：这是网络问题，最常见的原因是开着代理或网络加速器。关闭代理和加速器，确认能正常访问番茄小说网页后重试。

问：下载到一半有几章失败，要手动重下吗？

答：不用。程序内置了重试机制，失败的内容会自动重新下载。如果整本下完仍有缺失，用命令行版的"更新"功能补一次即可。

问：Python 版本是 3.8 以下，装依赖总报错？

答：升级 Python 到 3.8 以上最稳妥。另外注意，老版本项目里的main.py可能需要删除后把main2.py改名为main.py，README 里有明确说明。

问：Web 界面打开是空白页？

答：先确认启动命令所在终端没有报错，再看端口是否被占用。服务正常时浏览器访问http://localhost:12930就能看到界面。

问：下载速度很慢，正常吗？

答：正常。程序默认设置了随机延迟来避免给服务器压力，这是"慢而稳"的设计。想提速，可以适当调小延迟范围或增加线程数，但别过度。

问：换了一台电脑，之前的下载记录怎么迁移？

答：用命令行版的"备份"功能导出数据，在新机器上启动时会检测到备份文件夹并询问是否恢复，选 1 即可无缝衔接。

写在最后：回到那个深夜

还记得文章开头那个深夜吗？现在，同样的场景会有一个不同的结局。你只需要在番茄小说 App 里找到那本书，复制链接，打开http://localhost:12930，点一下下载。几分钟后，一本完整的 EPUB 就躺在你的novel_downloads文件夹里，可以拷进 Kindle，可以传到手机，也可以存进网盘。

工具再强大，也要记得分寸：下载的内容请仅用于个人学习与欣赏，别做商业传播；下载时保持合理频率，尊重平台与作者。把"且用且珍惜"记在心里，这个工具才能陪你把喜欢的书一本一本都留下来。

现在，去启动你的第一次下载吧。你的数字图书馆，从这一本书开始。📚

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