番茄小说下载器：三合一解决方案打造专业级离线阅读体验

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

在数字化阅读时代，如何高效、稳定地获取网络小说内容成为众多读者的痛点。传统下载工具往往面临速度慢、格式单一、管理不便等挑战。基于Rust语言开发的番茄小说下载器，通过创新的三合一架构设计，为不同用户群体提供专业级的离线阅读解决方案。

多模式架构：满足不同场景需求

番茄小说下载器的核心优势在于其灵活的三种运行模式，每种模式针对特定使用场景进行了深度优化。

Web UI模式：可视化操作的最佳选择

对于追求便捷性的普通用户，Web UI模式提供了浏览器操作的完整体验。启动服务后，用户可以通过任何设备访问本地或局域网内的Web界面，实现搜索、下载、管理一体化操作。

# 启动Web UI服务 tomato-novel-downloader --server # 配置局域网访问和密码保护 TOMATO_WEB_ADDR=0.0.0.0:18423 TOMATO_WEB_PASSWORD=your_password tomato-novel-downloader --server

Web UI界面设计简洁直观，包含四个核心功能模块：

• 状态监控：实时显示系统运行状态和资源使用情况
• 搜索下载：支持关键词搜索和小说ID直接下载
• 任务管理：查看下载进度、暂停或取消任务
• 历史记录：按时间顺序展示所有下载记录

TUI模式：终端用户的专业之选

对于习惯命令行操作的技术用户，TUI（终端用户界面）模式提供了丰富的交互功能。通过方向键和快捷键，用户可以快速完成所有操作，无需离开终端环境。

# 启动TUI界面 tomato-novel-downloader # 启用老版本CLI界面（按三下o键） # 首次启动时按三下o键并回车

CLI模式：自动化脚本的理想搭档

开发者和自动化爱好者可以通过CLI模式将下载器集成到工作流中。虽然禁用了新建下载功能以防滥用，但更新本地已有小说的能力依然强大。

# 更新已下载的小说 tomato-novel-downloader --update 7318247498772674083 # 批量更新脚本示例 for book_dir in ./novels/*/; do if [ -d "$book_dir" ]; then book_id=$(basename "$book_dir") tomato-novel-downloader --update $book_id fi done

智能配置系统：从新手到专家的平滑过渡

配置文件是下载器的核心，位于程序运行目录的config.yml。系统采用智能合并策略，用户只需设置关注项，其余保持默认即可。

核心配置项详解

# 输出设置 output: directory: "./novels" # 输出目录，支持相对和绝对路径 format: "epub" # 输出格式：epub/txt/pdf/bulk_txt keep_temp_files: false # 是否保留临时文件便于调试 # 下载设置 download: max_workers: 4 # 并发线程数（1-10，建议2-4） timeout_seconds: 30 # 请求超时时间 retry_count: 3 # 失败重试次数 use_official_api: true # 是否使用官方API # 音频生成设置 tts: enabled: false # 是否启用有声小说生成 voice: "zh-CN-XiaoxiaoNeural" # 语音选择 format: "mp3" # 音频格式：mp3或wav concurrency: 24 # TTS并发任务数

性能优化配置方案

针对不同网络环境和硬件配置，推荐以下优化方案：

高级功能深度解析

有声小说生成：文字转语音的革命

Edge TTS集成是番茄小说下载器的特色功能之一。启用后，每章小说下载完成时，系统会自动调用微软的语音合成服务生成对应的音频文件。

# 有声小说配置示例 tts: enabled: true voice: "zh-CN-XiaoxiaoNeural" # 支持多种中文语音 rate: "+10%" # 语速调节 volume: "+5%" # 音量调节 pitch: "+2Hz" # 音调调节

音频文件按章节顺序命名，保存在{书名}_audio目录中。已存在的音频文件会自动跳过，支持断点续传。对于有声书创作者，这提供了高效的素材准备方案。

双API架构：稳定与效率的平衡

下载器采用独特的双API架构，通过official-api和no-official-api两种构建模式，确保在不同环境下都能稳定运行。

默认模式（official-api）：

• 支持搜索功能和段评获取
• 可通过配置切换官方/第三方API获取正文
• 功能最完整，推荐大多数用户使用

无官方API模式（no-official-api）：

