Ubuntu20.04 部署docker容器新手教程

想在 Ubuntu 20.04 上把 Docker 跑起来，最省心的路线是走官方仓库而不是直接下二进制。本文把从零到 docker run hello-world 成功这条完整路径拆开，包含换源、装依赖、加密钥、加仓库、装 Engine、验证、以及国内环境常见的镜像源配置。

零、先看系统版本

cat /proc/version

Docker 官方支持的 Ubuntu 64 位版本包括 22.04（Jammy）、21.10（Impish）、20.04（Focal）、18.04（Bionic）。20.04 虽然在支持列表内，但已经过了主流维护期往上走的时间，新项目建议直接上 22.04 或 24.04。

一、更新软件源并装必要工具

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

这三个是后面加仓库的前置件：证书让 apt 走 HTTPS、curl 用来下载密钥、gnupg 验签、lsb-release 用来取版本号。

二、添加 Docker 官方 GPG 密钥

sudo mkdir -p /etc/apt/keyrings
curl -fsSL Docker 官方 GPG 密钥地址 | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

用 --dearmor 把 ASCII 密钥转成二进制 keyring，这是新系统的推荐做法（老教程里直接 apt-key add 那种已被逐步弃用）。

三、添加软件仓库

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] Docker 官方仓库地址 $(lsb_release -cs) stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

这里用 $(dpkg --print-architecture) 自动填架构、$(lsb_release -cs) 自动填发行版代号（20.04 是 focal），比手写 arch=amd64 / focal 更不容易出错。仓库地址建议走国内镜像站的 docker-ce 目录，下载速度快很多。

四、安装 Docker Engine

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

docker-compose-plugin 建议一起装，命令行用 docker compose（注意中间没横线）就能编排，不用另外装 v1 的 docker-compose。

五、验证安装

docker version

能打印出 Client 和 Server 两边版本即成功。

六、启动与运行测试

sudo systemctl enable docker
sudo systemctl start docker
sudo docker run hello-world

hello-world 会下载一个测试镜像在容器里跑一下然后退出，看到 Hello from Docker! 基本就通了。如果这一步失败，八成是拉取超时，看下一步配镜像源。

七、免 sudo 用 docker（可选）

每次都要 sudo 很烦，把当前用户加进 docker 组：

sudo usermod -aG docker $USER

然后注销重新登录才生效；不想注销就先 newgrp docker 刷新组权限。

注意：docker 组等价于 root 权限，能读 docker.sock 就能拿宿主机 root。所以别随手把普通用户塞进这个组，服务器上的账号要克制。

八、配置国内镜像源

sudo mkdir -p /etc/docker
sudo vi /etc/docker/daemon.json

内容（严格 JSON，别带注释和尾逗号）：

{
  "registry-mirrors": ["Your 镜像源地址"]
}

改完必须重启才生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

验证：

docker info | grep -A 5 Registry Mirrors

能看见配进去的地址就对了。另外别忘了重启后 docker run hello-world 再试一次。

九、日常维护小提示

• 看 Docker 吃了多少盘：docker system df。
• 清掉悬空镜像：docker image prune，定期跑一下别让磁盘被吃满。
• 日志别忘管：容器日志默认无轮转，长期跑要配上 json-file 的 max-size，否则 /var 分区会被日志文件撑爆。
• 升级：sudo apt-get update && sudo apt-get upgrade docker-ce。

整条链路走下来：apt update → 装前置工具 → 加密钥 → 加仓库 → 装 Engine → docker run hello-world → 配镜像源。第一次配完记得把 daemon.json 和仓库源记下来，下次换机器几步就复制过去了。

qidao123.com企服评测-应用市场 编辑提示

本文由齐道123 IT 运维社区整理，记录 Ubuntu 20.04 上从零搭建 Docker 环境的完整步骤。文中不含具体镜像站地址与官方链接，请从 Docker 官网与国内镜像站官方目录页获取；把用户加入 docker 组等同于赋予宿主机 root 权限，仅限可信账号操作。操作仅限自有或已授权主机，升级与安装前请先备份 daemon.json。