番茄小说下载器完整使用教程：从安装到精通的全流程指南

还在为网络不稳定无法畅读小说而烦恼吗？fanqienovel-downloader 这款开源工具正是你需要的解决方案。它能将番茄小说平台上的精彩内容永久保存到本地，支持多种格式输出，让你随时随地享受阅读乐趣，不再受网络限制。无论是整本小说下载还是分章节保存，这款工具都能满足你的不同需求。

🎯 快速部署：三种运行环境任选

本地Python环境运行

1. 获取项目代码：git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
2. 安装必要依赖：pip install -r requirements.txt
3. 启动程序：进入src目录运行python main.py

Web界面版本部署

想要更直观的操作体验？Web版本是你的最佳选择：

1. 安装依赖后进入src目录
2. 运行服务器：python server.py
3. 浏览器访问：http://localhost:12930

Docker容器化运行

追求便捷部署？Docker方案一键搞定：

1. 使用命令：docker-compose up -d
2. 访问同一地址即可使用

📚 核心功能深度解析

智能下载管理系统

• 多线程并行下载：8个线程同时工作，下载速度提升显著
• 断点续传功能：网络中断后自动恢复，无需重新开始
• 智能重试机制：自动处理各种网络异常情况

多样化输出格式支持

1. 整本TXT格式 - 所有章节整合为单个文件
2. 分章TXT格式 - 每章独立保存，便于管理
3. EPUB电子书 - 标准电子书格式，适配各类阅读器
4. HTML网页格式 - 保持原始网页样式
5. LaTeX排版格式 - 专业排版效果，适合打印

个性化配置选项

通过修改src/charset.json文件，你可以自定义字符编码映射，满足特殊需求。配置文件位于项目根目录，包含丰富的可调整参数。

🔧 实用场景解决方案

移动设备适配方案

在手机上也能轻松使用，只需安装Termux并配置环境，运行python ref_main.py即可享受便捷下载体验。

批量下载管理技巧

支持多本小说同时下载，程序会自动排队处理。准备好小说ID列表，让下载工作更加高效。

🛠️ 常见问题处理指南

网络连接异常处理

如果出现代理连接错误，请检查网络设置，关闭VPN或代理软件通常能解决问题。

版本兼容性说明

请确保使用v1.1.6及以上版本，旧版本因API变更已无法正常使用。

性能优化建议

适当调整线程数量可以提升下载速度，但建议不要超过12个线程，以免被服务器限制。

💡 高级使用技巧

数据备份策略

定期备份data目录下的重要文件，包括下载记录、配置文件等，确保数据安全。

自定义配置进阶

通过深入理解项目结构，你可以进一步定制下载行为，打造完全符合个人需求的下载工具。

通过本教程的指导，相信你已经能够熟练使用fanqienovel-downloader这款强大的小说下载工具。无论是技术新手还是资深用户，都能从中获得满意的使用体验。现在就开始行动，打造属于你自己的永久小说库吧！