韩国服务器使用Docker Compose,首次部署多容器应用要检查哪些条件?

发布人:A5数据发布时间:2026-10-15 14:26阅读量:89

首次在韩国服务器上使用 Docker Compose 部署多容器应用,要先确认六类条件:服务器能够运行 Docker、系统与安装源匹配、镜像仓库可达、资源和磁盘有余量、容器之间的连接方式正确,以及对外端口和数据持久化已经规划好。只有 docker compose up 执行成功还不够,还需要验证数据库就绪、应用能够连接数据库、HTTP 响应正常,并确认停止或重建容器不会丢失数据。

下面以一台全新的 Ubuntu 22.04 或 24.04 韩国服务器为实施环境,使用 Docker Engine 和 Compose 插件,首次启动 WordPress 与 MariaDB 两个容器。示例先将网站端口绑定到本机回环地址,验证多容器应用可以运行,不直接开放公网安装页面;域名、HTTPS 和正式业务上线不在本次操作范围内。已有 Docker 或已有业务的服务器,应先核对现状,不直接套用安装和覆盖命令。

一、准备条件:先检查系统、资源与网络

1. 确认服务器允许运行容器

使用具有 sudo 权限的账户登录,先执行:

cat /etc/os-release
uname -m
systemd-detect-virt
free -h
df -h / /var/lib
df -i / /var/lib

重点判断以下结果:

检查对象可以继续的条件需要暂停的情况
操作系统确认为本文适用的 Ubuntu 版本Debian、Rocky Linux 等其他发行版不能照搬软件源配置
CPU 架构x86_64 或 aarch64,且目标镜像提供对应架构镜像不支持服务器架构
虚拟化环境通常可使用独立服务器或允许容器运行的虚拟机受限容器型实例没有必要的内核、网络或权限能力
内存本示例可从约 2 GB 内存起步验证已有进程占用大部分内存,启动数据库可能触发内存不足
磁盘与 inode能容纳镜像、数据库、网站文件和日志根分区接近写满,或 inode 已耗尽

约 2 核 CPU、2 GB 内存和 20 GB 可用磁盘可以作为这个示例的准备参考,不代表正式网站的容量要求。插件数量、访问量、图片上传和数据库增长都会改变资源需求。

systemd-detect-virt 输出 kvm 等结果,并不意味着 Docker 一定不能运行;需要关注的是服务商是否限制容器能力。不要为了通过检查,在已有生产服务器上直接修改内核、挂载选项或安全策略。

2. 检查韩国服务器的实际网络路径

韩国机房位置不会改变 Compose 的服务发现和容器网络机制,但会影响软件源、镜像仓库以及业务访问路径。需要分别检查,不能用一次延迟测试代替全部判断。

getent ahosts download.docker.com
getent ahosts registry-1.docker.io
timedatectl status

预期情况是域名可以解析,系统时间基本准确。HTTPS 软件源和镜像拉取都依赖证书验证,错误的系统时间可能导致连接失败。

还要从服务器管理面板确认:

  • 出站 DNS 和 HTTPS 连接没有被阻断。
  • SSH 管理端口已经按管理来源放行。
  • 没有提前向公网开放数据库端口。
  • 如果后续接入网站入口,安全组规则与服务器上的入口监听方式一致。

镜像仓库可达,不等于面向中国大陆、韩国本地或其他地区的业务访问效果相同。应用验收应从实际访问地区检查;本次先验证服务器内部运行条件。

A5数据提供韩国首尔物理服务器租用,涵盖不同计算、存储及优化线路、国际线路方案,为WordPress与MariaDB这类多容器应用提供服务器资源基础。在网站服务与数据库共同运行的场景中,CPU、内存和磁盘资源可用于承载应用进程、数据库缓存、容器镜像及持久化业务数据,韩国地区的网络方案则可衔接韩国本地与跨境业务的访问需求。

3. 排除已有服务冲突

command -v docker || true
sudo ss -lntp | grep -E ':(80|443|8080|3306)\b' || true

若已经安装 Docker,继续检查:

sudo docker version
sudo docker compose version
sudo docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Ports}}'

不要在已有 Docker 环境中直接卸载旧软件包或清理容器。特别是正在运行数据库时,所谓“重新安装一遍”可能影响其他业务。

本文使用主机 8080 端口。如果它已被占用,可以统一替换成其他空闲端口。容器内的网站仍监听 80,两者不必相同。

二、安装 Docker Engine 与 Compose 插件

1. 在全新 Ubuntu 上配置软件源

下面的操作会新增 Docker 软件源并安装系统软件包,适用于尚未安装 Docker 的服务器。已有安装应先确认来源、版本和兼容性,不混用不同来源的软件包。

