番茄小说下载器上手指南：免费把番茄小说存成 EPUB 和有声书，完整走通离线阅读

番茄小说下载器上手指南：免费把番茄小说存成 EPUB 和有声书，完整走通离线阅读

【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader

地铁里信号一断，想续上那本小说就得干等；Kindle 这类离线设备更没辙，番茄小说根本没法直接在上面读。番茄小说下载器（Tomato-Novel-Downloader）就是干这个的：把番茄小说整本抓下来，转成 EPUB 电子书、TXT 或 MP3 有声书存到本地，断网也能看。项目完全免费、用 Rust 编写，Windows、macOS、Linux 和安卓（Termux）都能跑。

看懂免费小说下载器比手动存章节强在哪

它适合三类人：通勤和出差经常断网、用 Kindle 等离线设备读书、同时追更多本小说并想自动更新的人。和"浏览器里一章一章复制"或纯在线阅读相比，差别主要在这几处：

五分钟装好并下载第一本 EPUB

主线是"安装 → 配置 → 下载第一本"，走最短路径。

第 1 步：安装。Windows 直接在 Releases 列表下载TomatoNovelDownloader-Win64-版本号.exe，双击运行；Linux、macOS 和安卓 Termux 用一键脚本：

bash <(curl -sL https://dl.zhongbai233.com/installer.sh)

第 2 步：配置。程序自带 TUI 和 Web 两种界面，最省心的是 Web 界面：

TomatoNovelDownloader --server

启动后浏览器打开http://127.0.0.1:18423，在配置页设置保存路径、输出格式（EPUB/TXT）和是否生成有声书，配置会写回 config.yml，下次不用再调。Web 界面的实现可以看 src/ui/web/。

第 3 步：下载第一本。在搜索框输入书名或作者，点下载即可。长书下载中途断网也不慌：程序记录章节级进度，重跑时已完成且非空的章节自动跳过，下载完成后 EPUB 会带上封面和多级目录，可以直接导入 Kindle。

玩转三种进阶用法：定时更新、NAS 部署与有声书

定时更新追更中的小说

CLI 保留了非交互模式，专门给"已下载过的书"补更新，适合写进定时任务：

TomatoNovelDownloader --update 7318247498772674083 --retry-failed

注意--update只接受 book_id，且这本书必须已有本地下载记录，否则会被拒绝——首次下载请走 Web UI 或 TUI。book_id 直接从分享链接里那段长数字复制就行；想批量更新，在脚本里按书分别调用即可。

Docker 或 NAS 部署，全家设备都能访问

有现成的 Web UI 镜像，映射端口、挂一个数据目录，配置和日志就都持久化在挂载目录里：

docker run -d --name tomato-novel-webui \ -p 18423:18423 -v /host/data:/data \ -e TOMATO_WEB_ADDR=0.0.0.0:18423 -e TOMATO_WEB_PASSWORD=你的密码 \ zhongbai233/tomato-novel-downloader-webui:latest \ --server --data-dir /data

软路由或 NAS 这类轻量系统请改用latest-musl标签的镜像；如果要暴露到公网，建议放在反向代理/HTTPS 后面并务必开启密码锁。

下载完顺手生成有声书

在配置菜单打开"是否生成有声小说"即可。底层是 Edge TTS，默认发音人zh-CN-XiaoxiaoNeural，可自定义语速、音量、音调和 mp3/wav 输出格式；音频按章节存到{书名}_audio文件夹并自动命名（如0001-第一章.mp3），下载过封面还会生成cover.jpg供播放器识别。已生成的章节会自动跳过，只补缺失部分。注意 TTS 需要联网调用微软在线服务。音频与 EPUB 生成逻辑都在 src/book_parser/。

快速排掉四个最高频问题

• 别的设备打不开 127.0.0.1:18423：默认只监听本机。启动前设置TOMATO_WEB_ADDR=0.0.0.0:18423暴露到局域网，同时用TOMATO_WEB_PASSWORD或--password上密码，防止陌生人使用。
• CLI 执行 --update 被拒绝：CLI 已禁用新建下载，只更新本地已有记录的书；首次下载请用 Web UI 或 TUI 完成。
• 部分章节下载失败：可能是接口临时拥塞或该书尚未更新完，稍后重跑即可，断点续传会跳过已完成章节，可加--retry-failed对失败章节补一次。1500 章以上的超长书目建议分批下载，不要盲目调高并发。
• 有声书没生成或报错：TTS 依赖微软在线服务，需能正常访问外网；具体错误信息可在日志目录中查看。

回到源码仓库继续深挖项目

到这里，搜索、下载、EPUB/有声书生成、定时更新的完整链路已经全部打通，剩下的就是按需调配置。想改代码或贡献功能，从仓库入手：

git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader

核心逻辑按模块分布：下载调度与断点续传见 src/download/，解析与格式导出见 src/book_parser/。

提醒一句：下载内容仅限个人阅读使用，请尊重作者版权。

【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader