番茄小说下载器：3分钟搞定离线阅读与有声小说生成的终极指南

番茄小说下载器：3分钟搞定离线阅读与有声小说生成的终极指南

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

番茄小说下载器是一款基于Rust开发的开源工具，能够将番茄小说平台上的小说内容下载到本地，并支持转换为EPUB电子书格式或生成有声小说音频。无论你是想在无网络环境下阅读，还是想在通勤路上听小说，这个工具都能帮你轻松实现。它提供了三种操作界面：Web UI网页界面、TUI终端界面和NOUI无界面模式，满足不同用户的需求。

📱 手机用户的福音：随时随地离线听小说

对于手机用户来说，番茄小说下载器的Web UI模式是最佳选择。你可以直接在Android设备上运行，然后通过浏览器访问，无需复杂的命令行操作。

安卓手机快速部署

在Termux中运行以下命令即可完成部署：

bash <(curl -sL https://dl.zhongbai233.com/installer.sh) TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server

启动后，在手机浏览器中访问http://127.0.0.1:18423就能看到简洁的Web界面。如果你想让同一局域网的其他设备也能访问，只需将地址改为手机的局域网IP即可。

手机端使用技巧

• 搜索小说：直接在Web界面搜索框输入书名，无需手动查找小说ID
• 一键下载：选择小说后点击下载，程序会自动处理所有章节
• 音频生成：在配置中开启"有声小说生成"功能，下载完成后自动生成MP3音频文件

💻 电脑用户的完整解决方案

对于Windows、MacOS和Linux用户，番茄小说下载器提供了更丰富的功能选择。

一键安装与启动

根据你的系统选择相应的安装方式：

Windows用户：直接下载Release中的exe文件，双击运行即可启动TUI界面。

MacOS/Linux用户：

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

三种界面模式对比

快速转换EPUB电子书

将番茄小说转换为EPUB格式非常简单：

1. 在Web UI中搜索并选择要下载的小说
2. 输出格式选择EPUB
3. 点击开始下载

转换后的EPUB文件包含完整的章节目录、封面图片和统一的阅读样式，可以在Kindle、iPad、手机等任何支持EPUB的阅读器上打开。

🎧 有声小说生成：让眼睛休息，用耳朵"阅读"

番茄小说下载器内置了微软Edge TTS语音合成功能，可以将文本内容转换为自然流畅的语音，这对于以下场景特别有用：

• 通勤路上听小说
• 做家务时享受阅读
• 视力不佳的用户
• 想要多任务处理的读者

音频配置指南

在配置文件中（config.yml），你可以调整以下参数：

audio_config: voice: "zh-CN-XiaoxiaoNeural" # 发音人 rate: "+0%" # 语速 volume: "+0%" # 音量 pitch: "+0Hz" # 音调 format: "mp3" # 输出格式

音频生成小贴士

• 并发数控制：在配置中调整"有声小说并发数"，默认2个任务同时生成
• 网络要求：Edge TTS需要联网调用微软服务，确保网络畅通
• 文件组织：音频文件保存在{书名}_audio文件夹中，按章节顺序命名

🐳 Docker部署：专业用户的服务器方案

如果你希望在服务器或NAS上长期运行番茄小说下载器，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系统：

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

Docker部署优势

• 环境隔离：避免依赖冲突
• 一键部署：简化安装过程
• 便于迁移：容器化部署，轻松备份和迁移
• 多架构支持：支持x86_64和ARM架构

🔧 高级配置与优化技巧

配置文件详解

配置文件位于数据目录的config.yml，主要配置项包括：

• 默认保存路径：设置下载文件的存储位置
• 最大并发下载数：建议设置为2-5，避免对服务器造成过大压力
• API模式选择：可在官方API和第三方API之间切换
• 音频生成开关：控制是否自动生成有声小说

环境变量配置

通过环境变量可以灵活调整程序行为：

# 修改Web UI监听地址 TOMATO_WEB_ADDR=0.0.0.0:18423 # 设置访问密码 TOMATO_WEB_PASSWORD=mypassword123 # 调整日志级别 RUST_LOG=info

模块化架构优势

番茄小说下载器采用模块化设计，代码结构清晰：

• src/base_system/：基础系统模块（配置、日志、更新检查）
• src/book_parser/：书籍解析和格式转换模块
• src/download/：下载引擎和任务管理
• src/ui/web/：Web界面实现
• src/ui/tui/：终端界面实现
• src/ui/noui/：无界面模式实现

🚀 自动化更新：定时获取最新章节

对于追更的用户，NOUI模式提供了自动化更新功能。你可以设置定时任务，自动检查并下载最新章节。

自动化脚本示例

# 每天凌晨2点自动更新指定小说 0 2 * * * /path/to/tomato-novel-downloader --update 7318247498772674083

注意事项

• NOUI模式仅支持更新已下载过的小说
• 首次下载新书需要使用Web UI或TUI界面
• 建议合理设置更新频率，避免对服务器造成压力

📊 常见问题与解决方案

下载失败怎么办？

1. 检查网络连接：确保网络畅通
2. 验证小说ID：确认输入的小说ID正确
3. 查看日志：检查日志文件中的错误信息
4. 切换API模式：尝试修改use_official_api配置

EPUB文件显示异常

1. 使用专业阅读器：推荐使用Calibre打开EPUB文件
2. 检查格式支持：确保阅读器支持EPUB3格式
3. 重新生成：尝试重新下载并转换

内存占用过高

1. 分批下载：对于超长小说，建议分批次下载
2. 调整参数：修改src/download/segment_pool.rs中的相关参数
3. 确保足够内存：为程序分配足够的内存空间

🔒 安全使用指南

合理使用原则

1. 个人使用：下载的小说仅供个人阅读使用
2. 尊重版权：支持正版阅读，尊重作者劳动成果
3. 控制频率：合理控制下载频率，避免给服务器带来压力
4. 禁止传播：不要将下载内容用于商业用途或传播

内置保护机制

项目内置了完善的保护机制（位于src/base_system/cooldown_retry.rs）：

• 速率限制，防止过度请求
• 错误重试机制，提高成功率
• 智能排队系统，优化资源使用

🎯 开始你的离线阅读之旅

现在，你已经掌握了番茄小说下载器的完整使用方法。无论你是想在手机端随时随地听小说，还是在电脑端建立个人数字图书馆，这个工具都能为你提供便捷的解决方案。

立即行动步骤：

1. 克隆项目到本地：git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
2. 选择适合你的安装方式
3. 启动服务，开始下载第一本小说
4. 享受随时随地的阅读体验

记住，技术是为了让生活更美好。合理使用工具，享受阅读的乐趣，同时也要尊重创作者的劳动成果。Happy reading！📚

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