标签搜索

目 录CONTENT

文章目录

Docker部署SoNovel开源小说神器:搭建私人小说库,实现下载小说自由!

yyzq
2026-08-14 / 0 评论 / 1 点赞 / 18 阅读 / 1,310 字
广告 广告

前言

随着数字阅读的普及,越来越多的人喜欢通过网络获取小说资源,但面对各种平台限制、广告干扰以及资源管理不便等问题,拥有一个属于自己的小说管理平台成为不少用户的需求。

SoNovel 是一款开源小说工具,通过 Docker 部署后,可以快速搭建一个私人小说库,实现小说资源的统一管理和便捷下载。无论是在家中的服务器、NAS,还是云端 VPS 上,都可以轻松部署属于自己的小说服务。

本期教程将带大家从 Docker 环境准备开始,一步步完成 SoNovel 的部署,让你拥有一个简单、稳定、私人的小说管理平台,实现真正的下载小说自由。

项目图示

web界面
主要功能就是下载,不支持在线阅读
image
自带源
也可以自定义添加,维护数据源
image-1786719540164

项目简介

So Novel 是一款通用的网页内容处理与导出工具,它致力于帮助用户高效地从网页中提取结构化信息,并将其灵活导出为 EPUB、TXT、PDF 等多种标准电子文档格式。适用于学习采集、格式转换、电子书制作等场景。

[!TIP]

为获得最佳阅读体验,建议使用以下电子书阅读器:

桌面端

移动端

如需转换为其它电子书格式,可使用:

修复 WPS、掌阅等软件无法打开 so-novel 下载的 EPUB:https://github.com/freeok/so-novel/discussions/199

部署方法

使用Docker安装

本教程使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

准备条件

1)一台服务器

我们使用莱卡云VPS来演示(各种NAS都可以部署)
需要vps的可以看以下信息,配置尽量选择大点的比如2核心4G内存
莱卡云官网

2)本教程使用到的项目

本教程使用的官方github地址
https://github.com/freeok/so-novel
image-1786719868636
目前有7.8k stars
我自己添加了用户名密码功能
https://github.com/yyzq-cf/sonovel

3)域名(可选)

根据自己的需求,web界面建议绑定域名

VPS部署

一、Docker环境部署

在vps安装docker和docker-compose
Docker官方安装文档(英文)
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档(英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

二、部署命令

登录服务器使用root账户执行以下步骤

docker-compose命令

创建一个目录,并进入此目录

mkdir  sonovel ;cd sonovel

请自行安装vim编辑器
然后再新建docker-compose.yml

vim docker-compose.yml
services:  # 定义 Docker Compose 服务
  sonovel:  # 服务名称,名称可以自定义
    image: ywsj/sonovel:latest  # 使用的 SoNovel Docker 镜像
    ports:
      - "7765:7765"  # 端口映射,将宿主机 7765 端口映射到容器 7765 端口
    environment:  # 设置容器运行环境变量
      JAVA_OPTS: "-Dmode=web"  # Java 启动参数,指定 SoNovel 以 Web 模式运行
      AUTH_USERNAME: "admin"  # 设置 Web 管理后台登录用户名
      AUTH_PASSWORD: "admin123"  # 设置 Web 管理后台登录密码
    volumes:
      - ./downloads:/sonovel/downloads  # 挂载当前目录 downloads 文件夹,用于保存下载的小说数据
    restart: always  # 设置容器自动重启,保证服务持续运行

注意端口如有冲突自行修改

三、执行容器运行命令

docker-compose up -d #运行容器
docker-compose ps  #查看是否启动成功

正常启动如下所示

docker-compose ps
NAME                IMAGE                 COMMAND                   SERVICE   CREATED          STATUS          PORTS
sonovel-sonovel-1   ywsj/sonovel:latest   "sh -c 'JAVA_OPTS=\"$…"   sonovel   17 minutes ago   Up 17 minutes   0.0.0.0:7765->7765/tcp, [::]:7765->7765/tcp

四、web界面

打开web页面使用
成功以后需要打开自己相应的端口7765)防火墙就可以web端访问了

主界面

http://ip:7765

image-1786720114730
输入用户名密码即可登录使用
image-1786720299123
主要功能就是下载小说-配合其他阅读软件使用
其他功能自行探索

绑定域名

VPS上的建议绑定下域名,方便管理。
绑定域名的教程参考以下内容

绑定域名视频教程

B站

YouTube

绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch

有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我

欢迎关注我们的微信公众号!
微信公众号

1
广告 广告

评论区