在腾讯云 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)?欢迎继续提问!🚀
云小栈