为避免给普通用户授予接近主机管理员级别的 Docker 控制权限,本次进入管理员 Shell 操作,不添加用户到 docker 组:

sudo -i

安装依赖并配置密钥:

apt-get update
apt-get install -y ca-certificates curl openssl

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

. /etc/os-release

cat > /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: ${VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

以上文件写入会覆盖同名文件,权限调整仅作用于新增的公开签名密钥。若这些路径已有文件,应先备份并确认来源,不直接覆盖。

接着安装:

apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker

这里使用 Compose 插件,命令形式为 docker compose,不是旧式的独立命令 docker-compose。

2. 验证安装结果

systemctl is-active docker
docker version
docker compose version
docker run --rm hello-world

预期结果分别是:

  • Docker 服务状态为 active。
  • docker version 同时显示客户端和服务端信息。
  • Compose 插件能够返回版本号。
  • 测试容器可以拉取并运行。

如果 Compose 可以返回版本,但测试容器拉取失败,说明命令工具已安装,镜像访问条件仍未满足。此时应处理网络、认证或仓库限流问题,而不是反复安装 Docker。

不要通过公开 Docker 管理端口解决连接问题。本文所有管理命令都在服务器本地执行。

三、编写 Compose 配置:明确依赖、网络与数据位置

1. 创建独立项目目录和密码文件

下面使用新的专用目录。若目录已经存在,应先检查其中内容,不能继续覆盖已有配置。

mkdir /opt/a5-compose-first
cd /opt/a5-compose-first

生成数据库密码:

(
  umask 077
  cat > .env <<EOF
DB_NAME=wordpress
DB_USER=wordpress
DB_PASSWORD=$(openssl rand -hex 24)
DB_ROOT_PASSWORD=$(openssl rand -hex 24)
EOF
)

ls -l .env

.env 应仅允许管理员读写。这里使用十六进制随机密码,避免示例中的特殊字符引起 Shell 或 Compose 插值歧义。

.env 不是加密保险箱;管理员、Docker 管理者以及部分诊断工具仍可能读取相关环境变量。不要提交到公开代码仓库,也不要把展开后的配置发送到公开工单。

2. 创建两个服务

创建 compose.yaml:

三、编写 Compose 配置:明确依赖、网络与数据位置配图

name: a5first

services:
  db:
    image: mariadb:11.4
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: ${DB_NAME:?DB_NAME is required}
      MARIADB_USER: ${DB_USER:?DB_USER is required}
      MARIADB_PASSWORD: ${DB_PASSWORD:?DB_PASSWORD is required}
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:?DB_ROOT_PASSWORD is required}
    volumes:
      - db_/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

  web:
    image: wordpress:php8.3-apache
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_NAME: ${DB_NAME:?DB_NAME is required}
      WORDPRESS_DB_USER: ${DB_USER:?DB_USER is required}
      WORDPRESS_DB_PASSWORD: ${DB_PASSWORD:?DB_PASSWORD is required}
    volumes:
      - wp_/var/www/html
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test:
        - CMD
        - php
        - -r
        - "exit(@fsockopen('127.0.0.1', 80) ? 0 : 1);"
      interval: 10s
      timeout: 5s
      retries: 6
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  db_
  wp_

这些标签用于演示部署方式,并非不可变版本。正式使用前,应核验镜像支持状态、架构和应用兼容性,记录实际拉取的摘要;需要可重复部署时,使用验证过的固定版本及摘要。

3. 理解配置中的五个关键条件

数据库地址使用 db:3306,不是 127.0.0.1:3306。 两个服务会加入 Compose 创建的项目网络,db 是可解析的服务名。应用容器中的回环地址指向应用容器自身,不是数据库容器,也不是服务器主机。

数据库没有配置 ports。 应用通过容器网络访问数据库,不需要把 3306 映射到公网。

启动顺序不等于服务就绪。 condition: service_healthy 要求数据库通过健康检查后再启动应用。但这是启动阶段的依赖控制,不代表数据库以后故障时,Compose 会自动重启所有依赖服务。

网站健康检查只证明端口可连接。 这里没有把“Apache 接受连接”冒充成“WordPress 和数据库完全正常”,下一节还要检查应用连接与 HTTP 响应。

数据卷独立于容器生命周期。 数据库文件和网站文件分别写入命名卷。重建容器通常不会删除这些卷,但换项目名可能创建另一组新卷,让应用看起来像重新安装。

四、启动并逐项验证:从配置正确到应用可访问

1. 先校验配置,再拉取镜像

在项目目录中执行:

cd /opt/a5-compose-first
docker compose config --quiet
docker compose config --services
docker compose pull

预期是配置校验没有报错,服务列表包含 db 和 web,两个镜像都拉取完成。

