fanqienovel-downloader

项目概述

番茄小说下载器（Fanqienovel-downloader）是一个使用 Python 实现的开源工具，用于下载番茄小说内容。它提供本地命令行程序、Web 界面、Docker 以及手机 Termux 等多种运行方式。

主要功能

• 通过小说目录页链接或 id 下载小说
• 根据 record.json 中的 id 更新已下载的小说
• 按名称搜索小说
• 批量下载与队列管理
• 可配置正文段首占位符、延时、存储位置与保存模式
• 支持备份下载的小说以及下载格式、段首空格等
• Web 版提供进度条、简洁 UI 与在线阅读
• 支持 Docker 部署，数据存入 docker 卷

适用人群

• 需要离线阅读番茄小说的用户
• 希望批量备份小说的用户
• 熟悉 Python 或 Docker 的技术用户
• 需要在手机或服务器上运行的用户

快速上手

1. 本地程序：运行后输入小说目录页完整链接或 id 进行下载
2. 交互菜单：输入 1 更新、2 搜索、3 批量下载、4 设置、5 备份、6 退出
3. Web 版：进入 src 目录运行 server.py，用浏览器打开 http://localhost:12930
4. Docker 版：在项目目录执行 docker compose up，访问 http://localhost:12930
5. 手机版：安装 Termux 并按 README 配置依赖后运行 ref_main.py

核心优势

• 多种运行方式，覆盖桌面、服务器、容器与手机
• Web 版界面简洁，带进度条与在线阅读
• 支持更新与批量下载，适合长期使用
• 开源且持续维护

系统要求

• 操作系统：Windows、macOS、Linux、Android（Termux）
• 支持架构：不限
• 额外依赖：运行需 Python 3.8+ 及 requests、ebooklib、tqdm、beautifulsoup4 等依赖

注意事项

• 请勿滥用本工具，且用且珍惜
• 仅供教育与研究用途，请遵守相关法律法规及网站使用政策
• 修改设置中的任一选项都会覆盖原有数据，恢复默认需删除 config.json
• 出现网络代理错误时请检查网络连接，可关闭代理或使用加速