电子书管理与本地备份高效解决方案：打造你的个人离线图书馆

还在担心喜爱的网络小说因版权问题下架？想在没有网络的环境下继续阅读？这款开源电子书管理工具为你提供完整的本地备份解决方案，支持多种格式导出，操作简单高效，让你轻松构建永久保存的个人数字图书馆。无论是小说爱好者还是数字阅读达人，都能通过它实现阅读自由。

💻 核心价值：为什么选择本地备份方案

在数字阅读时代，内容的可访问性和持久性面临诸多挑战。这款电子书管理工具通过本地化存储解决了三大核心痛点：

• 内容永久保存：将网络小说完整备份到本地硬盘，彻底摆脱平台内容下架风险
• 跨设备阅读自由：导出的文件可在手机、平板、电子阅读器等多设备间无缝流转
• 个性化阅读体验：自定义字体大小、行间距和页面布局，打造专属阅读环境

与传统在线阅读相比，本地备份方案提供了更高的内容控制权和使用灵活性：

对比项目	在线阅读	本地备份方案
网络依赖	必须联网	完全离线可用
内容安全	平台控制	本地存储，永久拥有
格式支持	受限	多格式可选，适配各类设备
阅读体验	广告干扰	纯净无广告，自定义排版

🔧 三种部署方式：从新手到专家的选择

三步完成Web界面部署：零基础也能轻松上手

Web界面版适合没有技术背景的普通用户，通过直观的图形界面完成所有操作：

1. 下载项目压缩包并解压到本地文件夹
2. 打开终端，进入项目目录执行依赖安装命令：

   pip install -r requirements.txt
   

3. 启动Web服务：python src/server.py，然后在浏览器访问http://localhost:12930

Web版特色功能：

• 可视化任务管理面板，下载进度实时可见
• 内置预览功能，下载前确认内容完整性
• 响应式设计，在平板等移动设备上同样操作流畅
• 实用技巧：在设置页面可自定义默认下载目录，建议设置在非系统盘以避免重装系统丢失数据

命令行高效操作：技术用户的批量处理方案

对于熟悉命令行的用户，本地程序版提供更高的执行效率和更多自定义选项：

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
   

2. 安装依赖环境：pip install -r requirements.txt
3. 执行下载命令：python src/main.py --novel-id 12345 --format epub

命令行版高级用法：

• 支持批量ID下载：--novel-ids 123 456 789同时下载多本小说
• 设置并发控制：--threads 3调整下载线程数
• 实用技巧：使用--update参数可仅更新已下载小说的新增章节，节省流量和时间

Docker容器化部署：稳定运行的最佳实践

Docker方案适合需要长期运行或服务器部署的场景，提供环境隔离和简化维护：

1. 确保已安装Docker和Docker Compose
2. 在项目目录执行一键部署：

   docker-compose up -d
   

3. 服务将在后台持续运行，通过http://服务器IP:12930访问

容器化优势：

• 自动处理依赖关系，避免系统环境冲突
• 支持开机自启动，保持服务持续可用
• 数据卷挂载设计，确保下载内容不会因容器重建而丢失

📱 设备兼容性指南：全平台使用方案

桌面平台优化配置

• Windows系统：建议使用Python 3.8+版本，在PowerShell中执行命令
• macOS系统：通过Homebrew安装依赖，使用终端运行
• Linux系统：支持主流发行版，推荐使用venv创建独立虚拟环境

移动设备使用方案

安卓设备配置：

1. 安装Termux终端应用
2. 执行pkg install python git安装基础环境
3. 克隆项目并运行手机优化版：python src/ref_main.py

iOS设备：

• 通过TestFlight参与测试版体验
• 或使用Pythonista应用运行简化版脚本

移动设备注意事项：

• 建议连接WiFi进行大文件下载
• 后台下载时保持屏幕常亮或连接电源
• 定期清理缓存：python src/main.py --clean-cache

🔍 核心操作指南：从小说ID到本地书架

精准获取小说ID的四种方法

小说ID是下载的关键标识，以下方法帮你快速获取：

方法一：网页地址提取 在浏览器中打开小说页面，地址栏URL中"novel/"后的数字部分即为小说ID

方法二：APP分享链接解析

1. 在番茄小说APP中打开目标小说
2. 点击"分享"按钮，选择"复制链接"
3. 在任意文本编辑器中粘贴链接，提取其中的数字ID

方法三：搜索API调用 通过程序内置搜索功能直接查找：python src/main.py --search "小说名称"

方法四：批量导出 在Web界面的"我的书架"中勾选多本小说，点击"批量导出ID"

格式选择与应用场景匹配

根据不同使用需求选择合适的输出格式：

• EPUB格式：适合专业电子书阅读器，支持目录导航和字体调整
• TXT格式：兼容性最强，所有设备均可直接打开，文件体积最小
• HTML格式：保留原始排版，适合在浏览器中阅读或进一步编辑

格式转换技巧：使用--convert参数可批量转换已有文件格式，例如：

python src/main.py --convert epub txt --input-dir ./books

📦 内容迁移与备份策略

个人图书馆备份方案

为防止数据丢失，建议实施以下备份策略：

1. 定期全量备份：每月执行一次完整备份：

   python src/main.py --backup-library --target /external-drive/backup
   

2. 增量备份设置：启用自动增量备份功能，仅保存变更内容
3. 多位置存储：同时备份到本地硬盘和外部存储设备

跨设备同步方案

实现多设备间的内容同步：

• 本地网络共享：通过家庭局域网共享下载目录
• 云存储同步：将下载目录设置为云盘同步文件夹
• 手动迁移：使用--export-metadata导出图书元数据，在新设备上快速恢复书架

同步注意事项：

⚠️ 重要提示：同步前请确保目标设备已安装相同版本的管理工具，避免格式不兼容问题

💡 高级使用技巧与常见问题

性能优化参数设置

通过调整配置文件提升下载效率：

• 下载延迟：默认100ms，网络状况好可设为50ms，不稳定时建议200ms
• 重试次数：默认3次，对于网络波动大的环境可增加至5次
• 缓存大小：设置合理的缓存上限，避免占用过多磁盘空间

常见问题解决方案

Q: 下载过程中出现"403错误"如何处理？
A: 这通常是请求频率过高导致，可通过以下方式解决：

1. 增加下载延迟参数：--delay 200
2. 启用随机UA功能：--random-user-agent
3. 暂时停止下载，30分钟后再试

Q: 导出的EPUB文件在阅读器中排版错乱？
A: 尝试使用--reformat参数重新生成：

python src/main.py --novel-id 12345 --format epub --reformat

Q: 如何批量更新已下载的小说？
A: 使用批量更新命令：

python src/main.py --update-all --format epub

📚 使用规范与最佳实践

本工具仅供个人学习研究使用，下载内容请遵守版权法规，尊重作者知识产权。建议：

• 仅下载有明确授权的作品
• 不将下载内容用于商业用途
• 定期清理不再需要的文件，合理利用存储空间

通过本指南，你已经掌握了从安装部署到高级管理的全部技能。立即开始构建你的个人离线图书馆，享受随时随地、无拘无束的阅读体验吧！无论是通勤路上还是旅行途中，有了本地备份的电子书，你的阅读之旅将永不断电。