${变量:?提示} 可以防止关键变量缺失或为空,但不会验证密码是否足够安全。也不要随意执行并传播完整的 docker compose config 输出,因为其中可能包含已经展开的密码。

拉取成功后记录镜像信息:

docker image inspect mariadb:11.4 wordpress:php8.3-apache \
  --format '{{.Id}} {{json .RepoDigests}}'

保留结果有助于以后判断重新拉取是否改变了实际镜像。

2. 启动容器并观察状态

docker compose up -d
docker compose ps
docker compose logs --tail=100 db web

首次数据库初始化需要时间,状态从 starting 转为 healthy 是正常过程。不要因为刚启动时尚未就绪,就连续执行重启。

下面只是预期状态的示意,不是实际执行记录:

NAME            SERVICE   STATUS
a5first-db-1    db        Up ... (healthy)
a5first-web-1   web       Up ... (healthy)

若状态持续为 Restarting、Exited 或 unhealthy,应先检查日志。restart: unless-stopped 处理的是进程退出后的重启策略,单纯被标记为不健康,并不会自动触发重启。

3. 从应用容器验证数据库连接

执行以下只读检查:

docker compose exec -T web php -r '
$db = new mysqli(
    "db",
    getenv("WORDPRESS_DB_USER"),
    getenv("WORDPRESS_DB_PASSWORD"),
    getenv("WORDPRESS_DB_NAME"),
    3306
);
$row = $db->query("SELECT 1 AS db_ok")->fetch_assoc();
echo "db_ok=" . $row["db_ok"] . PHP_EOL;
'

预期输出:

db_ok=1

这一步同时验证了容器服务名解析、数据库端口连通性、应用账户认证和目标数据库权限,比单独看到数据库容器 healthy 更接近实际使用条件。

四、启动并逐项验证:从配置正确到应用可访问配图

它不会写入业务数据,也不等同于完整业务事务测试。

4. 验证 HTTP 响应与端口边界

curl --max-time 10 -sS \
  -D /tmp/a5first-http.headers \
  -o /tmp/a5first-http.html \
  http://127.0.0.1:8080/

head -n 10 /tmp/a5first-http.headers
docker compose port web 80

首次访问可能返回 200,也可能返回指向安装页面的 301 或 302。重定向并不自动说明出错,需要检查 Location 是否符合预期。

继续检查安装页面:

curl --max-time 10 -sS \
  -o /dev/null \
  -w 'HTTP %{http_code}\n' \
  http://127.0.0.1:8080/wp-admin/install.php

在本例尚未完成网站安装的状态下,通常应得到可正常打开安装页面的响应。若是 500,需结合应用日志判断,不能只检查 TCP 端口。

端口检查应显示绑定于 127.0.0.1:8080。此时公网访问“服务器 IP:8080”不通是预期的安全边界,不是部署失败。

不要在本地测试地址上完成正式站点初始化,以免把站点地址配置成回环地址。后续若已有同机 HTTPS 入口,可让该入口连接 127.0.0.1:8080;完成域名和访问边界检查后,再进行网站初始化。本次验收止于容器、数据库连接和 HTTP 安装页面正常。

五、常见失败处理:先低风险检查,再考虑修改

1. 镜像拉取失败

先区分 DNS、HTTPS 和仓库响应:

getent ahosts registry-1.docker.io
curl -I --connect-timeout 10 https://registry-1.docker.io/v2/
docker compose pull

仓库接口返回 401 Unauthorized,通常说明 HTTPS 请求已经到达接口,但该接口需要认证,不能直接判定为网络不通。若出现 429,则应检查仓库限流和账户认证条件。

五、常见失败处理:先低风险检查,再考虑修改配图

  • 域名不解析:检查服务器 DNS 配置。
  • 连接超时:检查出站规则与服务器到仓库的网络路径。
  • 证书验证失败:检查系统时间、CA 证书和网络中的异常证书替换。
  • 提示架构不匹配:更换支持本机架构的镜像,不强行运行不匹配版本。

不要通过关闭 TLS 验证或配置不可信仓库来“修好”拉取。需要内部镜像仓库时,应确认镜像来源和摘要一致。

2. 数据库迟迟不健康

docker compose logs --tail=200 db
docker inspect "$(docker compose ps -q db)" \
  --format '{{json .State.Health}}'
free -h
df -h /var/lib/docker
df -i /var/lib/docker

先看初始化是否仍在推进,再检查内存、磁盘和权限错误。如果 Docker 使用了自定义数据目录,应以 docker info 中的 Docker Root Dir 为准。

发现磁盘不足时,不要直接执行全局清理命令;先确认占用来自镜像、日志还是业务卷,避免删除其他项目的数据。

