企业官网建设流程全解析

你是否曾为寻找一本心仪的小说，在各大网站间反复切换，忍受着广告弹窗、阅读限制和格式错乱？或者，你是否担心某天收藏的小说链接失效，精心整理的阅读记录无处可寻？对于深度阅读爱好者来说，一个纯净、稳定、完全由自己掌控的私人小说库，不仅是便利，更是一种数字资产的“安全感”。

今天要介绍的SoNovel，正是一个能解决上述所有痛点的开源小说神器。它不是一个简单的阅读器，而是一个集成了小说搜索、在线阅读、内容下载、本地管理于一体的全栈解决方案。更重要的是，通过Docker部署，你可以在自己的服务器、NAS甚至家用电脑上，用极低的成本和门槛，搭建一个永不消失的私人图书馆。

这篇文章要解决的，远不止“如何安装一个软件”。我们将深入探讨：为什么在云服务唾手可得的今天，自建小说库仍有不可替代的价值？SoNovel 的核心设计解决了哪些传统阅读方式的顽疾？以及，如何通过 Docker 这一“标准化集装箱”，让一个包含前后端、数据库的复杂应用，在十分钟内从零跑通。

如果你符合以下任一情况，这篇文章将为你提供一条清晰的实践路径：

1. 技术爱好者：想用 Docker 练手，部署一个有趣又有用的完整项目。
2. 小说重度用户：受够了平台限制，渴望一个干净、无干扰、可永久保存的阅读环境。
3. 数据囤积党：有强烈的数据主权意识，希望将喜欢的文字内容本地化存档。
4. 个人开发者：对 SoNovel 的架构感兴趣，或许能从中获得灵感。

接下来，我们将从 SoNovel 的核心价值讲起，一步步完成 Docker 环境准备、项目部署、功能体验，并深入分析其配置、常见问题及最佳实践，最终让你拥有一个 7x24 小时在线的私人小说库。

1. SoNovel 是什么？它解决了什么真问题？

在深入部署之前，我们必须先理解 SoNovel 的定位。它不是一个“又一个小说网站源码”，而是一个面向个人的小说内容聚合与管理中间件。

传统在线阅读的痛点：

• 平台依赖性强：小说存放在第三方服务器，平台关闭或书籍下架，内容即消失。
• 体验割裂：广告、会员弹窗、格式不统一，打断阅读沉浸感。
• 数据孤岛：在不同平台上的书架、阅读进度、笔记无法互通。
• 格式限制：通常只能在线看，难以导出为 ePub、TXT 等通用格式进行存档或在其他设备阅读。

SoNovel 的核心解决方案：

1. 统一搜索入口：聚合了多个公开的小说源站，你只需要在 SoNovel 里搜索一次，它帮你并行查询多个源站，返回最全的结果。
2. 内容本地化：搜索到的小说，可以直接在线阅读。更重要的是，你可以一键将整本书或指定章节下载到你的服务器本地，生成标准 ePub 或 TXT 文件。从此，这本书就真正属于你了。
3. 纯净阅读器：提供基于 Web 的阅读界面，无任何广告，支持字体、背景、进度保存等个性化设置。
4. Docker 化部署：这是降低使用门槛的关键。SoNovel 将前端（Vue）、后端（Spring Boot）、数据库（MySQL/PostgreSQL）等所有组件打包成 Docker 镜像和编排文件。你不需要分别安装配置 Node.js、Java、MySQL，只需要安装 Docker，然后一条命令即可启动整个系统。

所以，SoNovel 的真正价值在于：它通过技术手段，将互联网上分散、不稳定的小说资源，抓取、转换并固化到你个人可控的存储中，同时提供了一个优雅的管理和消费界面。这本质上是一种“数据归档”和“体验优化”的行为。

2. 核心概念与架构解析

要更好地使用和运维 SoNovel，了解其核心组件和工作原理很有必要。

