番茄小说下载器：3种方式打造个人离线图书馆，告别网络限制

番茄小说下载器：3种方式打造个人离线图书馆，告别网络限制

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

你是否遇到过这样的困扰：在番茄小说上看到精彩章节，却因网络不稳定无法继续阅读？或是想在地铁、飞机上享受阅读，却受限于平台限制？Tomato-Novel-Downloader 正是为解决这些问题而生。这款基于 Rust 开发的开源下载工具，能够将番茄小说内容高效下载到本地，支持 EPUB 电子书和有声小说生成，让你随时随地享受无限制的阅读乐趣。

为什么你需要一个专业的番茄小说下载器？

在数字阅读时代，我们常常面临以下几个痛点：

1. 网络依赖：没有网络就无法阅读已缓存的内容
2. 平台限制：阅读时长受限，需要等待或付费
3. 格式混乱：手动保存的章节零散，缺乏统一管理
4. 跨设备同步：不同设备间阅读进度无法同步
5. 听觉需求：想要听书却没有合适的音频版本

Tomato-Novel-Downloader 通过以下核心优势解决这些痛点：

• 全平台支持：Windows、Linux、macOS、Android（Termux）全覆盖
• 多格式输出：支持 TXT、EPUB 电子书格式，可自动生成有声小说
• 智能下载：断点续传、错误重试、并发控制确保稳定下载
• 三种操作界面：Web UI、TUI 终端界面、NOUI 脚本模式满足不同需求

3种使用方式：总有一款适合你

Web UI：图形化操作的便捷选择

对于大多数用户来说，Web UI 是最友好的选择。它提供完整的图形化操作体验，特别适合新手用户：

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

Web UI 核心功能：

• 智能搜索：直接输入小说名称搜索，无需手动查找 ID
• 任务管理：实时查看下载进度，支持暂停和取消操作
• 文件浏览：按目录结构浏览已下载的文件
• 一键打包：将文件夹打包为 ZIP 下载，保持目录结构
• 在线配置：修改下载设置并自动保存到 config.yml

TUI 终端界面：键盘操作的高效方案

如果你习惯命令行操作，TUI 界面提供简洁高效的键盘操作体验：

# 启动 TUI 界面（默认模式） ./tomato-novel-downloader

TUI 界面特点：

• 全键盘导航，无需鼠标操作
• 实时进度显示和状态更新
• 支持剪贴板粘贴操作
• 配置热键快速切换功能

启用老版本 CLI 界面：在第一次打开程序时，按三下o键并回车，或者按一下下方向键并按三下o键，都可以启用老版本 CLI 界面。

NOUI 无界面模式：自动化脚本集成

对于需要自动化处理的场景，NOUI 模式提供脚本调用接口：

# 自动更新已下载的小说 ./tomato-novel-downloader --update 7318247498772674083

NOUI 模式使用场景：

• 配合定时任务使用，实现自动更新已下载的小说内容
• 集成到自动化工作流中
• 批量处理多个小说更新

配置系统详解：个性化你的下载体验

Tomato-Novel-Downloader 的配置系统位于src/base_system/config.rs，支持智能合并用户配置和默认值。配置文件config.yml会自动生成并包含详细注释。

核心配置项说明

配置文件示例

# 网络配置 max_workers: 3 request_timeout: 30 max_retries: 3 # 保存配置 novel_format: "epub" save_path: "./downloads" # 音频生成配置 enable_audiobook: false audiobook_voice: "zh-CN-XiaoxiaoNeural" audiobook_concurrency: 2 audiobook_format: "mp3" # API 配置 use_official_api: true api_endpoints: []

EPUB 电子书生成：打造专业数字图书馆

为什么选择 EPUB 格式？

EPUB 是目前最流行的电子书格式，具有以下优势：

1. 自适应排版：根据阅读设备自动调整文字大小和版式
2. 跨平台兼容：支持 Kindle、iPad、手机等所有主流阅读器
3. 完整结构：保留章节、目录、封面等完整书籍结构
4. 样式丰富：支持 CSS 样式定义，提供统一的阅读体验

EPUB 生成流程

Tomato-Novel-Downloader 的 EPUB 生成流程非常完善：

1. 内容提取：通过src/network_parser/network.rs模块解析网页内容
2. 章节处理：src/book_parser/parser.rs负责章节分割和清理
3. 格式转换：src/book_parser/epub_generator.rs生成标准 EPUB 文件
4. 资源嵌入：src/book_parser/image_utils.rs处理图片和封面
5. 最终封装：src/book_parser/finalize_epub.rs完成 EPUB 打包

自定义样式配置

通过修改配置文件，可以自定义 EPUB 的显示样式：

