香港服务器首次使用Docker Compose v2部署应用,如何配置服务并验证启动
香港服务器首次使用 Docker Compose v2 部署应用,可以按“安装 Docker Engine 与 Compose 插件、编写 Compose 配置、启动容器、检查访问结果”的顺序完成。以下示例以 Ubuntu 22.04 或 24.04、拥有 sudo 权限的账号为前提,用 Nginx 容器验证部署链路;其他发行版的 Docker 软件源配置不同,不要直接照搬 Ubuntu 命令。
示例会将服务器的 TCP 8080 端口映射到容器的 80 端口。若服务器启用了云平台安全组或主机防火墙,需要按实际访问方式放行端口;不需要从公网直接访问时,可将端口绑定到本机地址,避免对外开放。
一、准备服务器与检查环境
先通过 SSH 登录服务器,确认系统版本、架构和 sudo 权限:
cat /etc/os-release
uname -m
sudo -v
/etc/os-release 应显示 Ubuntu,版本为 22.04 或 24.04;uname -m 常见结果为 x86_64 或 aarch64。后续命令会使用系统的发行版代号和软件包架构,不需要手动填写。
检查是否已有 Docker 安装:
docker --version
docker compose version
如果两条命令都能返回版本号,可以直接进入“创建 Compose 项目”。如果系统已安装旧版 Docker 或其他来源的容器软件,先确认现有服务和数据的用途,再决定是否迁移;不要为完成示例而直接卸载或覆盖正在使用的环境。
二、添加 Docker 软件源并安装 Compose v2
Ubuntu 软件源中可能提供不同版本的 Docker 相关软件包。这里使用 Docker 的 Ubuntu APT 软件源安装 Docker Engine、命令行工具和 Compose 插件。操作需要服务器能够访问软件源。
先安装添加软件源所需的工具,并创建密钥目录:
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
写入与当前 Ubuntu 版本、系统架构相匹配的软件源:
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
更新软件包索引后安装 Docker Engine、Compose v2 插件等组件:
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
安装完成后,检查服务状态和版本:
sudo systemctl is-active docker
sudo docker version
sudo docker compose version
服务正常时,第一条命令应输出 active;后两条命令应分别显示 Docker 客户端与服务端信息,以及 Compose 版本。Compose v2 使用 docker compose(中间为空格)调用,不需要安装旧版独立命令 docker-compose。
如果服务器此前没有安装 Docker,且希望当前账号使用 Docker 命令时不必每次加 sudo,可以将账号加入 docker 组:
sudo usermod -aG docker "$USER"
组权限通常要在重新登录 SSH 后才生效。docker 组成员可以通过 Docker 管理宿主机资源,权限较高;仅用于本次验证时,使用 sudo docker compose 更便于控制权限范围。
三、创建 Compose 项目
新建一个仅用于本次示例的目录,并进入该目录:
mkdir -p ~/compose-demo
cd ~/compose-demo
创建 compose.yaml:

cat > compose.yaml <<'EOF'
services:
web:
image: nginx:alpine
container_name: compose-demo-web
restart: unless-stopped
ports:
- "8080:80"
EOF
这个配置定义了一个名为 web 的服务:使用 Nginx 镜像,容器内监听 80 端口,并将服务器的 8080 端口映射到容器的 80 端口。restart: unless-stopped 表示容器异常退出或 Docker 服务重启后可自动尝试恢复,但不代表应用本身已具备高可用能力。
Compose 配置未指定镜像的固定版本,因此 nginx:alpine 可能随镜像仓库更新而变化。作为首次验证可以使用该标签;长期运行时,建议根据应用兼容性选择明确版本,并在更新前检查变更影响。
启动前先让 Compose 检查配置:
sudo docker compose config
如果配置有效,命令会输出解析后的服务配置;若提示 YAML 格式错误,先检查缩进、冒号和引号。YAML 使用空格缩进,不要用 Tab。确认无误后,再拉取镜像并启动服务:

