番茄小说下载器使用指南从安装到 EPUB、有声书导出的完整流程【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader地铁里信号断断续续追更的章节刷不出来。番茄小说下载器Tomato-Novel-Downloader可以把整本番茄小说抓到本地导出成 EPUB 电子书或 Edge TTS 有声书让你离线阅读。这篇指南带你完成安装、跑通第一次下载并配好长期追更需要的几个设置。它是用 Rust 重写的项目提供 TUI终端界面、Web UI浏览器和老 CLI 三种操作方式支持断点续传和自动重试。装起来三个平台各给一条最短路径这节帮你把程序装到 Windows、Linux/macOS/Termux 和 NAS 上装完立刻能运行。Windows到项目的 Releases 列表下载TomatoNovelDownloader-Win64-版本号.exe双击运行。首次启动会在程序同目录自动生成带注释的config.yml然后进入 TUI 界面。Linux / macOS / Termux跑一条一键安装脚本bash (curl -sL https://dl.zhongbai233.com/installer.sh)脚本会按你的平台拉取最新版本二进制并加执行权限结束后当前目录会出现tomato-novel-downloader可执行文件。NAS / 软路由Dockerdocker run -d -p 18423:18423 \ -v /host/data:/data \ -e TOMATO_WEB_ADDR0.0.0.0:18423 \ -e TOMATO_WEB_PASSWORD你的密码 \ zhongbai233/tomato-novel-downloader-webui:latest --server --data-dir /datadocker ps里能看到容器在跑config.yml和logs都会落在/data下以后拉新镜像升级不会丢配置。musl 系统的设备把镜像 tag 换成latest-musl。从源码构建想改代码时git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader cd Tomato-Novel-Downloader cargo build --release编译完成后产物在target/release/目录里。第一次跑通搜索一本书并下载成 EPUB这节给你最短路径搜索 → 下载 → 打开成品文件。推荐先用 Web UI状态最直观。启动服务TomatoNovelDownloader --server默认监听127.0.0.1:18423浏览器打开这个地址就能看到搜索框和任务列表。然后做三步在搜索框输入书名或书 ID就是分享链接里那段长数字从搜索结果里选中要下载的书创建下载任务进度会实时刷新下载完成后EPUB 文件按config.yml里的保存路径落盘在 Web UI 的下载库里可以直接下载文件或把整个文件夹打包成 zip 带走。不用浏览器也行直接双击运行进 TUI用方向键和回车完成同样的操作视障用户或习惯纯键盘的首次启动时连按三下o再回车可以切到老 CLI 界面切换成功会响一声灯。三种界面怎么选TUI、Web UI 与老 CLI这节帮你一次说清三种界面的定位避免用错入口。界面启动方式适合场景TUI直接运行默认进入单机操作全键盘控制Web UI加--server参数局域网多设备、浏览器里管任务老 CLI首次启动连按三下oTermux 等环境里跑定时更新结论首次下载新书用 TUI 或 Web UI。CLI 已禁用新建下载它的--update只允许更新本地已有下载记录的书防止脚本批量滥用。两个常用输出EPUB 导出与 Edge TTS 有声书这节讲两个最值得配置的输出能力离线电子书和车载听书。EPUB 导出怎么配场景下载后想扔进 Kindle 或手机阅读器。把config.yml里的输出格式设为epub也支持txt、pdf、散装文件下载完成即得到带目录和封面的标准 EPUB用任意电子书阅读器打开。目录与排版由 src/book_parser/ 下的epub_generator.rs、html_utils.rs处理想调排版可以从这里入手。有声书生成怎么配场景通勤开车时听小说。在配置里开启是否生成有声小说其余保持默认即可默认发音人zh-CN-XiaoxiaoNeural语速、音量、音调都能调输出mp3或wav。生成完你会在{书名}_audio文件夹里看到按章节命名的音频如0001-第一章.mp3和封面图。重复运行时会跳过已存在的章节音频只补缺失部分。注意 Edge TTS 需要联网调用微软在线服务断网环境用不了。断点续传与失败重试怎么工作这节回答下载中途断了怎么办。下载进度会持久化保存任务中断断网、关机后重启程序或重新发起任务即可从断点继续不用整本重下。单个章节失败会走冷却重试机制重试次数和间隔由config.yml的max_retries与等待时间参数控制实现细节可以看 src/download/ 里的downloader.rs和cooldown_retry.rs。两个实用边界一批章节集中失败通常是接口限流或对方 API 变动等一会儿重试持续失败就到 Issues 里反馈不建议为提速大幅拉高并发既增加服务器压力也会更容易触发限流超过 1500 章的超长书下载失败概率偏高属正常情况。让它长期运行定时更新与资源控制这节帮你把追更多本书变成自动化的事。CLI 提供了非交互更新命令TomatoNovelDownloader --update 7318247498772674083它会直接开始更新指定书 ID无需任何输入只接受本地已有下载记录的书。在 crontab 里加一行0 2 * * * /path/to/TomatoNovelDownloader --update 7318...就能每天凌晨 2 点自动追更。Termux 上常用这种组合让手机浏览器直接访问TOMATO_WEB_ADDR0.0.0.0:18423 tomato-novel-downloader --server启动后手机本机访问127.0.0.1:18423同局域网的设备访问手机IP:18423。资源控制看三个参数max_workers章节并发数、max_retries重试次数、有声书并发数默认 24机器弱就调低。它们都写在config.yml里Web UI 的配置页也能在线改并写回文件。进阶与边界局域网部署、平台限制与合规这节集中说部署限制和使用边界。监听与密码锁TOMATO_WEB_ADDR可改成0.0.0.0:18423开放局域网访问多地址用逗号分隔如0.0.0.0:18423,[::]:18423。开放后建议加--password 你的密码上锁要暴露公网就先上反向代理 HTTPS并务必开密码锁。安卓限制仅 Termux 可运行且 Release 提供 arm64 产物小屏幕上 TUI 不友好推荐 Termux 起服务、浏览器操作。无 Official-API 构建拿不到官方 crate 的用户可用仓库里的Cargo_no_official.toml覆盖Cargo.toml再编译目录走网页解析、正文走第三方地址池代价是搜索和段评功能不可用。合规下载内容仅供个人阅读不要转载分发接口基于逆向 API哪天失效属正常风险遇到就尽快去 Issues 反馈。想继续往下走读代码从 src/main.rs 的分层注释入手下载引擎在 src/download/EPUB 与有声书生成在 src/book_parser/Web 路由在 src/ui/web/。排查问题时先看数据目录下的logs/日志再带着日志去提 Issue。【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考