云服务器如何用Docker Compose完成首次部署并验证服务?

发布人:A5数据发布时间:2026-11-13 14:46阅读量:37

首次部署的目标,是让一台云服务器通过 Docker Compose 启动一个容器化服务,并分别从服务器本机和外部客户端验证它是否可访问。下面以 Ubuntu 22.04/24.04、Docker Engine 和一个提供静态页面的 Nginx 容器为例;示例不需要编写 Dockerfile,也不依赖数据库等其他服务。

开始前,需要一台有 sudo 权限、能够访问软件仓库和容器镜像仓库的 Ubuntu 云服务器,并能在云平台控制台调整入站规则。示例使用 TCP 8080 端口提供普通 HTTP 服务,不应在其中放置密码或敏感数据。服务器配置应按镜像下载和预期访问量选择;单个静态页面容器本身较轻,但仍需为操作系统和 Docker 预留资源。

A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器租用,涵盖常规建站及多种 CPU、内存、SSD/NVMe 存储和网络配置,可为使用 Docker Compose 部署网站、业务后台及接口服务提供计算与存储资源。不同地区设有相应线路方案,满足面向不同访问区域的部署需求。

准备条件

先核对系统版本、架构和当前 Docker 状态:

cat /etc/os-release
uname -m
dpkg --print-architecture
command -v docker || true

以下安装命令适用于 Ubuntu。若系统不是 Ubuntu,或已有 Docker 服务正在承载业务,不要直接套用安装步骤;先确认发行版对应的软件包来源、已有容器和数据位置,避免覆盖或中断现有工作负载。

还要确认:

  • 云服务器有公网 IP,或存在可从测试客户端访问的网络路径。
  • 云平台安全组、网络 ACL 等入站控制可以配置。
  • 客户端能够访问服务器的 TCP 8080 端口。建议先只允许自己的公网出口 IP;确需公开访问时再评估是否开放给所有来源。
  • 服务器时间、DNS 和出站网络正常,以便更新软件包及拉取镜像。

如果服务器启用了 UFW,先检查当前规则和 SSH 通道:

sudo ufw status verbose

不要为了开放 8080 而直接重置防火墙规则或开启防火墙。若计划启用 UFW,先确认 SSH 所用端口已放行,以免失去远程管理通道。Docker 发布的端口还可能绕过部分 UFW 规则,因此外部访问控制应优先核对云平台的入站规则。

安装并验证 Docker Compose

如果系统已有可用的 Docker Engine 和 Compose 插件,可先跳过安装,直接检查版本:

sudo docker version
sudo docker compose version

若是干净的 Ubuntu 主机,可添加 Docker 官方软件源并安装 Docker Engine 与 Compose 插件。此操作会修改 APT 软件源配置,并安装或更新 Docker 相关组件;在已有容器业务的服务器上,先评估维护窗口和兼容性。

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

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

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

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

启动 Docker,并设置为系统启动时自动运行:

sudo systemctl enable --now docker
sudo systemctl is-active docker
sudo docker compose version

is-active 返回 active 表示 Docker 服务正在运行;Compose 命令应输出版本号。首次部署还可以运行官方示例容器,检查 Docker 是否能启动容器并访问镜像仓库:

sudo docker run --rm hello-world

若命令成功,会输出说明 Docker 已正常运行的文本。该检查需要下载镜像;网络受限时,失败可能来自镜像仓库连接,而不一定是 Docker 服务本身故障。

后续示例命令均使用 sudo docker。不要为了省略 sudo 就随意将账号加入 docker 组:该组成员通常可以获得近似 root 级别的主机控制能力。

创建 Compose 项目

建立项目目录和静态页面目录:

sudo install -d -m 0755 /opt/compose-demo/html

sudo tee /opt/compose-demo/html/index.html > /dev/null <<'EOF'
<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8">
    <title>Compose 部署验证</title>
  </head>
  <body>
    <h1>服务已启动</h1>
    <p>此页面由 Docker Compose 管理的 Nginx 容器提供。</p>
  </body>
</html>
EOF

接着创建 /opt/compose-demo/compose.yaml:

sudo tee /opt/compose-demo/compose.yaml > /dev/null <<'EOF'
services:
  web:
    image: nginx:alpine
    container_name: compose-demo-web
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
EOF

这个配置定义了一个名为 web 的服务:容器内 Nginx 监听 80 端口,主机 8080 端口映射到容器 80 端口;项目目录下的 html 目录以只读方式挂载为站点内容目录。restart: unless-stopped 表示容器异常退出或 Docker 重启后尝试重新启动,但不会替代应用自身的健康检查和监控。

创建 Compose 项目配图

这里使用 nginx:alpine 作为便于首次验证的镜像标签。标签可能随上游更新而指向不同镜像;需要稳定复现或正式上线时,应明确选择经过测试的版本或镜像摘要,并按变更流程更新,而不是把示例标签直接当作生产版本策略。

启动前先检查 Compose 文件是否能解析:

sudo docker compose -f /opt/compose-demo/compose.yaml config -q

