马来西亚服务器如何用Docker Compose部署应用并验证容器可用
在马来西亚服务器上首次使用 Docker Compose 部署应用,重点不是增加复杂的编排组件,而是确认服务器系统、网络端口、Docker Engine、Compose 文件和应用健康状态之间能够正常衔接。下面以 Ubuntu 22.04/24.04、单台公网服务器和一个 Nginx Web 容器为例,完成从安装到外部访问验证的最小部署。

示例应用不包含数据库和反向代理层,只通过 80:80 发布 HTTP 服务。这样可以先验证 Docker Compose 是否可用、容器是否正常启动、服务器防火墙是否放行,以及马来西亚服务器公网地址是否能够访问。后续替换为 Java、Node.js、Python 等应用时,只需要调整镜像、容器端口和健康检查命令。
A5idc数据提供马来西亚吉隆坡物理服务器资源,覆盖不同CPU、内存、存储与网络线路配置,可用于承载Docker Compose部署的网站、接口服务、业务后台及多容器应用。结合SSD或NVMe存储与相应带宽方案,能够为应用镜像运行、静态资源访问、日志保存和多任务处理提供稳定的硬件基础,并支持面向马来西亚及周边用户的业务部署。
一、准备服务器与网络条件
1. 确认操作系统和资源
本文以 Ubuntu 22.04 或 Ubuntu 24.04 为基线。登录马来西亚服务器后,先检查系统版本、CPU 架构、磁盘空间和内存:
cat /etc/os-release
uname -m
free -h
df -h /
示例输出可以类似如下:
NAME="Ubuntu"
VERSION="24.04.1 LTS (Noble Numbat)"
x86_64
total used free
Mem: 1.9Gi 320Mi 1.1Gi
单个 Nginx 示例应用通常不需要较高配置,1 vCPU、1 GB 内存和 10 GB 可用磁盘可以作为演示环境参考。真实应用还要把运行时、日志、缓存和业务数据占用计算在内,不能直接套用这个资源量。
如果系统不是 Ubuntu,不要直接执行下面的 Ubuntu 软件源命令。应先确认发行版和版本,再使用相匹配的 Docker 安装方式:
. /etc/os-release
printf 'ID=%s\nVERSION_ID=%s\nVERSION_CODENAME=%s\n' \
"$ID" "$VERSION_ID" "${VERSION_CODENAME:-未设置}"
2. 检查 SSH、HTTP 端口占用情况
首次部署不应影响当前 SSH 会话。先确认 SSH 端口和 Web 端口是否已经被其他服务占用:
sudo ss -lntp
重点查看:
- SSH 当前使用的端口,通常是
22,但也可能由服务器管理员改过。 80端口是否已经被 Nginx、Apache 或其他容器占用。443端口是否已有 HTTPS 服务。
如果 80 端口已经被业务服务使用,不要直接停止该服务。可以选择保留现有服务,或者将示例应用暂时改为:
ports:
- "8080:80"
此时访问地址变为 http://服务器公网IP:8080/,同时需要在云平台安全组或服务器防火墙中放行 TCP 8080。
3. 配置云防火墙或安全组
在马来西亚云服务器控制台中,至少确认以下入站规则:
| 端口 | 协议 | 来源 | 用途 |
|---|---|---|---|
| 当前 SSH 端口 | TCP | 管理员固定公网 IP 或必要网段 | 远程管理 |
| 80 | TCP | 公网或指定访问网段 | 本次 HTTP 验证 |
| 443 | TCP | 暂不需要 | 本示例未配置 HTTPS |
如果服务器使用 UFW,先查看现有规则,不要在未确认 SSH 放行的情况下启用防火墙:
sudo ufw status verbose
sudo ufw status numbered
只有在确认 SSH 规则已经存在的情况下,再添加 HTTP 规则:
sudo ufw allow 80/tcp
这条命令会修改主机防火墙。执行前可将当前规则记录下来,回滚时只删除本次添加的规则:
sudo ufw status numbered | tee /tmp/ufw-before-compose.txt
回滚命令为:
sudo ufw delete allow 80/tcp
如果使用云平台安全组,优先在控制台配置端口,主机防火墙保持现有策略。需要注意,Docker 发布端口后会参与主机网络转发,不能仅凭 UFW 的显示结果判断容器端口一定没有暴露,最终仍应以云安全组、ss 和外部访问结果共同确认。
二、安装 Docker Engine 和 Compose 插件
1. 添加 Docker 软件源
先安装添加软件源所需的基础工具:
sudo apt update
sudo apt install -y ca-certificates curl
创建密钥目录并导入 Docker 软件源密钥:
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
根据当前 Ubuntu 版本生成 Docker 软件源配置:
ARCH="$(dpkg --print-architecture)"
CODENAME="$(
. /etc/os-release
printf '%s' "$VERSION_CODENAME"
)"
if [ -z "$CODENAME" ]; then
echo "无法识别 Ubuntu 版本代号,请先检查 /etc/os-release"
exit 1
fi
echo "deb [arch=${ARCH} signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu ${CODENAME} stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
更新软件包索引并安装 Docker Engine、Buildx 和 Compose 插件:
sudo apt update
sudo apt install -y \
docker-ce \
docker-ce-cli \
containerd.io \
docker-buildx-plugin \
docker-compose-plugin
本次采用 sudo docker 的方式执行命令,不额外修改当前用户的 Docker Socket 权限。docker 用户组通常拥有接近主机管理员的控制能力,不应为了省略 sudo 而随意将普通账号加入该组。
2. 启动并验证 Docker 服务
启动 Docker,并设置为开机自动启动:
sudo systemctl enable --now docker
sudo systemctl is-active docker
sudo systemctl is-enabled docker
正常情况下,第一条检查应输出:
active
确认 Docker CLI 和 Compose 插件版本:
sudo docker version
sudo docker compose version
示例输出:
Docker Compose version v2.x.x
版本号可能因 Ubuntu 软件源和安装时间不同而变化,只要 docker compose version 能正常返回即可。注意命令是带空格的 docker compose,不是必须单独安装的旧版 docker-compose。
3. 验证镜像拉取和容器运行能力
执行 Docker 官方测试容器:
sudo docker run --rm hello-world
如果看到包含 Hello from Docker! 的信息,说明 Docker Engine 能够创建容器,且服务器可以访问镜像仓库。该命令使用 --rm,测试完成后会自动删除测试容器,不会留下长期运行的服务。
如果拉取过程中长时间超时,可以先检查马来西亚服务器的 DNS 和 HTTPS 出站连接:
getent hosts download.docker.com registry-1.docker.io
curl -I --max-time 15 https://registry-1.docker.io/v2/
访问 Docker Registry 接口时返回 401 Unauthorized 也可能是正常现象,因为该接口需要认证;只要不是 DNS 失败或连接超时,就说明 HTTPS 路径基本可达。
三、创建最小 Compose 应用
1. 创建项目目录
创建项目目录和静态页面目录:
sudo mkdir -p /opt/compose-demo/site
本示例只使用 /opt/compose-demo,不创建数据库卷,也不覆盖现有业务目录。进入项目目录后,后续 Compose 命令都在这里执行:
cd /opt/compose-demo
2. 创建测试页面
使用 tee 写入测试页面:
sudo tee /opt/compose-demo/site/index.html > /dev/null <<'EOF'
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Docker Compose Demo</title>
</head>
<body>
<h1>A5IDC Docker Compose Demo</h1>
<p>应用已通过马来西亚服务器上的 Docker Compose 启动。</p>
</body>
</html>
EOF
这是主机目录挂载到容器中的静态文件。修改页面时,文件会直接更新到容器读取的目录,但容器本身的生命周期仍由 Compose 管理。
3. 创建 Compose 文件
创建 /opt/compose-demo/compose.yaml:
sudo tee /opt/compose-demo/compose.yaml > /dev/null <<'EOF'
services:
web:
image: nginx:1.27-alpine
ports:
- "80:80"
volumes:
- type: bind
source: ./site
target: /usr/share/nginx/html
read_only: true
healthcheck:
test:
[
"CMD-SHELL",
"wget -q -O - http://127.0.0.1/ | grep -q 'A5IDC Docker Compose Demo'"
]
interval: 10s
timeout: 3s
retries: 5
start_period: 5s
restart: unless-stopped
EOF
配置中各项作用如下:
| 配置项 | 作用 | 验证方式 |
|---|---|---|
image | 使用 Nginx Alpine 镜像 | docker compose images |
80:80 | 将服务器 80 端口映射到容器 80 端口 | ss -lntp、HTTP 请求 |
bind volume | 将主机页面挂载到 Nginx 网站目录 | 修改 site/index.html 后访问 |
read_only: true | 容器内以只读方式挂载页面目录 | 检查配置和容器状态 |
healthcheck | 请求容器内部页面并匹配文本 | docker inspect |
restart: unless-stopped | 主机重启后自动恢复容器 | docker compose ps |
这里没有使用 container_name,让 Compose 根据项目目录生成容器名称,后续复制同类项目时不容易发生名称冲突。
4. 在启动前校验 YAML
先检查 Compose 文件是否能够被解析:
cd /opt/compose-demo
sudo docker compose config
成功时会输出规范化后的配置内容。也可以使用安静模式只返回状态:
sudo docker compose config --quiet
echo $?
返回 0 表示语法校验通过。此时还没有启动容器,适合先发现缩进、引号、端口和字段名称错误。
如果出现 yaml: line ...,优先检查报错行附近的空格。YAML 依赖缩进,不能使用 Tab;ports、volumes 和 healthcheck 的层级必须与上面的示例一致。
四、首次启动和逐项验证
1. 拉取镜像
在项目目录中执行:
cd /opt/compose-demo
sudo docker compose pull
成功后可查看项目镜像:
sudo docker compose images
示例结果可能类似:
NAME REPOSITORY TAG IMAGE ID SIZE
compose-demo-web-1 nginx 1.27-alpine ... ...
镜像标签用于示例固定在 1.27-alpine,没有使用 latest,这样重新部署时不会因为标签自动变化而引入不可预期的版本差异。
2. 启动容器
执行后台启动:
sudo docker compose up -d
预期会看到网络和容器创建信息。启动后立即查看服务状态:
sudo docker compose ps
容器刚启动时可能显示 health: starting。等待几秒后再次查看:
sleep 10
sudo docker compose ps
正常状态应类似:
NAME IMAGE SERVICE STATUS
compose-demo-web-1 nginx:1.27-alpine web Up ... (healthy)
Up 表示主进程仍在运行,healthy 表示健康检查命令也已通过。只有看到这两个状态,才算完成了容器层面的基础验证。
3. 检查容器健康状态
获取当前容器 ID:
CID="$(sudo docker compose ps -q web)"
printf 'container_id=%s\n' "$CID"
检查容器运行状态和健康状态:
sudo docker inspect \
--format '{{.State.Status}} / {{.State.Health.Status}}' \
"$CID"
成功时示例输出为:
running / healthy
如果 State.Status 是 exited,说明主进程已经退出;如果是 running / unhealthy,说明 Nginx 还在运行,但健康检查命令没有得到预期结果。两者的处理方式不同,不能只看容器是否存在。
4. 在服务器本机访问 HTTP
先从马来西亚服务器本机测试:
curl -i http://127.0.0.1/
预期结果包含:
HTTP/1.1 200 OK
Content-Type: text/html
正文中应出现:
A5IDC Docker Compose Demo
本机访问成功说明 Docker 端口映射、Nginx 进程和页面挂载基本正常,但还不能证明公网访问成功。因为本机请求不经过外部网络,也不能验证云安全组和公网地址。