# 段落首行缩进（单位：em） first_line_indent_em: 2.0 # 图片处理配置 force_convert_images_to_jpeg: false jpeg_quality: 85 media_max_dimension_px: 1200

有声小说生成：Edge TTS 技术集成

音频生成技术原理

Tomato-Novel-Downloader 集成了微软 Edge TTS 语音合成技术，位于src/book_parser/edge_tts.rs模块。通过配置enable_audiobook: true即可启用音频生成功能。

音频配置优化建议

音频文件输出结构

downloads/ ├── 小说名称/ │ ├── 小说名称.epub │ └── 小说名称_audio/ │ ├── 0001-第一章.mp3 │ ├── 0002-第二章.mp3 │ └── ...

Docker 容器化部署方案

常规服务器部署

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

轻量系统部署（软路由/NAS）

对于使用 musl libc 的轻量系统，使用 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

数据持久化策略

通过--data-dir参数指定数据目录，确保配置和日志的持久化：

• config.yml：程序配置文件
• logs/：运行日志目录
• downloads/：下载文件存储目录

安卓设备部署指南

Termux 环境配置

1. 安装 Termux：从 F-Droid 或 GitHub Releases 下载
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

访问方式

• 本机访问：http://127.0.0.1:18423
• 局域网访问：http://<手机IP>:18423

剪贴板支持配置

在 Termux 中使用 TUI 界面时，如需粘贴内容：

# 安装 Termux API pkg install termux-api # 验证安装 termux-clipboard-get

构建模式选择

项目提供两种构建模式，位于Cargo.toml的 features 配置中：

默认模式（official-api）

cargo build --release

特点：

• 支持搜索功能
• 支持段评抓取
• 可在官方/第三方 API 间切换

No-Official-API 模式

# Linux/macOS cp Cargo_no_official.toml Cargo.toml cargo build --release # Windows copy /Y Cargo_no_official.toml Cargo.toml cargo build --release

特点：

• 不依赖官方 API crate
• 强制使用第三方 API 获取正文
• 适用于无法访问官方 API 的环境

故障排查与最佳实践

常见问题解决

下载速度慢：

• 检查网络连接状态
• 调整max_workers并发数
• 考虑使用第三方 API 模式

EPUB 文件无法打开：

• 使用专业阅读器如 Calibre
• 检查 EPUB 版本兼容性
• 重新生成 EPUB 文件

音频生成失败：

• 确认网络可访问微软 TTS 服务
• 降低audiobook_concurrency并发数
• 检查磁盘空间是否充足

内存占用过高：

• 分批次下载超长小说
• 调整src/download/segment_pool.rs中的参数
• 确保系统有足够可用内存

性能优化建议

1. 网络请求优化：

   max_workers: 3 # 并发数不宜过高 request_timeout: 30 # 适当延长超时时间 max_retries: 3 # 重试次数 min_wait_time: 1000 # 最小等待时间（毫秒） max_wait_time: 5000 # 最大等待时间（毫秒）

2. 日志系统使用：

   # 设置日志级别 RUST_LOG=info ./tomato-novel-downloader --server RUST_LOG=debug ./tomato-novel-downloader --server # 详细调试信息

安全使用与合规建议

合理使用原则

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

内置保护机制

项目内置了完善的保护机制：

• 速率限制：防止过度请求目标服务器
• 错误重试：智能重试机制提高成功率
• 智能排队：优化资源使用，避免并发过高

快速开始指南

获取项目源码

git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader cd Tomato-Novel-Downloader

一键安装脚本

# 使用安装脚本 ./installer.sh # 或手动构建 cargo build --release

首次使用建议

1. 启动 Web UI：./tomato-novel-downloader --server
2. 浏览器访问：http://localhost:18423
3. 搜索小说：在搜索框中输入小说名称
4. 开始下载：选择输出格式和保存路径
5. 享受阅读：下载完成后在本地阅读器打开

结语：打造个性化的阅读体验

Tomato-Novel-Downloader 不仅是一个简单的下载工具，更是一个完整的离线阅读解决方案。通过合理配置和使用，你可以：

• 建立个人数字图书馆：将喜爱的小说保存为 EPUB 格式，随时重温
• 实现通勤听书：利用音频生成功能，在通勤路上听小说
• 跨设备同步：通过 Docker 部署，实现多设备访问
• 自动化更新：使用脚本定时更新已下载的小说

无论你是技术爱好者还是普通用户，这款工具都能为你提供稳定、高效的番茄小说下载体验。记住，技术是为了让生活更美好，合理使用工具，享受阅读的乐趣，同时尊重创作者的劳动成果。

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