命令无输出且退出状态为 0,通常表示配置解析成功。若报错,先按提示检查缩进、字段名称和文件路径,不要在配置未通过检查时继续启动。

首次启动与本机验证

启动服务:

sudo docker compose -f /opt/compose-demo/compose.yaml up -d

首次运行时,Docker 可能需要先拉取 Nginx 镜像。查看服务状态:

sudo docker compose -f /opt/compose-demo/compose.yaml ps

正常情况下,web 服务状态会显示为运行中,端口映射中能看到主机 8080 对应容器 80。随后从服务器本机请求服务:

curl -i http://127.0.0.1:8080/

预期响应包含 HTTP/1.1 200 OK,正文中有“服务已启动”。这能验证容器、端口映射和页面挂载在服务器本机可用,但还不能证明外部客户端能够访问。

以下是响应形式示例,并非实际服务器的执行记录:

HTTP/1.1 200 OK
Server: nginx
Content-Type: text/html

<!doctype html>
<html lang="zh-CN">
...
<h1>服务已启动</h1>

若本机请求失败,先检查服务日志和容器状态:

sudo docker compose -f /opt/compose-demo/compose.yaml logs --tail=50 web
sudo docker compose -f /opt/compose-demo/compose.yaml ps

配置外部访问并验证

在云平台防火墙或安全组中添加入站规则:协议为 TCP,目标端口为 8080,来源优先限制为测试客户端的公网 IP。只有明确需要任意互联网客户端访问时,才考虑放宽来源范围;还应检查 IPv4、IPv6 规则是否与预期一致。该示例是未加密的 HTTP 服务,只用于无敏感数据的连通性验证。

从服务器之外的客户端执行:

curl -i http://<云服务器公网IP>:8080/

将占位文本替换为实际公网 IP。若收到 200 OK 且页面包含预期内容,说明从该客户端到服务的基本访问链路已打通。不要只在服务器本机用公网 IP 代替外部测试:部分网络环境不支持这种回环访问,结果可能与真实外部访问不同。

配置外部访问并验证配图

常见失败处理

按照由低风险到高风险的顺序检查,先观察状态和日志,再修改配置或网络规则。

现象优先检查判断与处理
安装时提示软件源或签名错误cat /etc/os-release、APT 更新输出、服务器 DNS 和出站网络确认系统为 Ubuntu,软件源发行版代号匹配;不要关闭签名校验来绕过问题。
Docker 服务未启动sudo systemctl status docker --no-pager根据状态和日志判断服务是否启动失败;修复具体错误后再执行 sudo systemctl start docker。
拉取镜像超时或失败sudo docker pull nginx:alpine检查 DNS、出站防火墙及镜像仓库连通性;镜像拉取失败不等于 Compose 文件错误。
容器启动后退出sudo docker compose -f /opt/compose-demo/compose.yaml logs --tail=50 web根据日志定位镜像启动、配置或文件挂载问题;修复后重新执行 up -d。
提示 8080 端口已被占用sudo ss -lntp,并查看 sudo docker ps查明占用进程,不要贸然结束未知服务。可将映射改为 "8081:80",同时调整云平台入站端口并重新验证。
本机访问成功,外部超时云平台安全组、网络 ACL、服务器公网 IP、客户端网络优先核对云端入站规则和来源范围;确认规则放行的是主机映射端口,而不是容器内部端口 80。
返回页面与预期不符sudo docker compose -f /opt/compose-demo/compose.yaml logs --tail=50 web 和挂载目录内容确认请求命中了这台服务器的 8080 端口,并检查 /opt/compose-demo/html/index.html 是否存在。

如果改用 8081,Compose 配置只需将主机端口改为 8081,容器端口仍保持 80:

ports:
  - "8081:80"

修改后重新应用配置,并在云平台规则中放行 TCP 8081:

sudo docker compose -f /opt/compose-demo/compose.yaml up -d
curl -i http://127.0.0.1:8081/

验收与回滚

首次部署可按以下项目验收:

  • sudo systemctl is-active docker 返回 active。
  • sudo docker compose version 能输出 Compose 版本。
  • Compose 配置检查通过,docker compose ps 显示服务运行中。
  • 服务器本机访问 http://127.0.0.1:8080/ 返回 200 和预期页面。
  • 从允许访问的外部客户端请求公网 IP 和 8080 端口,能收到相同页面。
  • 云平台入站规则的端口和来源范围符合预期,未额外开放不需要的端口。

若要停止这次部署,先执行:

sudo docker compose -f /opt/compose-demo/compose.yaml down

此命令会停止并移除该 Compose 项目的容器和网络,但不会删除项目目录中的页面文件,也不会卸载 Docker 或清除镜像缓存。之后若要恢复服务,重新执行:

sudo docker compose -f /opt/compose-demo/compose.yaml up -d

如需撤销外部访问,先删除或收紧云平台中 TCP 8080 的入站规则,再确认外部客户端无法访问。不要在不了解影响范围时卸载 Docker、清理全局镜像或删除项目目录;服务器上可能还存在其他容器或需要保留的文件。

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

相关推荐