5. 从外部网络访问
在个人电脑或其他不在该服务器上的网络环境中执行:
curl -i "http://服务器公网IPv4/"
也可以在浏览器中访问:
http://服务器公网IPv4/
如果已经将域名解析到服务器,则访问:
curl -i "http://你的域名/"
外部访问至少应满足:
- 返回 HTTP
200 OK。 - 页面正文包含示例标题。
- 云安全组允许 TCP 80。
- 服务器主机防火墙没有阻断 TCP 80。
- DNS 的 A 记录指向当前马来西亚服务器公网 IPv4。
如果服务器同时配置了 IPv6,还应确认 AAAA 记录指向可用地址,并单独测试:
curl -6 -i "http://你的域名/"
IPv4 能访问而 IPv6 失败时,不要先修改 Compose 文件,应优先检查 IPv6 地址、云平台 IPv6 入站规则和主机监听情况。
6. 查看应用日志
查看最近 50 行日志:
sudo docker compose logs --tail=50 web
正常访问后,通常可以看到类似访问记录:
172.18.0.1 - - [date] "GET / HTTP/1.1" 200
日志中出现 200 说明请求已经到达 Nginx 并返回成功。若本机请求成功但日志没有外部访问记录,问题通常在云安全组、主机防火墙、DNS 或公网路径,而不是页面文件。
五、常见失败情况与处理顺序
1. Compose 命令不存在
如果执行时出现 docker: 'compose' is not a docker command,说明 Compose 插件未安装或软件源配置没有生效:
sudo apt update
sudo apt install -y docker-compose-plugin
sudo docker compose version
如果提示找不到安装包,重新检查:
cat /etc/apt/sources.list.d/docker.list
sudo apt update
软件源中的发行版代号必须与 /etc/os-release 中的 VERSION_CODENAME 对应,不能把 Ubuntu 22.04 的代号手动改成其他版本。
2. 80 端口已被占用
如果 docker compose up -d 报告端口绑定失败,执行:
sudo ss -lntp | grep -E ':(80|443)\b'
确认占用进程后有两个选择:
- 保留现有服务,将 Compose 映射改为
"8080:80"。 - 在已确认业务影响、配置已备份的前提下,停止原服务,再使用 80 端口。
不要直接执行批量停止命令,也不要通过删除旧容器来解决端口冲突。旧服务可能承载现有业务或证书配置。
3. 容器状态为 unhealthy
先查看健康检查日志和容器日志:
sudo docker inspect \
--format '{{json .State.Health}}' \
"$CID"
sudo docker compose logs --tail=100 web
本示例的健康检查依赖页面中存在 A5IDC Docker Compose Demo。如果页面文件被改名、挂载目录为空,或者页面正文被替换,Nginx 仍可能返回 200,但健康检查会显示失败。此时检查文件是否存在:
sudo ls -la /opt/compose-demo/site
sudo grep -n "A5IDC Docker Compose Demo" /opt/compose-demo/site/index.html
修改文件后重新检查:
sudo docker compose restart web
sleep 10
sudo docker compose ps
4. 本机访问成功,外部访问超时
按照由外到内的顺序检查:

