diff --git a/Debian 服务器核心配置指南:磁盘阵列与 Docker 安全启动.md b/Debian 服务器核心配置指南:磁盘阵列与 Docker 安全启动.md new file mode 100644 index 0000000..98c3ba4 --- /dev/null +++ b/Debian 服务器核心配置指南:磁盘阵列与 Docker 安全启动.md @@ -0,0 +1,170 @@ +# Debian 服务器核心配置指南:磁盘阵列与 Docker 安全启动 + +本文档旨在规范 Debian 服务器的底层存储挂载与容器服务启动流程,确保数据持久化安全及服务在系统异常恢复后的自动接管能力。 + +## 1 核心流程 +挂载磁盘阵列 +| + ↓ + 超过30秒后直接进系统 + | + ↓ +docker.service +| + ↓ +Requires + | + ↓ +docker-mount-guard.service +| +↓ +检查挂载 +| +↓ +成功 +| +↓ +Docker启动 + + +## 2 磁盘阵列挂载配置 + +为防止系统启动时因阵列未就绪导致进入紧急模式(Emergency Mode),必须采用 `nofail` 参数并正确配置文件系统类型。 + +### 2.1 确认阵列设备信息 +在修改配置前,务必确认阵列的 UUID 及文件系统类型,避免使用 `/dev/sdX` 等易变设备名。 + +```bash +# 查看阵列 UUID 及文件系统类型 +sudo blkid /dev/md0 +# 输出示例: /dev/md0: UUID="a1b2c3d4-..." TYPE="ext4" +``` + +### 2.2 编辑挂载配置 +编辑 `/etc/fstab` 文件,添加阵列挂载项。 + +```bash +sudo nano /etc/fstab +``` + +在文件末尾添加以下配置: + +```text +# Disk Array Mount Configuration +UUID=a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/data ext4 defaults,nofail,x-systemd.device-timeout=30s 0 2 +``` + +**关键参数说明:** +- `nofail`:**核心安全参数**。若阵列初始化失败或设备不存在,系统将跳过该挂载点继续启动,而非直接进入紧急模式。 +- `x-systemd.device-timeout=30s`:设置 systemd 等待设备就绪的超时时间,防止因阵列初始化慢导致启动超时。 +- `0 2`:禁用启动时自动检查(`0`),或设置为非根分区检查顺序(`2`),避免阵列过大导致启动阻塞。 + +### 2.3 验证配置 +**切勿直接重启**,必须先验证配置语法及挂载可用性。 + +```bash +# 验证 fstab 语法是否正确 +sudo findmnt --verify --verbose + +# 尝试重新挂载所有 fstab 条目(不中断当前会话) +sudo mount -a +``` + +> **注意**:若 `mount -a` 报错,请立即检查并修正 `/etc/fstab`,确认无误后方可重启。 + +## 3 开机 Docker 检查启动机制 + +为确保 Docker 服务在系统恢复后能自动拉起,并具备健康检查能力,需配置 Systemd 依赖与重启策略。 + +### 3.1 第一步:创建“安检脚本” +写个简单的 bash 脚本,专门检查你关心的那几个挂载点(/mnt/a1-files 等)。只要有一个没挂载,就报错退出。 +```bash +sudo nano /usr/local/bin/check-docker-mounts.sh +``` +把下面这段代码复制进去: +```bash +#!/bin/bash +# 定义需要检查的挂载点数组(包含你所有的阵列盘) +MOUNTS=( + "/mnt/a1-files" + "/mnt/a2-temp" + "/mnt/b1-variety" + "/mnt/c1-music" + "/mnt/c2-history" + "/mnt/c3-movie" + "/mnt/d1-tv-cn" + "/mnt/d2-manga" + "/mnt/d3-tv-jk" +) + +for mnt in "${MOUNTS[@]}"; do + # 检查该路径是否是一个真正的挂载点 + if ! mountpoint -q "$mnt"; then + echo "错误:挂载点 $mnt 未就绪!阻止 Docker 启动。" + exit 1 + fi +done + +echo "所有关键挂载点检查通过,允许 Docker 启动。" +exit 0 +``` +保存退出后,给它加上可执行权限: +```bash +sudo chmod +x /usr/local/bin/check-docker-mounts.sh +``` + +### 3.2 第二步:创建一个 systemd 服务来“拦截” Docker +我们要让系统在执行 Docker 之前,必须先跑一遍这个脚本。 +```bash +sudo nano /etc/systemd/system/docker-mount-guard.service +``` +把下面这段代码复制进去: +```bash +[Unit] +Description=Check Mount Points Before Docker Starts +Before=docker.service +RequiresMountsFor=/mnt/a1-files /mnt/a2-temp /mnt/b1-variety /mnt/c1-music /mnt/c2-history /mnt/c3-movie /mnt/d1-tv-cn /mnt/d2-manga /mnt/d3-tv-jk + +[Service] +Type=oneshot +ExecStart=/usr/local/bin/check-docker-mounts.sh +RemainAfterExit=yes + +[Install] +WantedBy=multi-user.target +``` +保存退出。 +### 3.3 第三步:让配置生效 +```bash +sudo systemctl daemon-reload +sudo systemctl enable docker-mount-guard.service +``` + +### 3.4 第四步:给 Docker 加上强依赖 +使用 tee 命令直接强行创建并写入这个文件,最暴力、最稳妥! +直接把下面这一整段复制到终端里敲回车: +```ash +sudo mkdir -p /etc/systemd/system/docker.service.d +sudo tee /etc/systemd/system/docker.service.d/override.conf > /dev/null << 'EOF' +[Unit] +Requires=docker-mount-guard.service +After=docker-mount-guard.service +EOF +``` +敲完之后,再敲一下这个让它生效: +```bash +sudo systemctl daemon-reload +``` +怎么验证它真的生效了? +直接看 systemd 的“最终合并结果”。你敲一下这个命令: +```bash +systemctl cat docker +``` +这个命令会把 Docker 的原始配置和你刚才写的 override 配置拼在一起显示出来。 +你拉到最下面,一定会看到类似这样的输出: +``` +[Unit] +Requires=docker-mount-guard.service +After=docker-mount-guard.service +``` +只要看到这段,就说明配置 100% 完美生效了!