2.1 核心组件

一个标准的 SoNovel 部署包含以下服务：

• 前端 (Frontend)：通常是一个基于 Vue.js 或 React 的单页面应用（SPA）。负责提供用户界面，包括搜索框、书架、阅读器、设置页面等。用户通过浏览器访问的就是它。
• 后端 API (Backend)：通常基于 Java (Spring Boot) 或 Python (FastAPI) 构建。它是系统的“大脑”，负责处理业务逻辑：接收前端的搜索请求、调用爬虫模块、管理书籍和章节信息、处理下载任务、与数据库交互等。
• 数据库 (Database)：用于持久化存储数据。主要存储：
  • 用户信息（如果支持多用户）。
  • 书籍元数据（书名、作者、封面、简介）。
  • 书架信息。
  • 阅读进度。
  • 下载任务记录。
  • 系统配置。
• 爬虫/解析器 (Crawler/Parser)：这是 SoNovel 的“手”和“眼睛”。它内置于后端或作为独立微服务，负责根据规则去第三方小说网站抓取网页、解析 HTML 结构，提取出纯净的正文、章节标题等信息。这是技术核心，也是容易因网站改版而失效的部分。

2.2 数据流与工作原理

1. 用户搜索：在前端输入书名 -> 前端请求后端 API -> 后端调用爬虫模块，并发查询多个预配置的“源站”（即小说网站）。
2. 结果聚合：爬虫从各源站获取搜索结果列表（书名、作者、链接），后端去重、排序后返回给前端展示。
3. 书籍详情：用户点击某本书 -> 前端请求书籍详情 -> 后端爬虫访问该书籍目录页，解析出所有章节列表并返回。
4. 在线阅读：用户点击某章节 -> 前端请求章节内容 -> 后端爬虫访问章节页，解析出正文，并可能进行格式清洗（去广告、优化段落），然后返回给前端阅读器渲染。
5. 内容下载：用户触发下载 -> 后端创建下载任务 -> 爬虫按顺序抓取所有章节内容 -> 后端将内容组装、格式化为 ePub/TXT 文件 -> 文件存储在服务器指定目录（如./downloads）-> 前端提供下载链接。

2.3 Docker 在其中的角色

Docker 将上述所有组件（前端、后端、数据库）以及它们的运行环境（Node.js 运行时、JVM、MySQL 服务）分别封装成独立的容器（Container）。通过docker-compose.yml文件定义它们之间的关系（谁依赖谁、如何通信、端口映射、数据卷挂载）。

• 环境隔离：你的宿主机不需要安装 Java、Node.js，避免了环境冲突。
• 一键部署：docker-compose up -d命令就能按定义好的顺序启动所有服务。
• 易于迁移：整个应用可以轻松地从你的电脑迁移到云服务器或 NAS。
• 版本管理：可以方便地切换或升级 SoNovel 的版本。

理解了这个架构，在后续部署和排错时，你就能清楚地知道问题可能出在哪个环节。

3. 环境准备：安装 Docker 与 Docker Compose

这是所有步骤的基础。我们将分别介绍在Linux（Ubuntu/CentOS）和Windows上的安装方法。请根据你的系统选择。

3.1 Linux 系统安装（以 Ubuntu 22.04 为例）

通过 SSH 连接到你的 Linux 服务器或打开终端。

步骤一：卸载旧版本（如有）

sudo apt-get remove docker docker-engine docker.io containerd runc

步骤二：安装依赖包并添加 Docker 官方 GPG 密钥

sudo apt-get update sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

步骤三：设置稳定版仓库

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

sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

步骤五：验证安装

sudo docker --version sudo docker compose version # 注意，这是插件版的 `docker compose`，不是独立的 `docker-compose`

如果看到版本号输出，说明 Docker 和 Compose 插件安装成功。

步骤六：（可选但推荐）将当前用户加入 docker 组避免每次命令都要加sudo。

