Docker部署SoNovel小说下载工具-夜雨聆风

Docker部署SoNovel小说下载工具

📝 写在前面：今天给大家推荐一款开源的小说下载神器——SoNovel，它可以帮助我们轻松下载各大网站的网络小说，并且支持Docker一键部署，让爱看小说的小伙伴可以随时随地离线阅读！

为什么找到这个项目是因为最近很久之前看的全职法师更新了,但是找了几个不是要圆子,就是满屏广告,虽然自己开发了一个摸鱼在线阅读应用但是只能在PC端使用,我又想在移动端阅读续上就难受了,然后发现这个可以直接部署在极空间然后指定下载路径,筛选书籍下载完成后去极阅读扫描一下就可以了,很是满意最后就选定了这个方案

01 项目介绍 📖

SoNovel 是一款通用的网页内容处理与导出工具，它致力于帮助用户高效地从网页中提取结构化信息，并将其灵活导出为 EPUB、TXT、PDF 等多种标准电子文档格式。

💡 一句话总结：这是一个专门用来下载网络小说的开源工具，支持多种格式导出，Docker部署超方便！如果不想使用docker也有本地应用支持CLI操作下载

如果不想使用docker部署,有阅读器的可以直接去项目的release里面下载PC的应用下载完成后导入阅读器,如果你打不开最后我也会把压缩包放在网盘中,查看最后信息后台回复关键字就行了

项目地址：https://github.com/freeok/so-novel

02 功能特色 ✨

SoNovel 支持三种操作界面，满足不同用户需求：

界面类型	说明	适用场景
TUI	文本用户界面	服务器终端使用
CLI	命令行界面	脚本自动化
WebUI	网页界面	文本用户界面

本地压缩包启动

🛠️ 核心功能

✅ 多格式输出：支持导出 EPUB、TXT、PDF 等格式
✅ 多界面支持：TUI、CLI、WebUI 三种界面可选
✅ Docker部署：一键部署，无需配置复杂环境
✅ 自定义规则：支持自定义抓取规则，适配更多网站
✅ 批量下载：支持批量下载小说章节

03 Docker部署教程 🐳

⚠️ 提醒一下：部署前请确保你的服务器已经安装了Docker环境！

3.1 方式一：Docker Compose（推荐）⭐

创建 docker-compose.yml 文件：

services:sonovel:image:ghcr.io/freeok/sonovel:latestcontainer_name:sonovelports:-"7765:7765"environment:JAVA_OPTS:"-Dmode=web"volumes:-sonovel_data:/sonovelrestart:unless-stoppedvolumes:sonovel_data:

1️⃣ 创建并启动容器

docker-compose up -d

2️⃣ 查看运行状态

docker ps | grep sonovel

3.2 方式二：直接运行容器

docker run -d \  --name sonovel \  -v /sonovel/config.ini:/sonovel/config.ini \  -v /sonovel/rules:/sonovel/rules \  -v /sonovel/downloads:/sonovel/downloads \  -p 7765:7765 \  -e JAVA_OPTS='-Dmode=web' \  ghcr.io/freeok/sonovel:latest

💡 小技巧：如果你需要自定义配置，可以挂载 config.ini 文件和 rules 目录！

3.3 方式三：一键脚本安装

curl -sSL https://raw.githubusercontent.com/freeok/so-novel/main/bin/docker-install.sh | bash

04 使用指南 📚

部署完成后，打开浏览器访问：http://你的服务器IP:7765

📱 WebUI 界面操作

1️⃣ 输入小说链接或关键词2️⃣ 选择下载格式（EPUB/TXT/PDF）3️⃣ 设置保存路径4️⃣ 点击下载

⚠️ 提醒一下：下载的内容仅供个人学习使用，请勿用于商业用途！

🖥️ CLI 命令行使用

# 进入容器docker exec -it sonovel bash# 执行下载命令./app.jar --mode=cli --url="小说链接"

05 配置说明 ⚙️

自定义 JVM 系统属性

参数	说明	默认值
-Dconfig.file	配置文件路径	./config.ini
-Dmode	启动模式：tui/cli/web	tui

配置文件说明

配置文件 config.ini 主要包含以下配置项：

# 下载路径download.path=./downloads# 并发下载数download.threads=5# 请求超时时间（毫秒）request.timeout=30000

06 常见问题 ❓

❌ Docker拉取镜像失败？

可能是网络问题，可以尝试配置Docker镜像加速源，或者使用代理。

❌ WebUI打不开？

检查容器是否正常运行：docker ps
检查端口是否正确映射：docker port sonovel
查看容器日志：docker logs sonovel

❌ 下载速度慢？

可以适当调大 download.threads 参数，增加并发下载数。

更多问题可以查看项目的 Issues 页面。

📌 最后总结一下

折腾了这么久，Docker部署SoNovel这套组合下来，确实能达到几个目的：

✅ 一键部署：Docker Compose 快速启动，无需配置复杂环境
✅ 多格式支持：EPUB、TXT、PDF 随意导出，适配各种阅读器
✅ 界面友好：WebUI 可视化操作，小白也能轻松上手
✅ 资源丰富：支持下载各大网站的网络小说

当然，这方案也不是完美的，但至少在当前阶段，算是性价比比较高的选择了。爱看小说的小伙伴赶紧试试吧！

🔗 参考资料

资源名称	链接	说明
SoNovel GitHub	https://github.com/freeok/so-novel	项目主页
SoNovel Releases	https://github.com/freeok/so-novel/releases	下载最新版本
Docker官方文档	https://docs.docker.com	Docker学习资料

📢 关注公众号

👉如果你对本文内容感兴趣，欢迎关注公众号「伊诺无界」，回复关键词 [SoNovel],[sonovel],[小说下载]，即可收获：

🔥 本项目使用的本地下载包
🛠️ 好用的开源小工具
📚 技术实操经验分享
💻 开发工作流优化的踩坑记录

目录