腾讯云Ubuntu服务器配置Docker环境的完整步骤是什么？

在腾讯云的 Ubuntu 服务器上配置 Docker 环境的完整步骤如下。本文以 Ubuntu 20.04 或 22.04 为例，适用于大多数现代 Ubuntu 版本。

✅ 第一步：登录腾讯云服务器

使用 SSH 登录你的腾讯云 Ubuntu 实例：

ssh root@你的公网IP
# 或者使用普通用户（如 ubuntu）
ssh ubuntu@你的公网IP

建议使用密钥登录，更安全。

✅ 第二步：更新系统包

sudo apt update && sudo apt upgrade -y

确保系统为最新状态。

✅ 第三步：安装依赖工具

安装一些必要的依赖包，用于通过 HTTPS 使用仓库：

sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release software-properties-common

✅ 第四步：添加 Docker 的官方 GPG 密钥

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

✅ 第五步：添加 Docker APT 仓库

根据你的 Ubuntu 版本，添加仓库（以下命令适用于 Ubuntu 20.04/22.04）：

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

$(lsb_release -cs) 会自动获取你的 Ubuntu 发行代号（如 focal、jammy）。

✅ 第六步：更新 APT 包索引并安装 Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

这将安装：

• docker-ce: Docker 社区版
• docker-ce-cli: Docker 命令行工具
• containerd.io: 容器运行时

✅ 第七步：验证 Docker 是否安装成功

sudo docker --version

输出应类似：

Docker version 24.0.7, build ...

运行一个测试容器：

sudo docker run hello-world

如果看到欢迎信息，说明 Docker 安装成功。

✅ 第八步：（可选）配置非 root 用户使用 Docker

避免每次使用 sudo，可以将当前用户加入 docker 组：

sudo usermod -aG docker $USER

$USER 是当前登录用户（如 ubuntu）

退出并重新登录 或重启 shell，使组权限生效。

之后可以直接运行：

docker ps

无需 sudo。

✅ 第九步：（可选）设置 Docker 开机自启

Docker 通常默认已启用开机自启，但可以确认一下：

sudo systemctl enable docker
sudo systemctl start docker

查看状态：

sudo systemctl status docker

✅ 第十步：（可选）安装 Docker Compose

Docker Compose 用于管理多容器应用。

方法一：从 GitHub 下载最新版本（推荐）

# 查看最新版本：https://github.com/docker/compose/releases
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

赋予权限：

sudo chmod +x /usr/local/bin/docker-compose

验证：

docker-compose --version

注意：新版本 Docker 已集成 docker compose（无短横线），你也可以直接使用 docker compose 命令。

✅ 补充：防火墙与安全组配置（腾讯云关键）

确保腾讯云控制台中 安全组规则 允许你需要的端口，例如：

• 22（SSH）
• 80（HTTP）
• 443（HTTPS）
• 其他应用端口（如 3000、8080 等）

Docker 会自动操作 iptables，但云平台的安全组必须手动放行。

✅ 常见问题排查

1. 权限被拒绝？

   • 检查是否将用户加入 docker 组，并重新登录。
   • 运行 groups 查看当前用户所属组。

2. 无法拉取镜像？

   • 可能是网络问题，考虑配置镜像提速器。

3. 配置国内镜像提速（推荐）

编辑或创建 /etc/docker/daemon.json：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",
    "https://registry.docker-cn.com"
  ]
}
EOF

腾讯云提供专属镜像提速地址：https://mirror.ccs.tencentyun.com（需登录腾讯云容器镜像服务获取个人专属地址）

重启 Docker：

sudo systemctl restart docker

✅ 总结：完整流程概览

完成以上步骤后，你的腾讯云 Ubuntu 服务器就具备完整的 Docker 运行环境，可以部署 Web 应用、数据库、微服务等。

如有进一步需求（如部署 Nginx、MySQL、Node.js 应用），可继续使用 docker run 或 docker-compose.yml 文件进行编排。