番茄小说下载器：三步实现离线阅读与有声书生成

番茄小说下载器：三步实现离线阅读与有声书生成

【免费下载链接】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）

  1. 安装Termux应用
  2. 运行部署脚本：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分钟完成）

  1. 搜索书籍：在Web UI或TUI中输入书名或作者名
  2. 选择格式：EPUB（电子书）、TXT（纯文本）、PDF（打印版）或音频
  3. 开始下载：点击下载按钮，等待完成

🛠️ 核心功能深度解析

智能下载引擎：稳定高效的小说获取

番茄小说下载器的下载引擎在 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语音合成功能，可在下载文本后自动生成对应的有声小说：

配置步骤：

  1. 在配置菜单中启用"是否生成有声小说"
  2. 选择发音人（默认zh-CN-XiaoxiaoNeural）
  3. 调整语速、音量和音调
  4. 选择输出格式（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固定布局、适合打印和归档打印机、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 TermuxWeb 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

公网部署注意事项：

  1. 务必开启密码保护
  2. 建议使用反向代理（如Nginx）提供HTTPS
  3. 定期更新到最新版本
  4. 监控日志文件 logs/ 中的异常情况

🔧 常见问题与解决方案

Web UI无法访问怎么办？

排查步骤：

  1. 检查服务是否运行：docker ps或ps aux | grep tomato
  2. 验证端口监听：netstat -tlnp | grep 18423
  3. 查看日志信息：docker logs tomato-novel-webui或查看logs/目录
  4. 检查防火墙设置：确保18423端口开放

常见原因：

  • 端口被占用：修改TOMATO_WEB_ADDR环境变量
  • 权限问题：确保有足够的读写权限
  • 网络配置：检查IP绑定设置

下载任务失败如何处理？

错误类型与解决方案：

错误现象可能原因解决方案
连接超时网络不稳定检查网络连接，稍后重试
API限制调用频率过高降低并发数，等待冷却
书籍不存在书籍ID错误重新搜索获取正确ID
内容解析失败网页结构变化更新到最新版本

调试模式：

tomato-novel-downloader --debug

启用调试模式查看详细日志信息。

音频生成失败怎么办？

检查清单：

  1. 网络连接：确保可以访问微软TTS服务
  2. 并发设置：降低TTS并发数（默认24可能过高）
  3. 发音人配置：检查发音人名称是否正确
  4. 磁盘空间：确保有足够的存储空间

日志分析： 查看 src/book_parser/edge_tts.rs 相关错误日志，通常包含详细的错误信息。

🚫 常见误区与避坑指南

误区一：线程数越多下载越快

事实：过多的线程数会导致服务器压力过大，可能触发反爬机制，反而降低成功率。

建议：保持默认的并发设置（4-6个任务），不要随意调高。

误区二：可以下载所有小说

限制：程序依赖API接口，某些特殊内容可能无法获取。

建议：如果遇到下载失败，尝试以下方法：

  1. 检查书籍ID是否正确
  2. 尝试使用不同的API模式
  3. 等待一段时间后重试

误区三：音频生成质量与网速无关

事实：Edge TTS需要稳定的网络连接，网络波动可能导致音频生成失败或质量下降。

建议：在网络稳定的环境下生成有声书，或分批生成。

误区四：Docker部署不需要数据持久化

风险：容器重启后所有下载记录和配置都会丢失。

解决方案：务必使用-v /host/data:/data挂载数据卷。

🔮 未来发展方向与社区参与

近期开发计划

插件系统规划计划引入WebAssembly插件系统，允许第三方开发者扩展：

  • 新的输出格式转换器
  • 自定义元数据处理器
  • 第三方TTS服务集成

移动端优化开发更适合移动设备的界面优化：

  • 响应式Web UI设计
  • 移动端专用操作流程
  • 离线阅读支持

如何参与贡献

番茄小说下载器是一个开源项目，欢迎社区参与：

代码贡献：

  1. Fork项目仓库：git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
  2. 创建功能分支
  3. 提交Pull Request

问题反馈：

  1. 在Issues页面报告问题
  2. 提供详细的复现步骤
  3. 附上相关日志信息

功能建议：

  1. 描述具体的使用场景
  2. 说明期望的功能效果
  3. 讨论技术实现方案

项目架构演进

当前架构优势：

  • 模块化设计，便于维护和扩展
  • Rust语言保证内存安全和性能
  • 多界面支持，适应不同用户群体

未来改进方向：

  • 更完善的错误处理机制
  • 更丰富的配置选项
  • 更好的国际化支持

📝 总结与开始行动

番茄小说下载器通过其强大的多平台支持、灵活的部署方式和丰富的功能特性，为小说爱好者提供了完整的数字阅读解决方案。无论你是个人用户还是技术爱好者，都能找到适合自己的使用方式。

立即开始：

  1. 选择适合你的安装方式
  2. 启动程序并配置基本设置
  3. 搜索并下载第一本小说
  4. 体验有声书生成功能

最佳实践：

  • 个人使用：桌面端直接运行，体验完整功能
  • 家庭共享：Docker部署，多设备访问
  • 移动场景：Android Termux + Web UI组合

记住，技术的价值在于解决实际问题。番茄小说下载器不仅是一个工具，更是连接文字与声音、在线与离线的桥梁。开始你的智能阅读之旅吧！

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考