在腾讯云 Ubuntu 服务器上安装 Docker,核心逻辑其实和在其他 Linux 发行版上差不多,但考虑到国内网络环境(特别是拉取镜像的速度)以及腾讯云的默认安全策略,有几个坑需要避开。
以下是经过验证的、生产环境可用的完整步骤。我按“最稳妥”的方式推荐,即通过官方源安装,而不是直接用 apt install docker.io(那个版本通常很旧且不是社区最新维护版)。
前置准备:登录与基础检查
- SSH 登录
ssh root@<你的CVM公网IP> - 更新系统包索引
这一步不能省,确保你拿到的是最新的软件列表。sudo apt update && sudo apt upgrade -y - 确认内核版本
Docker 对内核有要求,Ubuntu 18.04/20.04/22.04 LTS 都满足条件。你可以简单看下:uname -r
第一步:卸载可能存在的冲突版本
如果你之前尝试过 apt install docker.io 或者装过旧版 Docker,先清理一下,避免端口或依赖冲突。
sudo apt-get remove docker docker-engine docker.io containerd runc
注:如果提示没有这些包,直接忽略即可。
第二步:安装必要依赖
Docker 的安装过程需要 HTTPS 传输和证书校验,所以得先装上这些工具。
sudo apt-get install -y ca-certificates curl gnupg lsb-release
第三步:添加 Docker 官方 GPG 密钥和 APT 源
这是最关键的一步。注意:由于国内网络原因,直接使用 Docker 官方源可能会超时或下载极慢。
方案 A:使用 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 -
设置稳定版仓库
首先获取你的 Ubuntu 代号(如 focal, jammy 等):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
方案 B:使用阿里云镜像源(强烈推荐,国内服务器首选)
如果执行上面的 curl 命令卡住或失败,请直接换用阿里云的 Docker CE 镜像源,速度会快很多。
-
添加阿里云 GPG 密钥
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg -
设置阿里云仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
第四步:安装 Docker Engine
再次更新包索引,然后安装。
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
注:这里安装了 docker-compose-plugin,这样你就可以直接用 docker compose 命令了,不需要单独去下二进制文件。
第五步:验证安装
sudo docker run hello-world
如果看到 Hello from Docker! 的输出,说明安装成功。
第六步:配置非 Root 用户运行 Docker(重要优化)
默认情况下,只有 root 用户能运行 Docker 命令。为了方便日常开发,建议将当前用户加入 docker 组。
- 创建 docker 组并添加用户
(假设当前用户是ubuntu或root,如果是其他用户请替换<username>)sudo groupadd docker sudo usermod -aG docker $USER - 重启生效
退出 SSH 重新登录,或者执行:newgrp docker - 测试
现在你可以不加sudo直接运行docker ps或docker images了。
第七步:配置开机自启
虽然安装后默认是自启的,但为了保险起见:
sudo systemctl enable docker
sudo systemctl enable containerd
第八步:国内镜像提速配置(必做)
在国内拉取 Docker Hub 的镜像(尤其是官方镜像如 nginx, mysql, redis 等)非常慢,甚至超时。必须配置镜像提速器。
-
编辑 daemon.json
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": [ "https://mirror.ccs.tencentyun.com", "https://docker.m.daocloud.io", "https://huecker.io", "https://dockerhub.timeweb.cloud" ] } EOF注:
mirror.ccs.tencentyun.com是腾讯云专属镜像提速地址,无需申请,直接可用,延迟最低。其他几个是公共提速源,可以作为备用。 -
重启 Docker 服务
sudo systemctl daemon-reload sudo systemctl restart docker -
验证配置
sudo docker info | grep -A 10 "Registry Mirrors"你应该能看到刚才配置的提速地址。
常见问题排查
-
权限拒绝 (Permission denied)
- 现象:运行
docker ps报错Got permission denied while trying to connect to the Docker daemon socket... - 解决:确保你已经执行了
usermod -aG docker $USER并重新登录了终端。
- 现象:运行
-
防火墙问题
- 腾讯云 CVM 默认开启了安全组。如果你在容器内启动了 Web 服务(如 80, 8080 端口),务必去腾讯云控制台 -> 实例 -> 安全组规则中,添加入方向规则,允许对应 TCP 端口。
- 服务器内部的
ufw防火墙通常不影响 Docker 桥接网络,但如果不确定,可以暂时关闭测试:sudo ufw disable。
-
磁盘空间不足
- Docker 镜像和容器会占用大量磁盘空间。定期检查:
df -h docker system df - 如果满了,可以使用
docker system prune -a清理未使用的镜像和容器(慎用,会删除所有停止的容器和无用的镜像)。
- Docker 镜像和容器会占用大量磁盘空间。定期检查:
总结
这套流程涵盖了从环境准备到镜像提速的全链路。对于腾讯云 Ubuntu 服务器,重点在于使用腾讯云内网镜像提速地址 (mirror.ccs.tencentyun.com) 和正确配置安全组。按照这个步骤走,基本不会踩坑。
云技术博客