• 不依赖官方API crate，编译要求低
• 目录和书籍信息通过网页解析获取
• 正文强制使用第三方API地址池
• 适合无法获取官方API环境的用户

构建模式切换方法：

# 切换到无官方API模式 cp Cargo_no_official.toml Cargo.toml cargo build --release # 返回默认模式 git checkout Cargo.toml cargo build --release

媒体资源智能处理

下载器不仅能获取文字内容，还能智能处理小说中的图片资源：

1. 图片下载：自动下载章节中的插图、评论图片和用户头像
2. 格式转换：支持HEIC转JPEG，确保兼容性
3. 尺寸优化：自动调整图片尺寸，减少文件体积
4. 域名过滤：可配置屏蔽特定域名的图片下载

部署方案：从个人到团队的完整生态

Docker容器化部署

针对团队协作和服务器环境，下载器提供完整的Docker支持：

# 标准服务器环境（glibc版本） 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=your_password \ zhongbai233/tomato-novel-downloader-webui:latest \ --server --data-dir /data # 轻量级系统（musl版本） 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=your_password \ zhongbai233/tomato-novel-downloader-webui:latest-musl \ --server --data-dir /data

多平台兼容性

下载器支持Windows、Linux、macOS三大主流操作系统，甚至在Android设备的Termux环境中也能完美运行：

Android Termux部署流程：

1. 安装Termux和Termux:API
2. 运行一键安装脚本：bash <(curl -sL https://dl.zhongbai233.com/installer.sh)
3. 启动Web UI服务：TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server
4. 通过浏览器访问：http://手机IP:18423

故障排除与优化指南

常见问题解决方案

下载速度慢：

1. 检查网络连接，确保带宽充足
2. 适当降低max_workers值（建议2-4）
3. 避开网络高峰期下载

章节内容缺失：

1. 更新到最新版本：git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
2. 尝试切换API模式：修改use_official_api配置
3. 使用--clean-html参数清理HTML格式

格式转换失败：

1. 检查磁盘空间是否充足
2. 尝试使用TXT格式测试基础功能
3. 查看日志文件获取详细错误信息

性能监控与日志分析

启用调试日志可帮助诊断复杂问题：

# 启用详细日志输出 RUST_LOG=debug tomato-novel-downloader --book-id YOUR_ID > debug.log 2>&1 # 查看实时日志 tail -f logs/tomato-novel-downloader.log

日志文件包含以下关键信息：

• 网络请求状态和耗时
• 章节下载进度和成功率
• 格式转换过程中的警告和错误
• 资源下载和处理的详细信息

安全与合规使用建议

合理使用原则

1. 个人使用限制：下载的小说仅限个人阅读，不得用于商业用途或二次分发
2. 版权尊重：阅读完成后建议删除文件，避免侵权风险
3. 服务器友好：不要设置过高并发数，避免对源服务器造成过大压力
4. 合规操作：严格遵守目标网站的服务条款和使用协议

安全配置建议

对于公网部署的Web UI，务必采取以下安全措施：

• 启用密码保护：--password your_password
• 配置反向代理和HTTPS
• 限制访问IP范围
• 定期更新到最新版本

未来发展方向

番茄小说下载器作为开源项目，持续关注用户需求和技术发展。未来版本计划引入更多创新功能：

1. 云同步支持：多设备间阅读进度和书签同步
2. 智能推荐系统：基于阅读历史推荐相关小说
3. 插件扩展机制：支持第三方插件扩展功能
4. 移动端优化：专门为移动设备优化的界面和操作

快速开始指南

源码编译安装

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader cd Tomato-Novel-Downloader # 安装Rust环境（如未安装） curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 编译发布版本 cargo build --release # 启动Web UI服务 ./target/release/tomato-novel-downloader --server

一键脚本安装

# Linux/macOS一键安装 bash <(curl -sL https://dl.zhongbai233.com/installer.sh) # 国内镜像加速 bash <(curl -sL https://ghproxy.com/https://raw.githubusercontent.com/zhongbai2333/Tomato-Novel-Downloader/main/installer.sh)

无论您是技术爱好者、普通读者还是有声书创作者，番茄小说下载器都能提供稳定、高效的解决方案。通过合理的配置和使用，您可以轻松构建个性化的离线阅读系统，享受无干扰的阅读体验。

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