如何用番茄小说下载器保存你的每一本心头好一篇从零到跑通的完整教程【免费下载链接】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然后显示一个数字菜单你只需要输入对应数字数字功能适用场景直接输入 ID 或链接单本下载最常见下完即走1更新小说读取record.json里的记录只补新章节2搜索不知道 ID用书名关键词找3批量下载一次导入多本书适合囤书4设置调整段首缩进、延迟、路径、格式、线程数5备份备份已下载书籍及配置换机不丢数据6退出程序结束会话命令行版最值得玩的三个操作更新已下载的小说追更党的日常。选择 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.listapt update apt upgradepip install requests ebooklib tqdm beautifulsoup4最后运行手机专用的精简版python ref_main.py注意ref_main.py是手机精简版运行前需要删掉其中的 tkinter 导入。如果安装 lxml 库报错可以用CFLAGS-O0 pip install lxml重试。配置调优把下载调成最舒服的状态无论是 Web 版还是命令行版你都可以进入设置调整这些关键参数保存格式怎么选格式特点推荐场景单个 TXT一整本一个大文件手机、电脑通吃分章 TXT每章一个文件需要按章节管理EPUB带目录和排版Kindle 等电子书阅读器HTML保留原始排版浏览器阅读LaTeX专业排版源码学术或再排版需求三个直接影响体验的参数正文段首占位符控制每段开头的缩进数量和字符默认是中文全角空格想改成两个空格也可以章节下载间隔延迟默认在 50150 毫秒之间随机适当调大一些能降低请求频率减少失败概率下载线程数范围 116调大下载更快但也会给服务器更大压力建议按需设置别拉满小贴士设置里每次修改都会覆盖原来的数据改之前先想清楚。如果想恢复默认配置直接删除data/config.json文件下次启动会自动重建。避坑手册六个高频问题的情景问答问启动后报错ProxyError: Unable to connect to proxy怎么办答这是网络问题最常见的原因是开着代理或网络加速器。关闭代理和加速器确认能正常访问番茄小说网页后重试。问下载到一半有几章失败要手动重下吗答不用。程序内置了重试机制失败的内容会自动重新下载。如果整本下完仍有缺失用命令行版的更新功能补一次即可。问Python 版本是 3.8 以下装依赖总报错答升级 Python 到 3.8 以上最稳妥。另外注意老版本项目里的main.py可能需要删除后把main2.py改名为main.pyREADME 里有明确说明。问Web 界面打开是空白页答先确认启动命令所在终端没有报错再看端口是否被占用。服务正常时浏览器访问http://localhost:12930就能看到界面。问下载速度很慢正常吗答正常。程序默认设置了随机延迟来避免给服务器压力这是慢而稳的设计。想提速可以适当调小延迟范围或增加线程数但别过度。问换了一台电脑之前的下载记录怎么迁移答用命令行版的备份功能导出数据在新机器上启动时会检测到备份文件夹并询问是否恢复选 1 即可无缝衔接。写在最后回到那个深夜还记得文章开头那个深夜吗现在同样的场景会有一个不同的结局。你只需要在番茄小说 App 里找到那本书复制链接打开http://localhost:12930点一下下载。几分钟后一本完整的 EPUB 就躺在你的novel_downloads文件夹里可以拷进 Kindle可以传到手机也可以存进网盘。工具再强大也要记得分寸下载的内容请仅用于个人学习与欣赏别做商业传播下载时保持合理频率尊重平台与作者。把且用且珍惜记在心里这个工具才能陪你把喜欢的书一本一本都留下来。现在去启动你的第一次下载吧。你的数字图书馆从这一本书开始。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考