企业官网建设流程全解析

番茄小说下载器使用指南：5分钟跑通你的第一本离线小说

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

番茄小说下载器（fanqienovel-downloader）是一款基于 Python 的开源工具，核心用途只有一个：把番茄小说平台的书籍完整下载到本地，支持 TXT、EPUB、HTML、LaTeX 五种格式。如果你收藏过几百章的小说、却担心它哪天悄悄下架，或者想换个阅读器却导不出文件，这篇指南就是为你准备的。全文按照"先想清楚→再动手→后优化"的顺序展开，读完大约需要 10 分钟。

动手之前，先回答三个问题

很多新手拿到工具就急着敲命令，结果下载完才发现格式不对、位置不对、更新不了。与其返工，不如先花一分钟做三个决定。

第一，你要哪种文件格式？整本 TXT 体积最小、任何设备都能打开；分章 TXT 适合逐章校对和编辑；EPUB 是 Kindle、多看等专业阅读器的通用格式；HTML 方便在浏览器里翻阅和分享；LaTeX 则适合做排版输出。普通读者首选整本 TXT 或 EPUB，后面随时可以改。

第二，你打算把书存在哪？本地目录、外接硬盘，还是服务器？这决定了你选 Web 版还是命令行版（下文会说）。

第三，你会不会追更？如果会，下载后记得保留记录文件，这样下次一键就能更新全书，而不是重新下载。

5 分钟跑通第一次下载：三条路径任选

番茄小说下载器提供了三条启动路径，按你的环境选一条最快的。

路径一：Docker 一键启动（最省心）

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader docker compose up -d

这三条命令依次做的是：拉取项目源码、进入项目目录、后台启动容器。启动后浏览器访问http://localhost:12930就能看到 Web 界面。小说文件和个人数据会存入 Docker 卷fanqie_downloads与fanqie_data，重装系统也不丢。

路径二：Python 直接运行（适合开发者）

pip install -r requirements.txt cd src python server.py

同样访问http://localhost:12930。这种方式方便你随时改源码、看日志，适合想深入了解实现细节的人。

路径三：直接运行 exe（零配置）

Windows 用户可以直接使用打包好的可执行文件，双击启动即可，无需安装 Python 或 Docker。

命令行版：六步把下载玩明白

Web 版适合鼠标点击，命令行版则适合批量与自动化。启动后程序会显示一个数字菜单，记住这六个入口，你就能掌控全部流程：

1. 输入链接或 ID——直接下载单本小说，支持完整页面链接和纯数字 ID 两种形式；
2. 输入 1——根据data/record.json里的记录更新所有已下载书籍，追更专用；
3. 输入 2——按书名或关键词搜索，找到后直接下载；
4. 输入 3——批量下载，把多本小说的 ID 一次性交给程序排队处理；
5. 输入 4——进入设置，调整段首占位符、下载间隔、保存位置和格式；
6. 输入 5——备份下载内容与配置，防止误删。

举个例子，你只需在提示符后粘贴一本书的 ID，回车，剩下的章节抓取、去重、排序都由程序完成，进度条会实时显示当前章节。这就是番茄小说下载器命令行版最典型的用法：一个 ID，一本完整的书。

把"下载"升级成"收藏"的三个习惯

下载完成只是开始，真正值钱的是长期维护。下面三个习惯能让你的书库长期可用。

习惯一：追更靠更新而不是重下。每次更新前，程序会读取record.json中记录的书籍 ID，只拉取新增章节，速度快且不浪费流量。你的任务只是定期运行一次更新。

习惯二：善用断点续传。网络中断时不必从头再来，程序会记录已完成的章节，下次继续。下载大长篇时这个功能能省下大量时间。

习惯三：定期备份。命令行菜单里的备份功能会把小说文件、格式设置和段首空格配置一并打包。建议每月备份一次，存到另一块磁盘。

配置参数怎么调才不踩坑

配置文件位于data/config.json，下面五个参数是高频调节项：

其中最容易出问题的是xc和delay的组合：线程数开满但延迟太低，容易被平台限流。稳妥的做法是先按建议值跑一本，观察日志里是否有大量重试，再微调。

高频故障自查清单

遇到问题先别慌，对照下面四项排查，八成能自己解决。

报错ProxyError: Unable to connect to proxy。这是最常见的网络错误，通常是系统代理或加速工具未正确关闭。检查代理设置后重试即可。

Web 界面打不开。优先检查 12930 端口是否被占用。Docker 用户可修改docker-compose.yml中的端口映射，比如改成"12931:12930"再重启容器。

提示 API 失效无法下载。番茄小说下载器曾因平台接口变动导致旧版本集体失效，遇到这类提示先升级到最新版本（v1.1.6 及以上），不要纠结旧版本。

章节内容乱码或格式错乱。先确认系统编码为 UTF-8，再尝试切换保存格式，最后检查网络环境是否稳定。src/charset.json是内置的字符映射表，正常情况下无需手动修改。

进阶玩法：手机端与远程部署

手机上用命令行版。安卓用户可在 Termux 中安装 Python 环境，然后运行python ref_main.py。这条命令启动的是精简版命令行程序，不依赖图形界面，适合在手机终端里下载和更新。

远程部署到服务器。Web 版下载完成后会直接生成文件供你下载，因此很适合放在云服务器或容器中运行。你在任何设备上打开浏览器都能管理书库，下载结果即点即取。

批量管理书单。整理一个包含多个小说 ID 的文本文件，配合批量下载入口，一次跑完整个书单，适合开学季、长假前一次性囤书。

写在最后：让收藏成为习惯，而不是负担

番茄小说下载器能帮你解决的问题其实很朴素：书是你的，不该因为平台变动而消失。从下载第一本开始，逐步建立自己的书库和更新节奏，你会发现离线阅读的体验远好于在 App 里随时担心书被下架。

建议你今天就用 Docker 或 Python 跑通第一本，然后顺手做一次备份，为你的书库开个正式的头。请记住合理使用、尊重版权，让工具服务于个人阅读需求。

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