在腾讯云 Ubuntu 20.04 上安装 Docker Engine,最稳妥、也是官方文档首推的方法是通过 Docker 官方 APT 仓库进行安装。
虽然 apt install docker.io 也能装,但那个版本通常比较旧,且缺少一些最新的安全补丁和特性。对于生产环境或者对稳定性有要求的场景,强烈建议走官方源。
以下是具体的操作步骤,我在实际项目中经常这么用,顺手帮你把坑都填平了:
1. 卸载可能存在的旧版本
如果你之前通过 apt 装过 docker 或 docker-engine,先清理一下,避免冲突。
sudo apt-get remove docker docker-engine docker.io containerd runc
2. 设置 Docker 官方 APT 仓库
这一步是关键,很多新手容易漏掉依赖包导致后面报错。
第一步:更新 apt 并安装必要依赖
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
第二步:添加 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
第三步:设置稳定版仓库
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
注意:Ubuntu 20.04 对应的 codename 是
focal。上面的命令会自动识别你的系统版本,所以不用手动改focal。
3. 安装 Docker Engine
现在你可以从刚刚添加的官方源安装了。
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
这里装的 docker-ce 是社区版(Community Edition),个人开发和小中型项目完全够用。如果是要搞企业级付费支持,才需要选 docker-ee,但在国内云服务器上基本没人买这个。
4. 验证安装
安装完成后,运行 hello-world 镜像测试一下:
sudo docker run hello-world
如果看到 “Hello from Docker!” 字样,说明安装成功。
5. 非 root 用户操作(可选但推荐)
默认情况下,只有 root 用户或 docker 用户组的成员才能运行 Docker 命令。为了方便日常使用,可以将当前用户加入 docker 组:
sudo usermod -aG docker $USER
然后重新登录终端(或者执行 newgrp docker),之后就可以直接输 docker ps 而不用加 sudo 了。
腾讯云特有注意事项
作为在腾讯云长期折腾的人,有几个点需要你特别注意,否则可能会遇到网络或权限问题:
1. 安全组规则
Docker 启动后,如果你要暴露端口(比如 80, 443, 8080 等),务必去腾讯云控制台 -> CVM 实例 -> 安全组 里放行对应端口。这是新手最容易踩的坑:容器里服务跑起来了,网络访问不通,查了半天发现是云厂商防火墙拦住了。
2. 内网提速与镜像拉取
Docker Hub 在国内直连速度有时很慢,甚至超时。建议在 /etc/docker/daemon.json 中配置镜像提速器。
创建或编辑文件:
sudo vi /etc/docker/daemon.json
填入以下内容(以腾讯云提供的免费提速器为例,具体地址可以在腾讯云控制台“容器服务”或“镜像中心”获取最新地址):
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com"
]
}
保存后重启 Docker 服务:
sudo systemctl daemon-reload
sudo systemctl restart docker
3. 内核模块加载
Ubuntu 20.04 默认内核已经支持 OverlayFS,一般不需要额外处理。但如果遇到 overlay2 存储驱动报错,可以检查是否加载了相应内核模块:
sudo modprobe overlay
总结
- 首选方案:Docker 官方 APT 仓库安装。
- 核心步骤:加 GPG 密钥 -> 加源 ->
apt install。 - 腾讯云优化:配镜像提速器 + 开安全组端口。
- 避坑指南:别用
apt install docker.io,除非你只是随便玩玩;记得处理非 root 权限问题。
这套流程在腾讯云的 Ubuntu 20.04 LTS 实例上亲测可用,稳定性高,后续升级也方便(直接 apt upgrade docker-ce 即可)。
云技术博客