在 Ubuntu 上部署 Docker,尤其是针对轻量级服务器(如阿里云 ECS、腾讯云 CVM 或 AWS EC2),核心思路其实就两步:换源提速和按官方推荐安装。
很多新手容易踩的坑是直接 apt install docker.io,那个版本往往很旧,而且缺乏最新的社区支持。下面我按生产环境的标准流程给你梳理一遍,确保干净、稳定且易于维护。
1. 前置准备:系统更新与依赖清理
首先,登录你的服务器,执行基础更新。这一步是为了确保内核模块和包管理器是最新的,避免后续编译或加载模块时出现版本冲突。
sudo apt update && sudo apt upgrade -y
接着,如果之前手动装过老版本的 Docker(比如通过 pip 或者旧的 .deb 包),建议先卸载干净,防止冲突:
sudo apt remove docker docker-engine docker.io containerd runc
2. 配置 Docker 官方 APT 仓库
这是最关键的一步。国内直接访问 Docker 官方源可能速度不稳定,虽然现在很多镜像站可用,但为了合规性和稳定性,我们优先配置官方源,然后利用系统的XX或后续配置镜像提速器来解决下载慢的问题。
第一步:安装依赖工具
Docker 的 APT 仓库需要通过 HTTPS 访问,所以需要先安装证书和传输协议支持的工具:
sudo apt install -y ca-certificates curl gnupg lsb-release
第二步:添加 Docker 官方 GPG 密钥
为了防止中间人攻击,我们需要验证包的签名。执行以下命令将 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
sudo chmod a+r /etc/apt/keyrings/docker.gpg
第三步:设置 APT 仓库
根据你 Ubuntu 的具体版本号(可以用 lsb_release -cs 查看,比如 jammy, focal 等),添加对应的仓库源。以常见的 Ubuntu 22.04 (Jammy Jellyfish) 为例:
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" |
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
注意:如果你使用的是其他版本,请将
$(. /etc/os-release && echo "$VERSION_CODENAME")替换为具体的代号,如focal(20.04),bionic(18.04)。
3. 安装 Docker Engine
现在,更新包索引并安装最新版的 Docker 组件:
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
这里安装的不仅仅是 docker-ce(社区版引擎),还包含了 CLI 客户端、容器运行时 containerd.io 以及构建插件和 Compose 插件,基本覆盖了日常开发需求。
4. 验证安装
安装完成后,Docker 服务通常会自动启动。你可以检查状态并运行一个简单的测试容器:
# 检查服务状态
sudo systemctl status docker
# 运行 hello-world 测试
sudo docker run hello-world
如果看到 “Hello from Docker!” 的输出,说明环境部署成功。
5. 优化配置:非 root 用户管理与镜像提速
在生产环境中,直接用 root 操作 Docker 是不安全的,而且每次都要敲 sudo 也很麻烦。此外,拉取镜像时国内网络环境需要优化。
A. 允许非 root 用户管理 Docker
创建 docker 用户组,并将当前用户加入该组:
sudo groupadd docker
sudo usermod -aG docker $USER
重要提示:修改后需要重新登录终端(logout 再 login)或者重启机器,才能生效。之后你就可以直接运行 docker ps 而不需要 sudo 了。
B. 配置镜像提速器
由于 Docker Hub 在国内访问速度受限,建议在 /etc/docker/daemon.json 中配置镜像提速器。这里以阿里云或腾讯云的公共提速器为例(你需要去对应云平台控制台获取你自己的专属地址,因为免费公共地址有时限或频率限制):
{
"registry-mirrors": [
"https://your-code.mirror.aliyuncs.com",
"https://mirror.ccs.tencentyun.com"
],
"exec-opts": ["native.cgroupdriver=systemd"]
}
注:native.cgroupdriver=systemd 是为了让 Docker 使用 systemd 作为 cgroup 驱动,这与 Linux 系统的资源管理更兼容,特别是在 Kubernetes 环境下也是标准配置。
保存文件后,重启 Docker 服务使配置生效:
sudo systemctl daemon-reload
sudo systemctl restart docker
6. 常见问题排查
- 权限问题:如果报错
permission denied,确认是否已重新登录以激活用户组变更。 - 端口占用:如果启动失败,检查 2375 或 2376 端口是否被其他服务占用。
- Kernel 版本:Docker 要求 Linux 内核版本至少为 3.10,且必须是 64 位系统。Ubuntu 18.04+ 默认都满足此要求。
通过以上步骤,你就在一个标准的 Ubuntu 轻量服务器上搭建好了一个符合生产规范、安全且高效的 Docker 环境。后续如果需要部署应用,直接使用 docker run 或编写 docker-compose.yml 即可。
云技术博客