sudo groupadd docker # 如果 docker 组已存在，会提示，可忽略 sudo usermod -aG docker $USER newgrp docker # 刷新组权限，或直接退出终端重新登录 docker run hello-world # 测试无需 sudo 运行容器

如果看到 “Hello from Docker!” 等信息，说明配置成功。

3.2 Windows 系统安装

对于 Windows 10/11 专业版、企业版或教育版，推荐使用Docker Desktop。

步骤一：开启 Hyper-V 和容器功能

1. 搜索“启用或关闭 Windows 功能”。
2. 勾选Hyper-V和容器两个选项，点击确定，重启电脑。
   • 如果找不到 Hyper-V，可能是因为你的 Windows 版本是家庭版，需要额外步骤（如安装 WSL2）或使用 Docker Toolbox（已过时）。建议升级系统或考虑在 Linux 虚拟机中部署。

步骤二：下载并安装 Docker Desktop

1. 访问 Docker 官网下载 Docker Desktop for Windows 安装包。
2. 运行安装程序，按照向导完成安装。安装过程中会要求重启。
3. 重启后，在开始菜单找到 Docker Desktop 并运行。首次启动需要接受服务条款，等待 Docker 服务启动完成（系统托盘会出现鲸鱼图标）。

步骤三：验证安装打开 PowerShell 或命令提示符（CMD）：

docker --version docker compose version

同样，看到版本号即表示成功。

步骤四：配置镜像加速（国内用户强烈建议）为了提升拉取镜像的速度，需要配置国内镜像源。

1. 右键点击系统托盘 Docker 图标 -> Settings (设置)。
2. 选择 Docker Engine。
3. 在配置 JSON 文件中，添加或修改registry-mirrors项。例如使用阿里云镜像（需先登录阿里云容器镜像服务获取专属加速地址）：

{ "registry-mirrors": [ "https://your-id.mirror.aliyuncs.com" ] }

4. 点击 “Apply & Restart”。

3.3 安装总结与常见问题

• Linux 虚拟化支持：如果在虚拟机或云服务器上安装，请确保 BIOS/固件中已开启虚拟化支持（如 Intel VT-x/AMD-V）。对于大多数云服务器，此项默认开启。
• Windows 家庭版：可先安装 WSL2 (Windows Subsystem for Linux 2)，然后在 WSL2 的 Linux 发行版中安装 Docker。Docker Desktop 支持与 WSL2 集成。
• 端口冲突：确保 SoNovel 将要使用的端口（如 80, 8080, 3306）在宿主机上没有其他程序占用。

环境准备好后，我们就可以进入核心的部署环节了。

4. 获取与部署 SoNovel

SoNovel 是一个开源项目，代码通常托管在 GitHub 或 Gitee 上。部署的核心是获取其docker-compose.yml配置文件。

4.1 获取部署文件

假设项目仓库地址为https://github.com/your-name/SoNovel（请替换为实际仓库地址）。我们通过 Git 克隆或直接下载配置文件。

方法一：使用 Git（推荐）

# 克隆整个仓库（包含源码，便于后续自定义） git clone https://github.com/your-name/SoNovel.git cd SoNovel # 查看目录结构，通常部署文件在根目录或 docker/ 目录下 ls -la

方法二：直接下载编排文件如果只需要部署，可以直接下载docker-compose.yml和可能需要的环境变量文件.env。

# 创建一个专用目录 mkdir -p ~/sonovel && cd ~/sonovel # 使用 curl 下载（假设文件直链已知） curl -O https://raw.githubusercontent.com/your-name/SoNovel/main/docker-compose.yml curl -O https://raw.githubusercontent.com/your-name/SoNovel/main/.env.example cp .env.example .env # 复制一份作为自定义配置

4.2 解析 docker-compose.yml

在启动前，理解这个文件至关重要。一个典型的 SoNoveldocker-compose.yml可能如下所示：

