云服务器如何用Docker Compose完成首次部署并验证服务?
首次部署的目标,是让一台云服务器通过 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 重启后尝试重新启动,但不会替代应用自身的健康检查和监控。

这里使用 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