还要注意:MariaDB 的初始化变量主要在空数据目录首次初始化时生效。数据库卷已初始化后,仅修改 .env 密码,通常不会同步修改数据库内部账户,反而可能造成应用认证失败。

3. 数据库健康,但应用连接失败

先复用上一节的 PHP 连接测试,再查看:

docker compose logs --tail=200 web
docker compose exec -T web getent hosts db

服务名不能解析时,检查两个服务是否仍在同一个 Compose 项目网络中。认证失败时,检查应用环境变量与数据库已有账户是否一致;不要在公开终端截图中展示密码。

如果误改了密码配置,应恢复修改前的 .env,重新创建应用容器:

docker compose up -d web

这会使应用短暂不可用,但不会删除命名卷。恢复配置后,必须重新执行数据库连接测试。

4. HTTP 正常,但外部访问失败

本例只绑定本机回环地址,因此首先检查入口设计,而不是增加数据库端口或关闭防火墙。

若后续确实要改变网站端口绑定,应先备份 compose.yaml,确认安全组的目标端口、允许来源和 IPv6 规则,再修改并重新创建网站容器。回滚方式是恢复原来的回环地址绑定并执行 docker compose up -d web。

Docker 发布端口与主机防火墙规则之间存在交互,不能只看到 UFW 显示拒绝,就认定容器端口一定不可达。最终应从外部主机实测;数据库端口仍不应公开。

六、验收与回滚检查项

1. 首次运行的验收标准

可以按以下项目逐项记录:

  • [ ] 系统版本、CPU 架构和容器运行条件已经确认。
  • [ ] Docker 服务正常,Compose 插件可用。
  • [ ] 配置校验通过,镜像拉取完成并记录实际摘要。
  • [ ] 数据库健康,应用没有持续退出或重启。
  • [ ] 从应用容器执行 SELECT 1 成功。
  • [ ] 本机 HTTP 请求获得合理响应,安装页面可打开。
  • [ ] 网站端口只绑定预定地址,数据库没有公网映射。
  • [ ] 数据库和网站文件使用命名卷,项目名保持固定。
  • [ ] .env 未公开,配置与数据备份位置明确。

通过这些检查,可以确认多容器应用已经首次运行。但这不等于正式网站上线完成;公开提供服务前,还需落实 HTTPS、正式站点地址和相应的业务安全检查。

2. 停止前保存配置与数据

如果已经完成安装或写入业务数据,回滚前先备份。下面会暂停本项目的网站服务,但保持数据库运行,以减少备份期间的应用写入:

cd /opt/a5-compose-first
umask 077
BACKUP="/root/a5first-backup-$(date +%Y%m%d-%H%M%S)"
mkdir "$BACKUP"

cp -a compose.yaml .env "$BACKUP"/
docker compose stop web

导出数据库:

docker compose exec -T db sh -c \
  'export MYSQL_PWD="$MARIADB_ROOT_PASSWORD"; exec mariadb-dump -u root --single-transaction --routines --events --databases "$MARIADB_DATABASE"' \
  > "$BACKUP/database.sql"

这条命令适用于本示例的 MariaDB 环境,不修改数据库内容。必须确认命令成功、文件非空;失败产生的残缺文件不能算备份。

保存网站文件:

docker compose cp web:/var/www/html "$BACKUP/wordpress"
test -s "$BACKUP/database.sql" && echo "database dump is non-empty"
ls -ld "$BACKUP/wordpress"

备份包含密码、网站文件和数据库内容,应限制访问,并在确认有效后保存到服务器之外。文件存在只是初步检查,有效恢复仍需通过独立环境测试。

若继续使用本项目,重新启动网站:

docker compose up -d web

3. 首次部署失败时的回滚边界

若决定停止本次部署:

cd /opt/a5-compose-first
docker compose down

该操作停止并移除本项目容器及项目网络,默认保留命名卷。它不会回退数据库内部变更,也不会自动卸载 Docker。

首次排障不要添加 -v。 docker compose down -v 会删除本项目声明的命名卷,可能同时清除数据库和网站文件。只有明确确认数据可丢弃,或备份已经验证可恢复时,才考虑删除卷;删除后的恢复需要重新建卷并导入备份,不能靠重新执行 up 找回数据。

六、验收与回滚检查项配图

回滚完成后再核对:

  • [ ] 本项目容器和端口已停止,没有影响其他项目。
  • [ ] 命名卷仍在,配置和密码文件已保存。
  • [ ] 若曾修改入口或安全组,已恢复修改前的规则。
  • [ ] 若再次启动,继续使用原项目名和原数据卷。
  • [ ] 数据库密码、应用配置和镜像版本对应一致。
  • [ ] 没有把重新安装 Docker 或删除全部卷当作默认恢复手段。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3901.html

相关推荐