fanqienovel-downloader：番茄小说下载神器 v1.1.6

在网文阅读风靡的当下，番茄小说凭借丰富的内容吸引了大量读者。然而，想要将喜欢的小说下载下来离线阅读，却不是一件容易的事。今天就给大家介绍一款专门用于下载番茄小说的工具 ——fanqienovel-downloader，它能满足你下载番茄小说的需求，让你随时随地畅快阅读。

一、工具概述

fanqienovel-downloader是一款通过 Python 实现的番茄小说下载工具。目前，v1.1.5 及以下版本由于 API 失效已无法使用，请务必使用 v1.1.6 及以上版本 。这款工具的开发者们因上学原因无法及时回复大家的问题，希望大家能够理解。它不仅能帮助你下载小说，还有一些衍生工具辅助使用：

• c.exe：用于检测番茄小说网页结构变化，确保下载工具能适应网页的更新，保持稳定运行。
• s.exe：可进行小说内容搜索，搭配番茄小说下载器使用，方便你快速找到想要下载的小说。
• f.exe：能以文件大小来分割小说文件，对于篇幅较长的小说，分割后更便于管理和阅读。

二、使用方法

（一）本地程序（v1.1.8 版本及以上）

操作非常简单，你可以根据自己的需求进行选择：

• 输入小说目录页面完整链接或者 id，就能直接下载小说。
• 输入 “1”，程序会读取record.json中的 id 进行更新，让你及时获取小说的最新章节。
• 输入 “2”，可以进行搜索，快速定位你想下载的小说。
• 输入 “3”，开启批量下载模式，一次下载多本小说，节省时间。
• 输入 “4”，进入设置界面，在这里你可以调整正文段首占位符、延时，设置小说存储位置以及保存模式。
• 输入 “5”，能够备份下载的小说，还能选择下载格式、设置段首空格等。
• 输入 “6”，即可退出程序。

目前（v1.1.14 版本），软件支持多种保存方式：

• 整本保存：适合篇幅较短的小说，方便一次性阅读。
• 分章保存：对于长篇小说来说，分章保存便于管理和查找特定章节。
• EPUB 电子书格式保存：兼容性强，可在多种电子设备和阅读软件上阅读。
• html 格式保存：能在浏览器中打开阅读，且支持基本的网页浏览功能。
• Latex 格式保存：适合对排版有较高要求，需要进行文档编辑的用户。

需要注意的是，修改设置中的每一个选项都会覆盖原来的数据，所以在操作前请仔细查看。如果想要修复默认选项，删除config.json文件即可。

（二）Web 版

Web 版番茄小说下载器功能也十分强大：

• 便捷下载：网页服务器下载完直接让你下载小说文件到本地，还能远程放在容器或虚拟机中运行，方便在不同环境下使用。
• 功能丰富：有进度条，能实时查看下载进度；可以透过 id 下载小说，也能用名字搜索小说，还能更新之前下载的小说。
• 界面简洁：简洁的 UI 界面，操作一目了然。
• 队列设计：支持队列设计，能把好几本书加入队列，实现批量下载。
• 在线阅读：提供在线阅读功能，无需下载即可直接阅读小说内容。

你可以通过以下 3 种方式运行 Web 版：

• 直接执行 exe 文件：这种方式最为简单直接，适合不太熟悉编程环境的用户。
• Python 运行：用 Git 克隆这个项目或直接下载项目的 zip 并解压。进入项目文件夹，新建虚拟环境，使用pip install -r requirements.txt安装项目的 python 依赖。接着进入src目录，用 python 运行server.py，并根据指示用浏览器开启http://localhost:12930。注意，如果使用的是 python 版本 3.8 及以下，下载项目zip或git时，要在src目录中将原来的main.py删除，再把main2.py名称改为main.py。
• Docker 运行：用 Git 克隆这个项目或直接下载项目的 zip 并解压，进入项目文件夹。直接使用docker compose up（或是docker compose up -d在后台运行）构建并启动镜像。启动后用浏览器访问http://localhost:12930。下载的小说和个人数据（data文件夹）会存在 docker 卷里面，分别叫做fanqie_data和fanqie_downloads。如果想修改成某个特定的目录，可以修改docker-compose.yaml文件中的持久化用户数据部分。

（三）手机版

目前手机上有一种使用方式（只是 ref_main.py，不是 web 版）：

• 首先安装 termux，它是一款在安卓系统上模拟 Linux 环境的应用。
• 进行换源操作，执行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 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple。
• 安装相关包，执行pip install requests ebooklib tqdm beautifulsoup4 ，注意要在 ref_main.py 中删掉 tkinter 的导入。
• 最后运行python ref_main.py即可。运行过程中要确保环境配置正确，若安装 lxml 库报错，按照CFLAGS="-O0" pip install lxml的步骤解决。

三、运行情况

fanqienovel-downloader在多个系统上都能稳定运行：

四、常见问题解答

Q：报错信息为The above exception was the direct cause of the following exception: urllib3.exceptions.ProxyError: ('Unable to connect to proxy', FileNotFoundError(2, 'No such file or directory'))等一系列错误怎么办？
A：这是网络错误，请检查网络连接，比如关闭代理、加速网络等操作，确保网络正常后再尝试下载。

五、集思广益与免责声明

如果你在使用过程中有任何意见，或者发现程序存在错误，欢迎在 Issues 中讨论，大家一起完善这款工具。

需要强调的是，此程序旨在用于与 Python 网络爬虫和网页处理技术相关的教育和研究目的。不应将其用于任何非法活动或侵犯他人权利的行为。用户对使用此程序引发的任何法律责任和风险负有责任，作者和项目贡献者不对因使用程序而导致的任何损失或损害承担责任。在使用此程序之前，请确保遵守相关法律法规以及网站的使用政策，若有任何疑问或担忧，建议咨询法律顾问。

六、下载地址