番茄小说下载器新手实操指南：一个链接把整本书变成本地文件

番茄小说下载器新手实操指南一个链接把整本书变成本地文件【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloaderfanqienovel-downloader番茄小说下载器是一款用 Python 编写的开源下载工具输入小说 ID 或目录页链接就能把整本番茄小说自动抓取、保存为 TXT、EPUB、HTML 等多种格式把在线阅读变成本地资产。网断了能看书下架了还在换设备不用重新下载。新手最常问的其实就那么几个问题这篇一次讲清楚。这工具到底能干什么怎么最快跑起来命令行怎么用能存成什么格式连载书追更怎么办报错了怎么处理手机、NAS 上能跑吗问题一这工具到底能干什么值得装吗一句话它把在线阅读变成本地收藏。平时追书最怕三件事信号差打不开、书突然下架、换设备要从头再来。装了它这些都不是事地铁、高铁、地下室没网也能接着读章节锁定、小说被删本地副本照常可用导出一份手机、平板、电纸书、电脑各存一份。它也不是只干一次的一次性工具追更、搜索、批量下载都是内置功能后面逐个说。问题二怎么最快跑起来有图形界面吗有而且对新手最友好的是浏览器版。四条命令就能把下载服务拉起来git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src python server.py然后浏览器打开http://localhost:12930一个简洁的管理界面就在眼前支持按 ID 下载、按书名搜索、更新已下载的小说还能把好几本书加进队列批量处理每本书的下载进度都实时显示。下载完成后文件直接打包给你所以这个 Web 版完全可以丢在远程服务器或容器里随时调用。问题三不喜欢开网页命令行怎么用命令行版同样简单进src目录运行python main.py启动后直接输入小说 ID 或目录链接就开始下载想用菜单功能输入对应数字即可输入作用小说 ID 或链接立即下载这本书1读取 record.json更新已下载的连载书2按关键词搜索小说3批量下载多本书4进入设置段首占位符、延时、存储位置、保存模式、线程数5备份已下载的小说和下载配置6退出程序全程中文提示跟着走就行基本不用翻文档。问题四下载下来都是什么格式手机能看吗目前v1.1.14支持五种保存方式对应不同阅读场景序号保存方式适合谁1整本保存单文件 TXT想一个文件装下全书2分章保存每章一个 TXT要按章节整理、批注3EPUB 电子书格式Kindle、微信读书等阅读器4HTML 格式浏览器打开即读样式友好5LaTeX 格式排版控、需要二次加工选型建议手机日常阅读首选 EPUB在意存储空间就退回 TXT体积最小要做内容处理再考虑分章和 LaTeX。这些选项在设置里随时切换不需要额外装转换工具。问题五追更的连载书怎么办每次都重新下载吗不用。程序会把你下载过的书籍 ID 记在data/record.json里。下次命令行输入 1Web 版点更新它会自动对比目录、只补抓新增章节连载小说每天跑一次就能保持最新。相关数据都集中在src/data目录bookstore存正文、record.json记书单、config.json存设置想备份、迁移拷这个目录就行。问题六报错卡住怎么办⚠️新手最容易踩的坑有这么几个对号入座即可报 ProxyError / MaxRetryError多半是系统代理或加速器拦了请求关掉代理、检查网络再重试。旧版本直接失效v1.1.5 及以下因为网站 API 变动已经用不了务必用 v1.1.6 及以上版本。设置被整体覆盖改设置里的任意一项都会覆盖原配置改前看清楚想恢复默认把config.json删掉重启程序即可。老版本 PythonPython 3.8 及以下环境进src后删掉原main.py把main2.py改名为main.py再运行。问题七手机、NAS 上能跑吗还能玩出什么花样都能。手机端在 Android 装 Termux 后按phone.md的步骤配置环境先删掉ref_main.py里的 tkinter 导入再装依赖并运行pip install requests lxml ebooklib tqdm beautifulsoup4 python ref_main.py如果 lxml 编译报错用CFLAGS-O0 pip install lxml重装即可通勤路上离线阅读完全够用。服务器或 NAS 上想常驻用 Docker 最省心docker compose up -d构建完成后访问http://localhost:12930。小说和个人数据分别存放在fanqie_data、fanqie_downloads两个 Docker 卷里容器销毁数据不丢镜像默认带 1G 内存上限避免长期运行挤占主机资源。进阶玩家还能再折腾src/main.py里的Config可调下载延时默认 50~150 毫秒和并发线程数默认 16网络好可以适当加线程提速也可以写个简单的循环脚本把一串书 ID 排好队逐本下载再配合项目自带的网页结构检测、已下载内容全文搜索、按文件大小分割小说三个周边工具搭出下载→搜索→分卷的个人书库流水线。更多细节在根目录的README.md与phone.md里按需查阅即可。写在最后说到底这类工具的价值不在爬取本身而在把阅读的主动权交还给你。项目遵循 AGPL-3.0 协议开源由 Yck、Yqy、Lingo 维护遇到问题可以去 Issues 反馈。最后务必守住边界仅供个人学习、研究与离线阅读不要高频抓取、不要商用传播尊重作者版权。现在就照着上面的步骤跑通第一本书吧——几分钟后你的专属离线书库就正式开张了。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考