主机资讯与使用指南

VPS 安装 Docker 与 Docker Compose：Ubuntu 24.04 操作步骤

在 Ubuntu 24.04 使用 Docker 官方软件源安装 Engine 和 Compose，创建第一个项目并查看运行日志。

先确认系统和现有服务

新买的 Ubuntu 24.04 VPS，可以直接使用 Docker 官方软件源。下面的命令在服务器 SSH 终端运行，需要有 sudo 权限。已有 Docker 或面板的机器先查看当前版本，不必重复安装。

cat /etc/os-release
docker --version
docker compose version

找不到 docker 命令通常表示尚未安装；若命令已经正常返回版本，直接进入 Compose 项目部分。面板管理的 Docker 沿用面板的安装和升级方式。

添加 Docker 官方软件源

sudo apt update
sudo apt 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
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update

这是 Ubuntu 的软件源配置，不能原样用于 Debian。执行 apt update 后应能看到 download.docker.com 的 Ubuntu 仓库；如果报签名或连接错误，先处理该错误，再继续安装。

安装并确认 Compose 可用

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run --rm hello-world
sudo docker compose version

hello-world 用来确认 Docker 能拉取和运行镜像。Compose 使用 docker compose，中间有空格；本文后续命令都采用这个写法。服务器无法连接镜像仓库时，拉取失败和安装失败要分别处理。

把应用配置放在一个目录里

每个应用单独建立目录，并保存 compose.yaml。以后备份、更新、迁移都从这个目录操作。下面先创建一个空项目目录，具体配置按对应软件教程填写。

sudo mkdir -p /srv/my-app
sudo chown "$USER":"$(id -gn)" /srv/my-app
cd /srv/my-app

写好 compose.yaml 后先检查格式，再启动应用。config 会展开环境变量，输出可能包含密码；不要把完整输出直接发到公开讨论区。

sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100

端口与数据放在哪里

容器的端口和宿主机端口可以不同。使用反向代理时，把宿主机监听地址写为 127.0.0.1，例如 127.0.0.1:3000:8080；域名入口由代理负责。需要直接对外提供的端口，再按用途配置云安全组。

数据库、上传文件和应用配置应挂载到卷或宿主机目录。重建容器不等于重建数据；先弄清 volumes 中的数据位置，再升级或迁移。Docker 发布的端口可能绕过 UFW 的常规规则，不能只看 UFW 状态判断是否能从公网访问。