努力
加油

Ubuntu 20.04在腾讯云上安装Docker需要哪些前置准备?

在腾讯云 CVM(云服务器)上安装 Docker,核心难点其实不在于 Docker 本身的命令,而在于系统环境兼容性和网络策略配置。Ubuntu 20.04 是一个比较老的 LTS 版本,目前官方支持周期即将结束或已结束,因此在操作时需要特别注意内核版本和源的问题。

以下是基于生产环境经验的实操步骤和避坑指南:

一、 前置准备(最关键的一步)

很多新手直接 apt install docker.io,结果发现版本太老或者功能缺失。正确的做法是确保系统满足以下三个条件:

1. 确认内核版本

Docker 要求 Linux 内核版本 3.10 以上。Ubuntu 20.04 默认内核通常满足要求,但为了保险,先执行:

uname -r

如果返回的内核版本低于 5.4(腾讯云 Ubuntu 20.04 镜像通常自带较新的 HWE 内核),建议更新内核。对于云主机,一般不需要手动编译内核,保持默认即可。

2. 卸载旧版本(如果有)

如果你之前尝试过安装 Docker,可能会残留冲突包。执行清理:

sudo apt-get remove docker docker-engine docker.io containerd runc

3. 设置阿里云/腾讯云镜像提速(重要!)

在国内环境下,直接使用 Docker 官方源下载速度极慢且容易超时。强烈建议在添加 GPG 密钥和源之前,先配置好国内镜像源。

你可以选择使用阿里云容器镜像服务(ACR)提供的 Docker 镜像仓库提速,或者腾讯云的私有镜像提速器(如果你开通了相关服务)。这里以通用的配置方式为例,后续在 daemon.json 中配置。


二、 正式安装步骤

推荐使用官方推荐的 apt 方式安装,这样能获取到最新的安全补丁和功能特性。

1. 更新软件包索引

sudo apt-get update

2. 安装依赖包

这些包允许 apt 通过 HTTPS 使用 repository:

sudo apt-get install 
    ca-certificates 
    curl 
    gnupg 
    lsb-release

3. 添加 Docker 官方 GPG 密钥

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. 设置稳定版仓库

根据 Ubuntu 20.04 的代号 focal 设置仓库:

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

注意:由于国内网络原因,这一步的 https://download.docker.com... 可能会连接超时。如果失败,请改用国内镜像源地址(如阿里云的 Docker CE 镜像源),或者配置XX后重试。

5. 安装 Docker Engine

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

6. 验证安装

sudo docker run hello-world

如果看到 “Hello from Docker!” 字样,说明安装成功。


三、 腾讯云特有优化配置(必做)

在云上运行 Docker,必须解决两个问题:非 root 用户权限 和 网络访问。

1. 配置 Docker 镜像提速(解决拉取慢的问题)

编辑 /etc/docker/daemon.json 文件(如果不存在则创建):

sudo vi /etc/docker/daemon.json

添加以下内容(以阿里云公共镜像提速器为例,你需要去阿里云控制台获取自己的专属地址):

{
  "registry-mirrors": [
    "https://<你的专属ID>.mirror.aliyuncs.com",
    "https://docker.m.daocloud.io"
  ],
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}
  • registry-mirrors: 配置镜像提速源。
  • exec-opts: 指定 cgroup driver 为 systemd,避免与 Kubernetes 或其他组件冲突(推荐)。
  • log-driver: 限制日志大小,防止磁盘被日志撑爆(云服务器磁盘通常不大)。

重启 Docker 服务使配置生效:

sudo systemctl daemon-reload
sudo systemctl restart docker

2. 允许普通用户使用 Docker(可选但推荐)

默认情况下,只有 root 用户可以运行 docker 命令。为了避免每次加 sudo,可以将当前用户加入 docker 组:

sudo usermod -aG docker $USER

注意:修改后需要重新登录 SSH 才能生效,否则新开的终端窗口仍然没有权限。

3. 安全组规则配置

这是腾讯云最容易踩坑的地方。如果你要在容器内暴露端口(如 80, 443, 8080),必须检查:

  1. 实例安全组:在腾讯云控制台 -> 实例详情 -> 安全组 -> 入站规则,放行对应端口。
  2. 防火墙:Ubuntu 20.04 默认可能开启了 ufw。检查状态:
    sudo ufw status

    如果显示 active,需要放行端口:

    sudo ufw allow 80/tcp
    sudo ufw reload

四、 常见问题排查

  1. docker: command not found

    • 检查是否安装成功,或者环境变量未刷新。尝试重启服务器。
  2. 拉取镜像超时

    • 90% 是因为没配镜像提速。确认 /etc/docker/daemon.json 格式正确,并重启了 docker 服务。
    • 如果是从国外源拉取,考虑使用国内中转镜像(如 daocloud 或阿里云)。
  3. 权限拒绝 permission denied

    • 确认是否已执行 usermod -aG docker $USER 并重新登录。
    • 检查文件所有者是否正确。
  4. Ubuntu 20.04 支持问题

    • Docker 官方对 Ubuntu 20.04 的支持可能在某些新版本中逐渐减弱。如果遇到奇怪的依赖错误,可以考虑升级到 Ubuntu 22.04 或 24.04,以获得更好的内核支持和更长的维护周期。

总结

在腾讯云 Ubuntu 20.04 上装 Docker,重点不是安装命令本身,而是后续的镜像提速配置和安全组放行。按照上述步骤操作,基本可以避开 90% 的新手陷阱。记得定期 apt update && apt upgrade 以保持系统安全。