在腾讯云 Ubuntu 系统上安装 Docker,核心原则就一条:别直接用 apt install docker,那是旧版或者不规范的包,容易出各种依赖地狱和版本断层。
最稳妥、也是官方推荐的路径是走 Docker 官方源。这样能保证你拿到的是最新稳定版,且后续升级(apt upgrade)时不会出问题。
下面分步骤来,尽量避开那些虚头巴脑的废话,直接上干货。
第一步:清理“脏”环境(如果之前装过)
很多老教程会让你先卸载 docker.io、docker-doc、docker-compose 这些自带包。如果你是从零开始的裸机,这步可以跳过;如果是重装或之前折腾过,建议执行一下,防止冲突:
sudo apt-get remove docker docker-engine docker.io containerd runc
然后更新一下索引:
sudo apt-get update
第二步:安装前置依赖
Docker 需要一些基础工具来管理 HTTPS 仓库和密钥。这一步在 Ubuntu 20.04/22.04/24.04 上都通用:
sudo apt-get install -y ca-certificates curl gnupg lsb-release
第三步:添加 Docker 官方 GPG 密钥和 APT 源
这是最关键的一步。国内网络环境有时候访问 Docker Hub 的官方源比较慢,甚至超时。强烈建议配置镜像提速或者使用阿里云/腾讯云的镜像源辅助,但为了合规性和稳定性,我们先按标准流程走,后面再讲提速器。
- 下载官方 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
- 设置稳定的 APT 源:
你需要确认你的 Ubuntu 版本代号(比如 focal, jammy, noble)。可以直接用命令自动识别:
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
注意:如果你在腾讯云控制台操作,发现
curl很慢,可以把上面的https://download.docker.com/linux/ubuntu替换为阿里云的 Docker CE 镜像源地址(例如https://mirrors.aliyun.com/docker-ce/linux/ubuntu),速度会快很多。
第四步:安装 Docker Engine
再次更新索引,然后安装最新的 Docker 组件:
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
安装完成后,验证是否成功:
sudo docker run hello-world
如果能打印出 “Hello from Docker!”,说明内核层没问题了。
第五步:配置非 root 用户权限(重要)
默认情况下,运行 Docker 命令需要 sudo。对于日常开发或部署来说,每次敲 sudo 很烦,而且不安全。我们创建一个 docker 用户组,并把当前用户加进去。
-
创建组(如果已存在则忽略):
sudo groupadd docker -
将当前用户加入该组:
sudo usermod -aG docker $USER -
生效权限:
这里有个坑,修改完用户组后,必须重新登录 SSH 或者重启服务器才能生效。直接在当前终端输入newgrp docker有时也不彻底,最稳妥的是退出 SSH 重连。
重连后,测试一下不用 sudo 能不能跑:
docker ps
第六步:配置镜像提速器(国内必做)
在国内拉取 ubuntu, nginx, mysql 等基础镜像,如果不配提速器,大概率会卡死或者超时。
-
编辑 daemon 配置文件:
sudo nano /etc/docker/daemon.json -
写入以下内容(以腾讯云容器镜像服务 CCR 为例,当然也可以用阿里云或其他第三方):
{
"registry-mirrors": [
"https://mirror.ccr.tencentyun.com",
"https://registry.docker-cn.com"
],
"exec-opts": ["native.cgroupdriver=systemd"]
}
关于 cgroup driver:Ubuntu 18.04+ 默认使用 systemd 作为 init 系统,Docker 也推荐使用 systemd 作为 cgroup driver。加上这一行可以避免后续 Kubernetes 或某些编排工具出现兼容性问题。
-
保存退出(Ctrl+O, Enter, Ctrl+X)。
-
重启 Docker 服务使配置生效:
sudo systemctl restart docker
常见问题排查(避坑指南)
-
启动失败?
查看日志:sudo journalctl -xeu docker.service。通常是因为端口冲突或者之前的残留进程没杀干净。 -
防火墙问题?
腾讯云安全组记得放行你要暴露的端口(如 80, 443, 22 等)。Docker 内部自己有一套 iptables/nftables 规则,通常不需要手动改 UFW,除非你强制开启了 UFW 并配置不当。 -
磁盘空间不足?
Docker 镜像和容器会占用大量/var/lib/docker目录的空间。如果是在小内存低配云主机上跑,建议定期执行docker system prune -a清理无用镜像和卷。 -
版本选择:
不要执着于最新版。生产环境建议锁定一个 LTS(长期支持)版本。可以通过apt-cache policy docker-ce查看可用版本,然后用sudo apt-get install docker-ce=<版本号>指定安装。
总结下来,核心就是:官方源 + 镜像提速 + systemd cgroup + 非 root 用户。这套组合拳打下来,在腾讯云 Ubuntu 上基本能稳如老狗。
云技术博客