番茄小说下载器：三步实现离线阅读与有声书生成
番茄小说下载器：三步实现离线阅读与有声书生成
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
你是否曾因网络不稳定而无法畅快阅读喜爱的小说？是否希望在通勤路上将文字转为音频收听？番茄小说下载器正是为解决这些痛点而生的开源工具。这款基于Rust语言开发的跨平台应用，支持Windows、Linux、macOS和Android系统，提供Web UI界面和音频生成功能，让小说下载与格式转换变得前所未有的简单。
🎯 为什么选择番茄小说下载器？
传统小说下载工具往往存在操作复杂、功能单一、平台限制等问题。番茄小说下载器通过以下优势解决了这些痛点：
| 传统工具痛点 | 番茄小说下载器解决方案 |
|---|---|
| 命令行操作复杂 | 提供Web UI图形界面，浏览器即可操作 |
| 单一格式输出 | 支持EPUB、TXT、PDF和音频四种格式 |
| 仅限桌面端 | 跨平台支持，包括安卓Termux |
| 无有声书功能 | 内置Edge TTS，自动生成MP3/WAV音频 |
| 配置繁琐 | 一键安装脚本，开箱即用 |
图：番茄小说下载器核心功能示意图，展示了从网络请求到多格式输出的完整流程
🚀 三步快速上手指南
第一步：获取程序（5分钟完成）
根据你的操作系统选择最适合的安装方式：
桌面用户（Windows/Linux/macOS）
# 使用一键安装脚本 bash <(curl -sL https://dl.zhongbai233.com/installer.sh)移动用户（Android Termux）
- 安装Termux应用
- 运行部署脚本：
bash <(curl -sL https://dl.zhongbai233.com/installer.sh)
服务器用户（Docker部署）
docker run -d \ --name tomato-novel-webui \ -p 18423:18423 \ -v /host/data:/data \ -e TOMATO_WEB_ADDR=0.0.0.0:18423 \ zhongbai233/tomato-novel-downloader-webui:latest \ --server --data-dir /data第二步：选择操作界面（3分钟配置）
番茄小说下载器提供三种界面，满足不同用户需求：
Web UI模式（推荐新手）
TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server在浏览器打开http://127.0.0.1:18423即可开始使用。
TUI终端界面（技术用户）直接运行程序，使用键盘方向键和回车键操作。
CLI命令行模式（自动化）
tomato-novel-downloader --update <book_id>第三步：开始下载小说（2分钟完成）
- 搜索书籍：在Web UI或TUI中输入书名或作者名
- 选择格式：EPUB（电子书）、TXT（纯文本）、PDF（打印版）或音频
- 开始下载：点击下载按钮，等待完成
🛠️ 核心功能深度解析
智能下载引擎：稳定高效的小说获取
番茄小说下载器的下载引擎在 src/download/ 中实现，采用双模式策略确保在各种环境下都能稳定工作：
默认模式（official-api）
- 支持完整搜索功能
- 可获取章节段评内容
- 正文可在官方API和第三方API间切换
无官方API模式（no-official-api）
- 不依赖官方API库
- 目录和书籍信息通过网页解析获取
- 正文强制使用第三方API地址池
智能重试机制在 src/base_system/cooldown_retry.rs 中实现：
- 网络超时：指数退避重试（1s、2s、4s...）
- 服务器繁忙：延长重试间隔（5s、10s、20s...）
- 内容不存在：立即终止并提示用户
有声书生成：文字转语音的完美体验
从版本2.4.13开始，程序内置了微软Edge TTS语音合成功能，可在下载文本后自动生成对应的有声小说：
配置步骤：
- 在配置菜单中启用"是否生成有声小说"
- 选择发音人（默认
zh-CN-XiaoxiaoNeural） - 调整语速、音量和音调
- 选择输出格式（MP3或WAV）
音频文件组织结构：
下载目录/ ├── 《书名》.epub └── 《书名》_audio/ ├── 0001-第一章.mp3 ├── 0002-第二章.mp3 ├── ... └── cover.jpg（如果有封面）性能优化：
- 可调整Edge TTS并发任务数量（默认24个）
- 断点续跑时自动跳过已生成的章节
- 支持Hz格式的音调调整，如
+2Hz、-10Hz
多格式输出：满足不同阅读场景
| 格式 | 优点 | 适用设备 | 生成模块 |
|---|---|---|---|
| EPUB | 支持目录导航、元数据完整 | 电子阅读器、手机 | src/book_parser/epub_generator.rs |
| TXT | 纯文本、体积小、兼容性好 | 所有文本编辑器 | src/book_parser/parser.rs |
| 固定布局、适合打印和归档 | 打印机、PDF阅读器 | src/book_parser/finalize_pdf.rs | |
| 音频 | 支持有声书收听 | 手机、MP3播放器 | src/book_parser/audio_generator.rs |
📱 多平台部署方案对比
个人使用场景
桌面端（Windows/macOS/Linux）
- 安装方式：一键安装脚本或直接下载可执行文件
- 启动命令：
tomato-novel-downloader或tomato-novel-downloader --server - 优势：性能最佳，功能完整
移动端（Android Termux）
- 安装方式：Termux中运行安装脚本
- 启动命令：
TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server - 访问方式：浏览器打开
http://127.0.0.1:18423 - 优势：随身携带，随时随地下载
家庭共享场景
Docker容器化部署
# 常规服务器环境 docker run -d \ --name tomato-novel-webui \ -p 18423:18423 \ -v /host/data:/data \ -e TOMATO_WEB_ADDR=0.0.0.0:18423 \ zhongbai233/tomato-novel-downloader-webui:latest \ --server --data-dir /data # 软路由/NAS轻量系统（musl版本） docker run -d \ --name tomato-novel-webui \ -p 18423:18423 \ -v /host/data:/data \ -e TOMATO_WEB_ADDR=0.0.0.0:18423 \ zhongbai233/tomato-novel-downloader-webui:latest-musl \ --server --data-dir /data优势：
- 24小时不间断运行
- 多设备共享访问
- 数据持久化存储
- 资源隔离，安全稳定
使用场景矩阵
| 用户类型 | 推荐部署方式 | 访问方式 | 最佳功能 |
|---|---|---|---|
| 个人用户 | 桌面端直接运行 | TUI或Web UI | 有声书生成 |
| 家庭共享 | Docker容器化 | Web UI（多设备） | 集中管理 |
| 技术爱好者 | 源码编译 | CLI命令行 | 自动化脚本 |
| 移动用户 | Android Termux | Web UI（手机浏览器） | 便携下载 |
⚙️ 高级配置与优化技巧
性能调优指南
根据硬件配置调整参数，获得最佳性能：
| 硬件配置 | 推荐并发数 | 内存占用 | 适用场景 |
|---|---|---|---|
| 低配设备（2核1G） | 2-3线程 | 30-50MB | 个人使用 |
| 中等设备（4核2G） | 4-6线程 | 50-80MB | 家庭共享 |
| 高性能设备（8核4G+） | 8-10线程 | 80-150MB | 多人使用 |
配置文件位置：config.yml（首次运行自动生成）
关键配置项：
# 下载设置 download: max_concurrent_tasks: 4 # 最大并发任务数 retry_times: 3 # 重试次数 # 音频生成设置 tts: enabled: true # 启用有声书生成 voice: "zh-CN-XiaoxiaoNeural" # 发音人 format: "mp3" # 音频格式 concurrency: 2 # TTS并发数安全配置建议
密码保护机制防止未授权访问：
# 启动时设置密码 tomato-novel-downloader --server --password 你的密码 # 或使用环境变量 TOMATO_WEB_PASSWORD=你的密码 tomato-novel-downloader --server数据目录配置实现持久化存储：
tomato-novel-downloader --server --data-dir /path/to/data公网部署注意事项：
- 务必开启密码保护
- 建议使用反向代理（如Nginx）提供HTTPS
- 定期更新到最新版本
- 监控日志文件 logs/ 中的异常情况
🔧 常见问题与解决方案
Web UI无法访问怎么办？
排查步骤：
- 检查服务是否运行：
docker ps或ps aux | grep tomato - 验证端口监听：
netstat -tlnp | grep 18423 - 查看日志信息：
docker logs tomato-novel-webui或查看logs/目录 - 检查防火墙设置：确保18423端口开放
常见原因：
- 端口被占用：修改
TOMATO_WEB_ADDR环境变量 - 权限问题：确保有足够的读写权限
- 网络配置：检查IP绑定设置
下载任务失败如何处理？
错误类型与解决方案：
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 连接超时 | 网络不稳定 | 检查网络连接，稍后重试 |
| API限制 | 调用频率过高 | 降低并发数，等待冷却 |
| 书籍不存在 | 书籍ID错误 | 重新搜索获取正确ID |
| 内容解析失败 | 网页结构变化 | 更新到最新版本 |
调试模式：
tomato-novel-downloader --debug启用调试模式查看详细日志信息。
音频生成失败怎么办？
检查清单：
- 网络连接：确保可以访问微软TTS服务
- 并发设置：降低TTS并发数（默认24可能过高）
- 发音人配置：检查发音人名称是否正确
- 磁盘空间：确保有足够的存储空间
日志分析： 查看 src/book_parser/edge_tts.rs 相关错误日志，通常包含详细的错误信息。
🚫 常见误区与避坑指南
误区一：线程数越多下载越快
事实：过多的线程数会导致服务器压力过大，可能触发反爬机制，反而降低成功率。
建议：保持默认的并发设置（4-6个任务），不要随意调高。
误区二：可以下载所有小说
限制：程序依赖API接口，某些特殊内容可能无法获取。
建议：如果遇到下载失败，尝试以下方法：
- 检查书籍ID是否正确
- 尝试使用不同的API模式
- 等待一段时间后重试
误区三：音频生成质量与网速无关
事实：Edge TTS需要稳定的网络连接，网络波动可能导致音频生成失败或质量下降。
建议：在网络稳定的环境下生成有声书，或分批生成。
误区四：Docker部署不需要数据持久化
风险：容器重启后所有下载记录和配置都会丢失。
解决方案：务必使用-v /host/data:/data挂载数据卷。
🔮 未来发展方向与社区参与
近期开发计划
插件系统规划计划引入WebAssembly插件系统，允许第三方开发者扩展：
- 新的输出格式转换器
- 自定义元数据处理器
- 第三方TTS服务集成
移动端优化开发更适合移动设备的界面优化：
- 响应式Web UI设计
- 移动端专用操作流程
- 离线阅读支持
如何参与贡献
番茄小说下载器是一个开源项目，欢迎社区参与：
代码贡献：
- Fork项目仓库：
git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader - 创建功能分支
- 提交Pull Request
问题反馈：
- 在Issues页面报告问题
- 提供详细的复现步骤
- 附上相关日志信息
功能建议：
- 描述具体的使用场景
- 说明期望的功能效果
- 讨论技术实现方案
项目架构演进
当前架构优势：
- 模块化设计，便于维护和扩展
- Rust语言保证内存安全和性能
- 多界面支持，适应不同用户群体
未来改进方向：
- 更完善的错误处理机制
- 更丰富的配置选项
- 更好的国际化支持
📝 总结与开始行动
番茄小说下载器通过其强大的多平台支持、灵活的部署方式和丰富的功能特性，为小说爱好者提供了完整的数字阅读解决方案。无论你是个人用户还是技术爱好者，都能找到适合自己的使用方式。
立即开始：
- 选择适合你的安装方式
- 启动程序并配置基本设置
- 搜索并下载第一本小说
- 体验有声书生成功能
最佳实践：
- 个人使用：桌面端直接运行，体验完整功能
- 家庭共享：Docker部署，多设备访问
- 移动场景：Android Termux + Web UI组合
记住，技术的价值在于解决实际问题。番茄小说下载器不仅是一个工具，更是连接文字与声音、在线与离线的桥梁。开始你的智能阅读之旅吧！
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考