马来西亚服务器如何用Docker Compose部署应用并验证容器可用

发布人:A5数据发布时间:2026-11-06 10:58阅读量:68

在马来西亚服务器上首次使用 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 或必要网段远程管理
80TCP公网或指定访问网段本次 HTTP 验证
443TCP暂不需要本示例未配置 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. 本机访问成功,外部访问超时

按照由外到内的顺序检查:

五、常见失败情况与处理顺序配图

  1. 云安全组是否放行 TCP 80。
  2. 服务器是否使用了正确的公网 IPv4。
  3. UFW 或其他主机防火墙是否阻断访问。
  4. DNS A 或 AAAA 记录是否指向正确地址。
  5. 服务器是否实际监听 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 inspectrunning / healthy
本机 HTTPcurl -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

相关推荐