version: '3.8' services: mysql: image: mysql:8.0 container_name: sonovel-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:-sonovel123} MYSQL_DATABASE: sonovel MYSQL_USER: sonovel MYSQL_PASSWORD: ${DB_PASSWORD:-sonovel123} volumes: - ./data/mysql:/var/lib/mysql - ./config/mysql/conf.d:/etc/mysql/conf.d ports: - "3306:3306" networks: - sonovel-network backend: image: your-name/sonovel-backend:latest container_name: sonovel-backend restart: unless-stopped depends_on: - mysql environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/sonovel?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai SPRING_DATASOURCE_USERNAME: sonovel SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD:-sonovel123} # 其他后端配置... volumes: - ./downloads:/app/downloads # 挂载下载目录 - ./logs/backend:/app/logs ports: - "8080:8080" networks: - sonovel-network frontend: image: your-name/sonovel-frontend:latest container_name: sonovel-frontend restart: unless-stopped depends_on: - backend environment: VITE_API_BASE_URL: http://backend:8080/api # 前端调用后端的地址（容器内网络） ports: - "80:80" networks: - sonovel-network networks: sonovel-network: driver: bridge volumes: mysql-data:

关键点解读：

1. 服务定义：定义了三个服务mysql,backend,frontend。
2. 镜像来源：image字段指定了每个服务使用的 Docker 镜像。你需要确认这些镜像在 Docker Hub 或其它仓库中是否可用。有时项目需要你自己构建镜像。
3. 环境变量：environment部分用于配置服务。${DB_PASSWORD:-sonovel123}表示优先使用.env文件中定义的DB_PASSWORD变量，如果未定义则使用默认值sonovel123。务必修改默认密码！
4. 数据持久化：volumes将容器内的目录（如/var/lib/mysql,/app/downloads）挂载到宿主机的目录（如./data/mysql,./downloads）。这样即使容器删除，数据也不会丢失。
5. 网络：所有服务加入自定义的sonovel-network，使得它们可以通过服务名（如mysql,backend）相互访问。
6. 端口映射：ports将容器端口映射到宿主机端口。例如80:80表示访问宿主机的 80 端口就等于访问前端容器的 80 端口。

4.3 自定义配置 (.env 文件)

编辑项目目录下的.env文件，这是集中管理配置的地方。

# .env 文件示例 # 数据库配置 DB_ROOT_PASSWORD=YourStrongRootPassword123! DB_PASSWORD=YourStrongDBPassword456! # 后端服务配置（示例） BACKEND_PORT=8080 JWT_SECRET=YourVeryLongAndComplexJwtSecretKeyHere # 前端服务配置（示例） FRONTEND_PORT=80 # 下载路径（相对于宿主机） DOWNLOAD_PATH=./downloads

安全提醒：务必修改所有默认密码和密钥！使用强密码。

4.4 启动 SoNovel 服务

一切就绪后，在包含docker-compose.yml的目录下，执行启动命令：

# 在后台启动所有服务 docker compose up -d

-d参数代表“detached”，让服务在后台运行。

执行后，Docker 会执行以下操作：

1. 检查本地是否存在所需的镜像（如mysql:8.0,your-name/sonovel-backend:latest），如果不存在则从 Docker Hub 拉取。
2. 按照依赖顺序（depends_on）创建并启动容器。
3. 创建网络和数据卷。

查看服务状态：

docker compose ps

你应该看到三个服务的状态都是Up。

查看实时日志（可用于排错）：

# 查看所有服务日志 docker compose logs -f # 查看特定服务日志，如后端 docker compose logs -f backend

5. 访问与初步配置

5.1 访问 SoNovel

根据docker-compose.yml中的端口映射：

• 前端界面：打开浏览器，访问http://你的服务器IP地址或http://localhost（如果在本机部署）。你应该能看到 SoNovel 的首页。
• 后端 API：通常可以通过http://你的服务器IP地址:8080访问后端提供的 API 文档（如 Swagger UI），但这取决于项目是否开启。

