番茄小说下载器：3种方式打造个人离线图书馆，告别网络限制
番茄小说下载器：3种方式打造个人离线图书馆，告别网络限制
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
你是否遇到过这样的困扰：在番茄小说上看到精彩章节，却因网络不稳定无法继续阅读？或是想在地铁、飞机上享受阅读，却受限于平台限制？Tomato-Novel-Downloader 正是为解决这些问题而生。这款基于 Rust 开发的开源下载工具，能够将番茄小说内容高效下载到本地，支持 EPUB 电子书和有声小说生成，让你随时随地享受无限制的阅读乐趣。
为什么你需要一个专业的番茄小说下载器？
在数字阅读时代，我们常常面临以下几个痛点：
- 网络依赖：没有网络就无法阅读已缓存的内容
- 平台限制：阅读时长受限，需要等待或付费
- 格式混乱：手动保存的章节零散，缺乏统一管理
- 跨设备同步：不同设备间阅读进度无法同步
- 听觉需求：想要听书却没有合适的音频版本
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_passwordWeb UI 核心功能：
- 智能搜索：直接输入小说名称搜索，无需手动查找 ID
- 任务管理：实时查看下载进度，支持暂停和取消操作
- 文件浏览：按目录结构浏览已下载的文件
- 一键打包：将文件夹打包为 ZIP 下载，保持目录结构
- 在线配置：修改下载设置并自动保存到 config.yml
TUI 终端界面：键盘操作的高效方案
如果你习惯命令行操作，TUI 界面提供简洁高效的键盘操作体验：
# 启动 TUI 界面（默认模式） ./tomato-novel-downloaderTUI 界面特点：
- 全键盘导航，无需鼠标操作
- 实时进度显示和状态更新
- 支持剪贴板粘贴操作
- 配置热键快速切换功能
启用老版本 CLI 界面：在第一次打开程序时，按三下o键并回车，或者按一下下方向键并按三下o键，都可以启用老版本 CLI 界面。
NOUI 无界面模式：自动化脚本集成
对于需要自动化处理的场景，NOUI 模式提供脚本调用接口：
# 自动更新已下载的小说 ./tomato-novel-downloader --update 7318247498772674083NOUI 模式使用场景：
- 配合定时任务使用，实现自动更新已下载的小说内容
- 集成到自动化工作流中
- 批量处理多个小说更新
配置系统详解：个性化你的下载体验
Tomato-Novel-Downloader 的配置系统位于src/base_system/config.rs，支持智能合并用户配置和默认值。配置文件config.yml会自动生成并包含详细注释。
核心配置项说明
| 配置类别 | 配置项 | 默认值 | 说明 |
|---|---|---|---|
| 网络配置 | max_workers | 3 | 最大并发下载数 |
request_timeout | 30 | 请求超时时间（秒） | |
max_retries | 3 | 最大重试次数 | |
| 保存配置 | novel_format | "epub" | 输出格式：epub 或 txt |
save_path | "./downloads" | 默认保存路径 | |
| 音频配置 | enable_audiobook | false | 是否生成有声小说 |
audiobook_voice | "zh-CN-XiaoxiaoNeural" | 发音人 | |
audiobook_concurrency | 2 | 音频生成并发数 | |
| API 配置 | use_official_api | true | 是否使用官方 API |
api_endpoints | [] | 自定义 API 端点 |
配置文件示例
# 网络配置 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 是目前最流行的电子书格式，具有以下优势：
- 自适应排版：根据阅读设备自动调整文字大小和版式
- 跨平台兼容：支持 Kindle、iPad、手机等所有主流阅读器
- 完整结构：保留章节、目录、封面等完整书籍结构
- 样式丰富：支持 CSS 样式定义，提供统一的阅读体验
EPUB 生成流程
Tomato-Novel-Downloader 的 EPUB 生成流程非常完善：
- 内容提取：通过
src/network_parser/network.rs模块解析网页内容 - 章节处理：
src/book_parser/parser.rs负责章节分割和清理 - 格式转换：
src/book_parser/epub_generator.rs生成标准 EPUB 文件 - 资源嵌入：
src/book_parser/image_utils.rs处理图片和封面 - 最终封装：
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即可启用音频生成功能。
音频配置优化建议
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 发音人 | zh-CN-XiaoxiaoNeural | 微软小晓，声音自然清晰 |
| 并发数 | 2 | 平衡生成速度和系统负载 |
| 输出格式 | mp3 | 兼容性好，文件体积适中 |
| 语速 | +0% | 保持自然语速 |
音频文件输出结构
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 环境配置
- 安装 Termux：从 F-Droid 或 GitHub Releases 下载
- 运行部署脚本：
bash <(curl -sL https://dl.zhongbai233.com/installer.sh) - 启动 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中的参数 - 确保系统有足够可用内存
性能优化建议
网络请求优化：
max_workers: 3 # 并发数不宜过高 request_timeout: 30 # 适当延长超时时间 max_retries: 3 # 重试次数 min_wait_time: 1000 # 最小等待时间（毫秒） max_wait_time: 5000 # 最大等待时间（毫秒）日志系统使用：
# 设置日志级别 RUST_LOG=info ./tomato-novel-downloader --server RUST_LOG=debug ./tomato-novel-downloader --server # 详细调试信息
安全使用与合规建议
合理使用原则
- 个人使用：下载内容仅供个人阅读使用
- 尊重版权：支持正版阅读，尊重作者劳动成果
- 控制频率：合理控制下载频率，避免给服务器带来压力
- 禁止传播：不要将下载内容用于商业用途或传播
内置保护机制
项目内置了完善的保护机制：
- 速率限制：防止过度请求目标服务器
- 错误重试：智能重试机制提高成功率
- 智能排队：优化资源使用，避免并发过高
快速开始指南
获取项目源码
git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader cd Tomato-Novel-Downloader一键安装脚本
# 使用安装脚本 ./installer.sh # 或手动构建 cargo build --release首次使用建议
- 启动 Web UI：
./tomato-novel-downloader --server - 浏览器访问：
http://localhost:18423 - 搜索小说：在搜索框中输入小说名称
- 开始下载：选择输出格式和保存路径
- 享受阅读：下载完成后在本地阅读器打开
结语：打造个性化的阅读体验
Tomato-Novel-Downloader 不仅是一个简单的下载工具，更是一个完整的离线阅读解决方案。通过合理配置和使用，你可以：
- 建立个人数字图书馆：将喜爱的小说保存为 EPUB 格式，随时重温
- 实现通勤听书：利用音频生成功能，在通勤路上听小说
- 跨设备同步：通过 Docker 部署，实现多设备访问
- 自动化更新：使用脚本定时更新已下载的小说
无论你是技术爱好者还是普通用户，这款工具都能为你提供稳定、高效的番茄小说下载体验。记住，技术是为了让生活更美好，合理使用工具，享受阅读的乐趣，同时尊重创作者的劳动成果。
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考