- 云安全组是否放行 TCP 80。
- 服务器是否使用了正确的公网 IPv4。
- UFW 或其他主机防火墙是否阻断访问。
- DNS A 或 AAAA 记录是否指向正确地址。
- 服务器是否实际监听 80 端口。
查看监听状态:
sudo ss -lntp | grep ':80'
如果显示 Docker 相关监听,说明端口映射已经建立。此时不要反复执行 docker compose up -d,应把排查重点转向公网规则和地址解析。
5. 镜像拉取失败
如果 docker compose pull 报超时或解析失败,检查:
getent hosts registry-1.docker.io
curl -I --max-time 15 https://registry-1.docker.io/v2/
常见原因包括:
- 服务器 DNS 配置不可用。
- 云平台限制了出站 TCP 443。
- 软件源或镜像仓库访问路径暂时异常。
- 服务器架构与镜像支持范围不匹配。
不要在未确认原因时随意修改 Docker 守护进程配置或更换未知镜像源。先保留错误信息,确认基础网络可用后再重试。
六、部署完成后的结果检查
将验收结果记录下来,可以避免只看到“容器在运行”就误判部署完成:
| 验收项目 | 检查命令或方式 | 通过标准 |
|---|---|---|
| Docker 服务 | sudo systemctl is-active docker | 输出 active |
| Compose 可用 | sudo docker compose version | 返回版本信息 |
| 配置有效 | sudo docker compose config --quiet | 返回码为 0 |
| 容器运行 | sudo docker compose ps | 状态为 Up |
| 健康检查 | docker inspect | running / healthy |
| 本机 HTTP | curl -i http://127.0.0.1/ | 返回 200 OK |
| 外部 HTTP | 外部主机访问公网 IP 或域名 | 能打开示例页面 |
| 应用日志 | sudo docker compose logs --tail=50 web | 请求返回 200,无连续报错 |
| 端口范围 | sudo ss -lntp | 仅发布本次需要的端口 |
如果使用真实应用替换 Nginx,健康检查必须匹配该应用的实际接口。例如应用监听容器内 8080 端口,则 Compose 应根据应用监听地址设置:
ports:
- "80:8080"
应用进程需要监听 0.0.0.0:8080,只监听 127.0.0.1:8080 时,容器外部通常无法访问。健康检查的 URL、返回码和响应内容也要与真实应用保持一致。
七、失败部署的回滚方式
1. 部署前保留配置备份
在修改已有 Compose 项目前,先创建带时间戳的备份目录:
cd /opt/compose-demo
BACKUP="/opt/compose-demo-backup-$(date +%Y%m%d-%H%M%S)"
sudo mkdir -p "$BACKUP"
sudo cp compose.yaml "$BACKUP/compose.yaml"
sudo cp -a site "$BACKUP/site"
printf '备份目录:%s\n' "$BACKUP"
本示例使用主机目录挂载,没有数据库卷。真实应用如果包含数据库、上传文件或持久化卷,还必须先完成对应的数据备份,不能只备份 compose.yaml。
2. 回滚 Compose 配置和页面
如果新配置启动失败,先停止本项目容器:
cd /opt/compose-demo
sudo docker compose down
docker compose down 会停止并删除本项目创建的容器和网络,但不会删除主机上的 site 文件,也不会删除命名卷。不要加 -v,除非已经确认卷内没有需要保留的数据并且明确要删除卷。
恢复旧的 Compose 文件:
sudo cp "$BACKUP/compose.yaml" ./compose.yaml
如果页面目录也需要恢复,先将当前目录改名保留,再复制备份:
sudo mv site "site.failed.$(date +%Y%m%d-%H%M%S)"
sudo cp -a "$BACKUP/site" ./site
重新启动并验证:
sudo docker compose up -d
sleep 10
sudo docker compose ps
curl -i http://127.0.0.1/
3. 回滚端口和防火墙规则
如果本次部署只是临时添加了 UFW 的 80 端口规则,确认没有其他服务依赖后再执行:
sudo ufw delete allow 80/tcp
云平台安全组中的 80 端口规则也应按相同原则删除或恢复到部署前状态。回滚完成后,再检查:
sudo ss -lntp
sudo ufw status verbose
sudo docker compose ps
不要使用 docker system prune -a 作为回滚命令。该命令可能删除其他项目仍需使用的镜像和缓存,影响范围超出本次 Compose 部署。
验收与回滚检查项
验收检查
- [ ] Ubuntu 版本和 CPU 架构与安装命令匹配。
- [ ] Docker 服务状态为
active。 - [ ]
docker compose version能返回版本信息。 - [ ]
docker compose config --quiet校验通过。 - [ ] 容器状态为
Up,健康状态为healthy。 - [ ] 服务器本机访问
127.0.0.1返回 HTTP 200。 - [ ] 外部网络访问马来西亚服务器公网 IP 或域名成功。
- [ ] 云安全组和主机防火墙只开放了必要端口。
- [ ] 容器日志没有持续出现启动或请求错误。
- [ ] 已记录 Compose 文件、页面文件和必要数据的备份位置。
回滚检查
- [ ] 回滚前已执行
docker compose down,没有直接删除业务数据。 - [ ] 未使用
docker compose down -v,除非已确认卷数据可以删除。 - [ ] 旧版
compose.yaml和页面目录已恢复。 - [ ] 容器重新启动后仍能通过健康检查。
- [ ] 本机和外部 HTTP 访问结果符合回滚前版本预期。
- [ ] 本次新增的防火墙和安全组规则已按需恢复。
- [ ] 旧容器、旧配置和备份文件未在未确认前被清理。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7850.html