sudo docker compose up -d
首次启动需要下载镜像,耗时会受服务器网络和镜像大小影响。-d 表示在后台运行;命令完成后通常会显示创建网络和启动容器的状态。
Compose 应用的运行基础,也离不开服务器的 CPU、内存、存储和网络资源。A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器,覆盖常规建站、AMD计算和多种存储配置,可为网站、业务后台、数据库与容器应用提供不同的部署资源。香港及美国等地的产品提供 SSD 或 NVMe 存储,部分 AMD 方案配备较大内存;多地区和线路选择也为面向不同用户群体的服务部署提供了资源基础。
四、逐项验证服务是否启动
先检查 Compose 服务状态:
sudo docker compose ps
正常时,web 服务应处于 Up 状态,并能看到类似 0.0.0.0:8080->80/tcp 的端口映射。若状态为 Restarting、Exited,继续检查日志:
sudo docker compose logs --tail=100 web
再从服务器本机访问映射端口:
curl -i http://127.0.0.1:8080/
Nginx 示例正常时,响应状态通常为 HTTP/1.1 200 OK,正文中包含 Nginx 欢迎页面内容。该结果说明容器已响应本机请求,但还不能单独证明公网访问路径正常。
如需从外部网络访问,在云平台安全组中为服务器添加 TCP 8080 入站规则;若配置了主机防火墙,也要确认相应规则。尽量将来源限制为需要访问的客户端地址,不要默认向所有来源开放。之后用浏览器访问 http://服务器公网地址:8080/,或从另一台机器运行:

curl -i http://服务器公网地址:8080/
如果本机访问成功而外部访问失败,优先检查安全组、主机防火墙和公网地址,而不是立即重建容器。Docker 发布的端口会改变主机网络转发行为;使用 UFW 等工具时,应结合主机现有规则确认实际访问边界。
五、常见失败及处理顺序
软件源更新或安装失败
若 apt-get update 报域名解析、连接超时或 TLS 错误,先检查服务器 DNS、出站网络和系统时间,再确认软件源文件是否写入正确:
cat /etc/apt/sources.list.d/docker.list
若提示找不到适用于当前发行版的软件包,核对系统确为 Ubuntu,以及软件源中的发行版代号是否与 /etc/os-release 一致。不要把 Debian 软件源地址直接套用到 Ubuntu。
Docker 服务未运行
如果 systemctl is-active docker 未输出 active,检查服务状态和日志:
sudo systemctl status docker --no-pager
sudo journalctl -u docker --no-pager -n 100
根据错误信息判断是否存在磁盘空间不足、配置错误或软件包安装不完整。修正原因后,再尝试启动服务:
sudo systemctl start docker
端口已被占用
如果启动时提示 8080 端口已分配,查找占用进程:

sudo ss -lntp | grep ':8080'
确认占用服务可以调整后,再修改 compose.yaml 左侧的主机端口,例如改为 "8081:80";右侧的 80 是容器端口,通常不应随主机端口一起修改。应用配置后重新启动:
sudo docker compose up -d
sudo docker compose ps
curl -i http://127.0.0.1:8081/
容器已启动但无法访问
若 docker compose ps 显示 Up,但本机 curl 失败,依次检查端口映射、容器日志和端口占用情况:
sudo docker compose ps
sudo docker compose logs --tail=100 web
sudo ss -lntp | grep ':8080'
若本机 curl 成功而外部无法访问,则重点检查公网地址、安全组及主机防火墙规则。更改防火墙前先确认已有远程管理规则,尤其不能误删 SSH 入站规则,以免中断服务器管理连接。
六、验收与回滚检查
首次部署完成后,可以按以下项目验收:
docker compose version能返回 Compose v2 版本。sudo systemctl is-active docker返回active。sudo docker compose config能解析compose.yaml。sudo docker compose ps显示web服务运行,端口映射符合预期。- 本机
curl返回 Nginx 页面;若要求外部访问,再从外部网络验证。 - 安全组和主机防火墙仅开放实际需要的端口与来源。
需要停止本次示例时,在项目目录运行:
sudo docker compose down
该命令会停止并移除 Compose 创建的容器和网络,不会删除项目文件,也不会删除已拉取的镜像。示例没有创建数据卷,因此没有容器数据卷需要处理。不要随意追加 -v:如果后续配置已加入数据卷,down -v 会删除该 Compose 项目声明的卷及其中数据。
如需恢复服务,可重新进入项目目录执行 sudo docker compose up -d。若只需撤销本次验证,则确认容器已停止、端口不再监听,并保留或按自身需要移除 compose.yaml;卸载 Docker 软件包或清理镜像并不是回滚应用所必需的步骤。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8109.html



