最近在折腾个人服务器时发现一个非常有意思的开源项目——SoNovel。作为一个小说爱好者你是否也遇到过这些问题想看的正版小说平台太多会员费叠加起来是一笔不小的开销一些经典小说因为版权或平台下架突然就找不到了或者单纯想拥有一个干净、无广告、可以随时随地阅读的私人书库。SoNovel 的出现完美解决了这些痛点。它是一个功能强大的开源小说阅读与下载工具能够聚合多个小说源实现小说内容的搜索、阅读、下载与管理。而通过 Docker 进行部署更是将整个搭建过程简化到了极致无需关心复杂的 Python 环境或依赖冲突几分钟就能拥有一个专属的、7x24小时在线的私人小说库。本文将手把手带你完成 SoNovel 的 Docker 化部署从 Docker 基础环境准备到 SoNovel 容器的配置与启动再到通过 Web 界面畅快使用。整个过程清晰完整代码和命令均可直接复制执行无论是 Docker 新手还是有一定经验的开发者都能轻松搭建成功。1. 项目背景与核心概念在深入部署之前我们有必要了解一下 SoNovel 到底是什么以及为什么选择 Docker 来部署它。1.1 什么是 SoNovelSoNovel 是一个基于 Python 开发的开源网络小说爬取、阅读和下载工具。它的核心功能可以概括为以下几点多源聚合它内置或支持配置多个小说网站源用户可以从一个统一的入口搜索全网小说无需在不同网站间反复切换。内容获取根据小说名称或作者进行搜索并获取详细的章节列表和正文内容。在线阅读提供简洁的 Web 阅读界面支持调整字体、背景色、翻页模式等体验媲美主流阅读 APP。离线下载支持将整本小说下载为 TXT、EPUB 等格式方便导入到 Kindle 或其他本地阅读器中实现真正的“下载自由”。书架管理具备个人书架功能可以收藏、追踪阅读进度。简单来说SoNovel 的目标是成为你的“私人小说图书馆管理员”帮你从互联网上收集、整理并保管你感兴趣的小说内容。1.2 为什么选择 Docker 部署对于 SoNovel 这类带有 Web 服务、依赖特定环境Python 及第三方库的应用Docker 部署具有显著优势环境隔离与一致性Docker 容器将 SoNovel 及其所有依赖Python 版本、库文件、配置文件打包在一起。无论在 Ubuntu、CentOS 还是 Windows 上运行容器内部环境完全一致彻底杜绝了“在我机器上是好的”这类问题。部署极简无需在宿主机上安装 Python、配置虚拟环境、处理 pip 依赖冲突。只需一条docker run命令服务即可启动。维护方便更新 SoNovel 版本时直接拉取新镜像并重启容器即可。清理时也只需删除容器和镜像不会在系统留下任何残留。资源可控可以方便地限制容器使用的 CPU 和内存资源。便于迁移整个服务可以轻松地从一台服务器迁移到另一台或从本地开发环境部署到云服务器。结合网络热词中频繁出现的docker部署微服务项目、docker安装详细步骤等需求可以看出使用 Docker 部署应用已成为主流实践。接下来我们就从零开始完成这次部署。2. 环境准备与安装 Docker我们的部署可以在任何安装有 Docker 的 Linux 服务器如云服务器、Windows使用 WSL2或 macOS 上进行。本文将以最常见的Linux 服务器Ubuntu 22.04环境为例进行演示。2.1 系统环境要求操作系统Ubuntu 20.04/22.04, CentOS 7/8, Debian 10/11 等主流 Linux 发行版。本文命令主要针对 Ubuntu/Debian。内存建议至少 1GB RAM。SoNovel 本身不耗资源但 Docker 和系统需要基础内存。磁盘空间至少 2GB 可用空间用于存放 Docker 镜像、容器以及下载的小说文件。网络服务器需要能正常访问互联网以下载 Docker 镜像和拉取小说内容。2.2 安装 Docker Engine如果您的系统已经安装了 Docker可以跳过此节。如果没有请按照以下步骤安装。首先更新系统软件包索引并安装一些必要的工具sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release添加 Docker 的官方 GPG 密钥和软件源# 创建 keyring 目录 sudo mkdir -p /etc/apt/keyrings # 下载并导入 GPG 密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 添加 Docker APT 源 echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null再次更新包列表并安装 Docker Engine、CLI 等组件sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安装完成后启动 Docker 服务并设置开机自启sudo systemctl start docker sudo systemctl enable docker验证 Docker 是否安装成功运行 hello-world 镜像sudo docker run hello-world如果看到 “Hello from Docker!” 等欢迎信息说明 Docker 已正确安装并运行。重要提示默认情况下运行docker命令需要sudo权限。为了方便我们可以将当前用户加入docker用户组这样以后就不用每次都加sudo了。# 将当前用户加入 docker 组 sudo usermod -aG docker $USER # 退出当前终端并重新登录使组权限生效 # 或者执行以下命令立即生效针对当前会话 newgrp docker之后就可以直接用docker version来验证了。2.3 安装 Docker Compose (可选但推荐)Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。虽然 SoNovel 是单容器应用但使用 Compose 可以通过一个 YAML 文件来管理所有服务配置更加清晰和便于维护。安装命令如下# 对于 Linux使用以下命令下载并安装 Compose 插件这是官方推荐方式已在上一步通过 docker-compose-plugin 安装 # 如果上一步已安装可以跳过。这里提供独立安装脚本作为备选。 sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose # 验证安装 docker-compose --version3. 获取与运行 SoNovel Docker 镜像SoNovel 的作者通常会将构建好的镜像发布到 Docker Hub 等容器镜像仓库。我们需要找到正确的镜像并运行它。3.1 查找 SoNovel 镜像我们可以使用docker search命令在 Docker Hub 上搜索但更直接的方式是去项目的 GitHub 页面查看官方文档。假设我们找到的镜像名为somewheve/sonovel这是一个示例实际镜像名请以项目官方文档为准。首先尝试拉取镜像docker pull somewheve/sonovel:latestdocker pull命令会从 Docker Hub 下载指定的镜像到本地。:latest是标签代表最新版本。你也可以指定具体的版本号如:v1.2.0以获得更稳定的环境。3.2 首次运行与基础配置直接运行镜像会使用默认配置。但为了持久化我们的数据如下载的小说、配置文件我们需要将容器内的目录“映射”到宿主机的目录上。这是 Docker 数据持久化的关键。首先在宿主机上创建一个目录用来存放 SoNovel 的所有数据mkdir -p ~/sonovel/data mkdir -p ~/sonovel/config~/sonovel/data用于映射容器内的小说下载、缓存等数据目录。~/sonovel/config用于映射容器内的配置文件目录方便我们自定义修改。然后使用docker run命令启动容器docker run -d \ --name sonovel \ -p 8080:8080 \ -v ~/sonovel/data:/app/data \ -v ~/sonovel/config:/app/config \ --restart unless-stopped \ somewheve/sonovel:latest让我们逐行解释这个命令的参数-d以后台守护进程模式运行容器。--name sonovel给容器起一个名字方便后续管理启动、停止、查看日志。-p 8080:8080端口映射。将容器内部的 8080 端口映射到宿主机的 8080 端口。这意味着我们通过访问http://你的服务器IP:8080就能打开 SoNovel 的 Web 界面。-v ~/sonovel/data:/app/data数据卷挂载。将宿主机的~/sonovel/data目录挂载到容器内的/app/data目录。容器内生成的小说文件都会保存在这里即使容器被删除数据也不会丢失。-v ~/sonovel/config:/app/config配置卷挂载。将宿主机的~/sonovel/config目录挂载到容器内的/app/config目录。如果项目支持外部配置文件我们可以在这里修改。--restart unless-stopped设置容器重启策略。除非手动停止否则如果容器退出Docker 会自动重启它。这对于需要长期运行的服务非常有用。somewheve/sonovel:latest指定要运行的镜像名称和标签。运行命令后使用docker ps查看容器状态docker ps如果看到名为sonovel的容器状态为Up说明启动成功。3.3 使用 Docker Compose 运行推荐对于长期使用的服务更推荐使用docker-compose.yml文件来管理。这使配置一目了然且易于版本控制。在~/sonovel目录下创建docker-compose.yml文件# ~/sonovel/docker-compose.yml version: 3.8 services: sonovel: image: somewheve/sonovel:latest container_name: sonovel restart: unless-stopped ports: - 8080:8080 # 主机端口:容器端口 volumes: - ./data:/app/data # 持久化数据 - ./config:/app/config # 持久化配置 # 环境变量 (如果需要) # environment: # - TZAsia/Shanghai # - SOME_CONFIGvalue然后在docker-compose.yml文件所在目录即~/sonovel下运行以下命令启动服务# 启动服务后台运行 docker-compose up -d # 查看服务状态 docker-compose ps # 查看服务日志 docker-compose logs -f使用 Compose 的好处是管理命令更简洁并且所有配置都集中在一个文件中。4. 访问与使用 SoNovel Web 界面容器成功启动后我们就可以通过浏览器访问 SoNovel 了。本地访问如果 Docker 运行在你的本地电脑Windows/macOS 使用 Docker Desktop直接在浏览器打开http://localhost:8080。服务器访问如果 Docker 运行在远程 Linux 服务器上打开浏览器输入http://你的服务器公网IP地址:8080。重要安全提醒如果您的服务器开启了防火墙如 UFW、firewalld或安全组云服务器请确保放行了8080端口的入站流量。首次打开页面你可能会看到一个简洁的搜索界面。SoNovel 的典型功能流程如下4.1 搜索与发现小说在首页的搜索框中输入你想看的小说名称或作者点击搜索。SoNovel 会调用其内置的多个“书源”进行检索并列出结果。你可以从结果中选择一个来源最全、更新最快的进行阅读。4.2 在线阅读点击搜索结果中的小说会进入目录页。这里列出了所有章节。点击任意章节即可进入阅读页面。阅读器通常支持字体大小、字体类型调整。背景主题切换日间/夜间/护眼模式。翻页模式上下滚动、左右翻页。自动阅读滚屏。目录跳转。4.3 加入书架与下载在小说详情页或阅读页通常会有“加入书架”的按钮。加入后你可以在“我的书架”中快速找到它并同步阅读进度。“下载”功能是 SoNovel 的核心之一。你可以选择下载整本书或当前章节格式通常为 TXT 或 EPUB。下载的文件会保存在我们之前通过 Docker 卷映射的目录~/sonovel/data中具体子目录视项目设计而定。你可以通过 SFTP、SCP 或云盘同步等方式将这些文件传输到你的手机、电纸书等设备上阅读。5. 高级配置与自定义基础的 Docker 运行已经能满足大部分需求。但如果你需要更定制化的体验可以进行以下配置。5.1 修改 Web 服务端口如果你服务器的 8080 端口已被占用或者想通过 80 端口HTTP默认端口访问可以修改端口映射。对于直接docker run的方式将-p 8080:8080改为-p 80:8080或-p 9000:8080。对于 Docker Compose 方式修改docker-compose.yml文件中的ports部分ports: - 80:8080 # 使用80端口 # 或者 - 9000:8080 # 使用9000端口修改后需要重启服务docker-compose down docker-compose up -d5.2 配置反向代理使用 Nginx直接通过 IP:端口 访问不够优雅也不安全。更常见的做法是使用 Nginx 作为反向代理绑定域名并启用 HTTPS。假设你有一个域名novel.yourdomain.com并且已经解析到你的服务器 IP。首先安装 Nginxsudo apt-get install -y nginx然后为 SoNovel 创建一个 Nginx 配置文件sudo nano /etc/nginx/sites-available/sonovel将以下配置粘贴进去请替换your_domain为你的实际域名server { listen 80; server_name novel.yourdomain.com; # 你的域名 location / { proxy_pass http://127.0.0.1:8080; # 指向 Docker 容器的端口 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 以下配置对 WebSocket 可能有用如果 SoNovel 有实时功能 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } # 可选的静态文件缓存 location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 1y; add_header Cache-Control public, immutable; proxy_pass http://127.0.0.1:8080; } }保存并退出。然后启用该配置并测试 Nginxsudo ln -s /etc/nginx/sites-available/sonovel /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置语法 sudo systemctl reload nginx # 重载配置现在你就可以通过http://novel.yourdomain.com访问 SoNovel 了。要启用 HTTPS可以使用 Let‘s Encrypt 的 Certbot 工具免费申请 SSL 证书这里不再赘述。5.3 更新 SoNovel 版本当 SoNovel 发布新版本时更新非常简单。对于直接docker run的方式# 1. 停止并删除旧容器 docker stop sonovel docker rm sonovel # 2. 拉取最新镜像 docker pull somewheve/sonovel:latest # 3. 用同样的参数重新运行容器注意你的数据卷映射路径 docker run -d ... # 使用和之前一样的完整命令对于 Docker Compose 方式# 进入 docker-compose.yml 所在目录 cd ~/sonovel # 拉取最新镜像并重启服务 docker-compose pull docker-compose up -dCompose 的方式明显更加简洁和安全。6. 常见问题与故障排查在部署和使用过程中你可能会遇到一些问题。以下是常见问题的排查思路。6.1 容器启动失败现象docker ps看不到容器或状态为Exited。排查查看日志这是最重要的步骤。docker logs sonovel查看输出中是否有明显的错误信息如ImportErrorPython 导入错误、Port already in use端口占用、Permission denied权限问题。检查端口占用宿主机 8080 端口可能被其他程序占用。sudo netstat -tlnp | grep :8080如果被占用修改docker run或docker-compose.yml中的端口映射。检查镜像名称确认拉取的镜像名称和标签完全正确。6.2 无法通过浏览器访问现象服务器运行正常但浏览器无法打开页面。排查检查容器状态确保容器正在运行 (Up)。检查防火墙/安全组这是最常见的原因。确保云服务器安全组和系统防火墙如ufw放行了对应端口默认为8080。# 对于 ufw sudo ufw allow 8080/tcp sudo ufw reload检查 IP 和端口确认浏览器中输入的 IP 和端口号正确。服务器公网 IP 可能变化。在服务器内部测试在服务器上使用curl命令测试容器是否响应。curl http://127.0.0.1:8080如果服务器内能访问但外网不能问题一定出在网络层面防火墙/安全组/路由器。6.3 搜索不到小说或章节内容为空现象可以打开 Web 界面但搜索无结果或打开章节无内容。排查网络问题容器内部需要能访问外部网络来抓取小说网站。确保宿主机网络正常且 Docker 容器没有特殊的网络限制。书源失效小说网站经常改版导致 SoNovel 内置的“书源”规则失效。这是开源项目的常见问题。查看项目更新去 GitHub 项目主页查看是否有新版本新版本可能修复了书源。社区寻找新源在项目的 Issues 或 Discussions 板块其他用户可能会分享可用的书源配置文件。手动更新源如果项目支持自定义书源可以将找到的新源配置文件放入我们映射的~/sonovel/config目录中并重启容器。6.4 下载的小说文件找不到现象在 Web 界面点击了下载但不知道文件存到哪里了。排查确认卷映射回忆启动容器时-v参数指定的宿主机目录。我们示例中是~/sonovel/data。进入容器查看可以进入容器内部查看下载的默认路径。docker exec -it sonovel /bin/bash # 进入容器后根据项目文档寻找下载目录通常是 /app/data 下的某个子目录 ls -la /app/data在宿主机查找根据容器内的路径在映射的宿主机目录~/sonovel/data中寻找。6.5 Docker 相关错误现象执行docker命令时报错例如Cannot connect to the Docker daemon。解决确保 Docker 服务已启动sudo systemctl status docker。如果你没有使用sudo确保当前用户已在docker用户组中见 2.2 节。执行groups命令查看。7. 最佳实践与维护建议为了让你的私人小说库稳定、安全、长久地运行请遵循以下建议7.1 数据备份你的小说数据~/sonovel/data和自定义配置~/sonovel/config是最重要的。定期备份这两个目录。# 简单的压缩备份 tar -czf sonovel_backup_$(date %Y%m%d).tar.gz ~/sonovel/data ~/sonovel/config # 然后将备份文件传输到其他机器或云存储7.2 使用特定版本标签在docker-compose.yml或docker run命令中避免一直使用:latest标签。latest标签可能指向最新的开发版可能存在不稳定因素。当发现一个稳定好用的版本后可以指定具体的版本号如:v1.2.3。image: somewheve/sonovel:v1.2.37.3 资源监控与日志管理使用docker stats可以实时查看容器的 CPU、内存使用情况。docker stats sonovel定期查看日志可以了解服务的运行状态和潜在错误。# 查看最近100行日志 docker logs --tail 100 sonovel # 实时查看日志 docker logs -f sonovel对于长期运行建议将 Docker 容器的日志通过json-file或journald驱动进行管理并设置日志轮转防止日志文件占满磁盘。7.4 安全考虑不要暴露公网端口如果仅自己使用可以考虑通过 SSH 隧道访问而不是直接将 8080 端口暴露在公网。使用强密码如果 SoNovel 有用户管理功能请务必设置强密码。定期更新关注项目 GitHub 页面定期更新镜像以获取安全修复和功能更新。最小权限原则运行 Docker 容器时如果应用不需要 root 权限应使用非 root 用户运行。这通常可以在 Dockerfile 中指定或者通过docker run的-u参数指定。通过以上步骤你已经成功使用 Docker 部署了一个功能完整、数据持久化的 SoNovel 私人小说库。这个方案将复杂的软件环境封装在容器内让你能专注于阅读和收藏的乐趣而无需为安装和配置烦恼。无论是放在家里的 NAS 上还是部署在云服务器上它都能为你提供一个稳定、专属的小说阅读港湾。
