韩国服务器使用Docker Compose,首次部署多容器应用要检查哪些条件?
首次在韩国服务器上使用 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:

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