5.2 初始化与登录

首次访问，系统可能会引导你进行初始化设置，如创建管理员账户。请按照页面提示操作。如果项目默认提供了账户（如 admin/admin），请务必在登录后第一时间修改密码。

5.3 配置小说源（关键步骤）

SoNovel 的核心功能依赖于“小说源”。这些源是预定义的规则，告诉爬虫如何去特定网站抓取数据。

1. 登录后，在管理界面或设置页面找到“源管理”、“书源配置”或类似选项。
2. 项目初始可能内置了一些源，也可能需要你手动导入。开源社区通常会维护一个书源 JSON 列表。
3. 你可以从项目的 Wiki、Issues 或相关社区找到最新的书源分享链接。格式通常是一个 JSON 数组，包含多个源的名称、URL、解析规则等。
4. 在 SoNovel 界面中，选择“导入书源”，粘贴 JSON 内容或上传文件。
5. 导入后，尝试搜索一本你知道的小说，测试源是否有效。

注意：小说网站经常改版，书源可能会失效。维护有效的书源是持续使用 SoNovel 的一个小成本。活跃的社区是获取更新书源的最佳途径。

6. 核心功能体验与代码级解析

让我们通过一个完整的用户旅程，体验 SoNovel 的核心功能，并理解其背后的技术实现。

6.1 搜索与发现

在首页搜索框输入“诡秘之主”。点击搜索后，前端会向后端发送一个 API 请求。前端伪代码逻辑：

// 假设在 Vue 组件中 async searchNovel(keyword) { this.loading = true; try { const response = await axios.get(`/api/search?keyword=${encodeURIComponent(keyword)}`); this.searchResults = response.data; // 假设返回 { books: [...] } } catch (error) { console.error('搜索失败:', error); this.$message.error('搜索失败，请检查网络或源站'); } finally { this.loading = false; } }

后端处理流程：

1. 接收/api/search请求，解析关键词。
2. 从数据库或配置中加载所有启用的“书源”。
3. 并发抓取：为每个书源启动一个异步任务，使用 HTTP 客户端（如 OkHttp, HttpClient）访问该源站的搜索接口或模拟搜索页面，并携带关键词。
4. 解析 HTML：使用 Jsoup（Java）或 BeautifulSoup（Python）等库，根据该书源的预定义规则（CSS 选择器、XPath）解析返回的 HTML，提取书籍列表（书名、作者、链接、最新章节等）。
5. 结果聚合与去重：将所有源站的结果收集起来，根据书名和作者进行去重和排序（如按来源权重、更新时间）。
6. 将处理后的列表返回给前端。

6.2 书籍详情与目录获取

点击搜索结果中的某本书，进入详情页。前端会请求书籍详情和目录。

