加油
努力

腾讯云Ubuntu服务器安装Docker的步骤是什么?

在腾讯云 Ubuntu 服务器(推荐 Ubuntu 22.04 LTS 或 20.04 LTS)上安装 Docker 的标准、安全且官方推荐的步骤如下(使用 Docker 官方 APT 仓库,避免使用系统默认过时的 docker.io 包):


✅ 前提条件

  • 已登录腾讯云 Ubuntu 服务器(SSH)
  • 具有 sudo 权限(推荐使用 root 或已加入 sudo 组的用户)
  • 确保系统已更新(网络通畅,可访问 https://download.docker.com/linux/ubuntu/

⚠️ 注意:腾讯云部分镜像可能预装了旧版 Docker(如 docker.io),建议先卸载旧版本再安装官方版。


🔧 步骤详解(逐条执行)

1️⃣ 卸载可能存在的旧 Docker(可选但推荐)

sudo apt remove -y docker docker-engine docker.io containerd runc
sudo rm -rf /var/lib/docker /var/lib/containerd

2️⃣ 更新系统并安装依赖

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

3️⃣ 添加 Docker 官方 GPG 密钥

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4️⃣ 添加 Docker 官方 APT 仓库(自动适配 Ubuntu 版本)

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

✅ 验证是否正确添加(可选):

cat /etc/apt/sources.list.d/docker.list  # 应显示类似:deb [arch=amd64 signed-by=...] jammy stable

5️⃣ 更新 APT 包索引并安装 Docker Engine

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

✅ 安装说明:

  • docker-ce: Docker 社区版核心引擎
  • docker-ce-cli: CLI 工具(docker 命令)
  • containerd.io: 容器运行时(Docker 依赖)
  • docker-buildx-plugin & docker-compose-plugin: 现代化构建与编排插件(替代旧版 docker-compose

6️⃣ 启动并启用 Docker 服务

sudo systemctl enable docker
sudo systemctl start docker

7️⃣ 验证安装(非 root 用户需加 sudo;后续建议配置免密)

sudo docker --version        # 如:Docker version 24.0.7, build afdd53b
sudo docker run hello-world  # 下载测试镜像并运行(首次会拉取)

✅ 若看到 “Hello from Docker!” 输出,则安装成功!


🛡️ 进阶建议(生产环境推荐)

✅ 将当前用户加入 docker 组(避免每次用 sudo

sudo usermod -aG docker $USER
# 退出 SSH 重新登录,或运行:
newgrp docker  # 临时生效(当前 shell)

验证:docker run hello-world(无需 sudo

✅ 配置国内镜像提速(提升拉取速度,腾讯云推荐)

编辑 /etc/docker/daemon.json(若不存在则创建):

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",   # 腾讯云官方镜像(强烈推荐!)
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}
EOF

重启 Docker 生效:

sudo systemctl daemon-reload
sudo systemctl restart docker

✅ 验证镜像提速:sudo docker info | grep "Registry Mirrors"

✅ (可选)安装 Docker Compose(如需独立二进制)

虽然插件已内置 docker compose(注意是空格,非 -),但如需传统 docker-compose 命令:

sudo apt install -y docker-compose  # Ubuntu 22.04+ 自带,兼容性好
# 或从 GitHub 安装最新版(推荐):
# sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# sudo chmod +x /usr/local/bin/docker-compose

❌ 常见问题排查

现象 解决方案
Cannot connect to the Docker daemon 检查 sudo systemctl status docker,确保服务运行;用户是否加入 docker 组?
Permission denied while trying to connect to ... 执行 sudo usermod -aG docker $USER + 重登
Failed to fetch ... docker.gpg 检查网络(腾讯云内网可直连 mirror.ccs.tencentyun.com);尝试换源或检查防火墙
docker: command not found 检查 which docker;确认 docker-ce-cli 是否安装成功

完成! 你现在已在腾讯云 Ubuntu 服务器上成功部署稳定、最新的 Docker 环境,并已优化为国内提速体验。

需要我为你生成一键安装脚本、配置 Nginx + Docker Web 环境,或部署常见应用(如 Portainer、WordPress)?欢迎继续提问!🚀

云服务器