async fetchBookDetail(bookId, sourceUrl) { const response = await axios.get(`/api/book/detail`, { params: { bookId, source: sourceUrl } }); this.bookInfo = response.data.info; this.chapters = response.data.chapters; // 章节列表 }

后端会根据sourceUrl找到对应的书源规则，然后：

1. 访问该书的目录页。
2. 解析出所有章节的标题和 URL。
3. 可能将书籍元信息（封面、简介、作者）和章节列表缓存到数据库中，以减少对源站的重复请求。
4. 返回结构化的数据。

6.3 在线阅读

点击某一章节，阅读器页面会请求章节内容。

async fetchChapterContent(chapterUrl, source) { const response = await axios.get(`/api/chapter/content`, { params: { chapterUrl, source } }); this.content = response.data.content; this.title = response.data.title; // 渲染到阅读器组件 }

后端爬虫的工作：

1. 访问chapterUrl。
2. 根据书源规则，定位正文所在的 HTML 元素（如div#content）。
3. 内容清洗：移除无关元素（广告、推荐阅读、脚本、样式标签）、净化 HTML 标签、统一段落格式。
4. 可能进行简繁转换、修正错别字等后处理。
5. 将纯净的文本或 HTML 返回。

6.4 整本下载（核心价值实现）

在书籍详情页，点击“下载全书”或类似按钮。

async downloadBook(bookId, format = 'epub') { const response = await axios.post(`/api/book/download`, { bookId, format, // 可能包含章节范围 }, { responseType: 'blob' }); // 重要：请求二进制流 // 创建下载链接 const url = window.URL.createObjectURL(new Blob([response.data])); const link = document.createElement('a'); link.href = url; link.setAttribute('download', `《${this.bookInfo.name}》.${format}`); document.body.appendChild(link); link.click(); link.remove(); window.URL.revokeObjectURL(url); }

后端处理下载是一个异步任务：

1. 接收下载请求，验证参数。
2. 在数据库中创建一个“下载任务”记录，状态为“处理中”。
3. 启动异步任务（如通过@Async注解或消息队列）： a. 根据书源，依次抓取所有章节内容（可能需控制并发速度，避免被封 IP）。 b. 将所有章节内容、书籍元数据、封面图片等收集齐全。 c. 调用 EPUB/TXT 生成库（如 Java 的epublib，Python 的EbookLib），按照标准格式组装文件。 d. 将生成的文件写入到挂载的卷目录（如/app/downloads/《诡秘之主》.epub）。 e. 更新数据库中的任务状态为“完成”，并记录文件路径。
4. 前端可以轮询任务状态，完成后即可通过另一个 API（如/api/download/file/{taskId}）获取到实际的文件。

这就是 SoNovel 的核心闭环：从互联网抓取 -> 清洗 -> 聚合 -> 本地化存储。

7. 高级配置与最佳实践

部署成功只是第一步，要让 SoNovel 稳定、安全、高效地运行，还需要进行一些配置和优化。

7.1 数据持久化与备份

这是最重要的实践！确保你的数据（数据库、下载的小说文件）在容器重建后不会丢失。

• 检查 volumes 挂载：确认docker-compose.yml中已将关键数据目录挂载到宿主机。
  • ./data/mysql:/var/lib/mysql：数据库文件。
  • ./downloads:/app/downloads：下载的小说文件。
• 定期备份：编写脚本定期备份./data和./downloads目录到其他存储或云盘。

  # 简单备份脚本示例 backup.sh #!/bin/bash BACKUP_DIR="/path/to/your/backup" PROJECT_DIR="/home/user/sonovel" DATE=$(date +%Y%m%d_%H%M%S) tar -czf "$BACKUP_DIR/sonovel_backup_$DATE.tar.gz" -C "$PROJECT_DIR" data downloads # 可以添加命令将备份文件上传到云存储 echo "Backup completed: $BACKUP_DIR/sonovel_backup_$DATE.tar.gz"

  使用crontab -e设置定时任务，例如每周日凌晨3点执行：

  0 3 * * 0 /bin/bash /path/to/backup.sh

7.2 配置更新与版本升级

SoNovel 项目会持续更新，修复 bug 或增加新功能。

1. 拉取最新镜像：

   cd ~/sonovel docker compose pull # 拉取 docker-compose.yml 中定义的最新镜像

2. 重启服务：

   docker compose up -d # 使用新镜像重新创建容器

3. 数据库迁移：如果新版本包含数据库结构变更，后端服务启动时通常会通过 Flyway 或 Liquibase 等工具自动执行迁移脚本。确保在升级前备份数据库。
4. 回滚：如果新版本有问题，可以修改docker-compose.yml中的镜像标签回退到旧版本，然后重新docker compose up -d。

7.3 安全加固

• 修改默认密码：再次强调，修改.env文件中的DB_ROOT_PASSWORD、DB_PASSWORD、JWT_SECRET等。
• 限制访问：
  • 防火墙：如果部署在公网服务器，使用防火墙（如ufw）只开放必要的端口（如 80, 443）。

  sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw enable

  • 反向代理：不要直接将 Docker 容器的端口（如 8080）映射到公网。使用 Nginx 或 Caddy 作为反向代理，绑定域名并配置 SSL 证书（HTTPS）。

  # Nginx 配置示例 (部分) server { listen 80; server_name novel.yourdomain.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name novel.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://localhost:80; # 指向 SoNovel 前端容器的宿主机端口 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } # 可选：将 /api 代理到后端 # location /api { # proxy_pass http://localhost:8080; # } }

• 定期更新：关注项目安全更新，及时升级镜像。

7.4 性能优化

• 调整爬虫速率：在 SoNovel 的后端配置中，通常可以设置请求延迟，避免对源站造成过大压力，也降低 IP 被封的风险。
• 数据库优化：对于书籍和章节数据量非常大的情况，可以考虑为频繁查询的字段（如书名、作者）添加数据库索引。这可能需要你直接操作 MySQL 容器。

  docker exec -it sonovel-mysql mysql -u sonovel -p # 进入 MySQL 后 USE sonovel; CREATE INDEX idx_book_name ON book(name); CREATE INDEX idx_book_author ON book(author);

• 资源限制：在docker-compose.yml中可以为容器设置资源限制，防止某个服务耗尽主机资源。

  services: backend: # ... 其他配置 deploy: resources: limits: cpus: '1.0' memory: 1G reservations: cpus: '0.5' memory: 512M

8. 常见问题与排查思路

部署和使用过程中，你可能会遇到一些问题。以下是常见问题的排查指南。

通用排查命令：

• docker compose logs -f [service]：实时查看服务日志。
• docker exec -it [container_name] sh：进入容器内部。
• docker compose restart [service]：重启单个服务。
• docker compose down && docker compose up -d：彻底停止并重新启动所有服务（不会删除数据卷）。

9. 总结：从工具到理念

通过 Docker 部署 SoNovel，你收获的不仅仅是一个私人小说库。这个实践过程，是一次完整的、微缩版的现代应用部署演练：

1. 理解容器化价值：你亲身体验了 Docker 如何将复杂的多服务应用标准化、隔离化，实现“一次构建，处处运行”。
2. 掌握服务编排：通过docker-compose.yml，你定义了服务间的依赖、网络和数据流，这是理解微服务架构的基础。
3. 直面真实问题：从环境配置、网络调试、权限设置到故障排查，你解决的问题正是运维工作中的日常。
4. 践行数据主权：你将原本散落在互联网各处的数据，通过技术手段归档到本地，这是对数字时代“所有权”的一次具体实践。

SoNovel 本身可能随着时间推移，其内置的书源会失效，但其架构思想和实现模式具有参考价值。你可以举一反三：

• 扩展思路：能否为其添加音频朗读功能（TTS）？能否集成 Calibre 进行更专业的电子书管理？能否开发手机客户端？
• 技术深化：研究其爬虫规则引擎，学习如何编写一个健壮的解析器。分析其前后端分离的 API 设计。学习它如何使用异步任务处理耗时操作（如下载）。
• 运维进阶：尝试使用 Kubernetes 来管理 SoNovel，实现高可用和自动伸缩。或者将其与自动化工具（如 Watchtower）集成，实现自动更新。

最后，请记住：技术是工具，目的是服务于人。在享受自建服务带来的自由和掌控感的同时，也请尊重版权，合理使用。将 SoNovel 作为个人学习、研究和存档的工具，避免用于任何商业或侵权用途。

现在，你的私人小说库已经上线。是时候去下载那些你一直想珍藏的故事了。如果在部署过程中遇到任何问题，回顾本文的“常见问题”部分，或者去该项目的开源社区寻找答案和同好。祝你阅读愉快！