跳转至

Docker 安装指南 (非中国大陆环境)

本指南适用于在中国大陆网络环境下,在 Ubuntu 系统上安装 Docker 并配置国内镜像源。

1. 准备工作

首先,确保删除系统中可能存在的旧版本 Docker:

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

2. 安装 Docker

我们将使用 Ubuntu 的官方仓库来安装 Docker:

# 更新软件包索引
sudo apt-get update

# 安装 Docker
sudo apt-get install docker.io

3. 启动 Docker 服务

安装完成后,启动 Docker 服务并设置为开机自启:

# 启动 Docker 服务
sudo systemctl start docker

# 设置 Docker 开机自启
sudo systemctl enable docker

4. 配置用户权限

为了避免每次使用 Docker 命令时都需要 sudo,我们将当前用户添加到 docker 用户组:

# 将当前用户添加到 docker 用户组
sudo usermod -aG docker $USER

# 切换到新的 docker 用户组(此命令将启动一个新的 shell 会话)
newgrp docker

注意:在某些情况下,可能需要注销并重新登录,或重启系统,以使组成员身份更改生效。

5. 配置镜像加速

为了加快在中国大陆环境下拉取 Docker 镜像的速度,我们将配置国内的镜像加速器。这里我们使用 AtomGit 提供的镜像源:

# 创建 Docker 配置目录
sudo mkdir -p /etc/docker

# 配置镜像加速器
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://hub.atomgit.com"]
}
EOF

# 重新加载 Docker 守护进程配置
sudo systemctl daemon-reload

# 重启 Docker 服务
sudo systemctl restart docker

6. 验证安装

完成以上步骤后,我们可以验证 Docker 是否正确安装并配置:

# 检查 Docker 版本
docker version

# 运行 hello-world 容器
docker run hello-world

如果一切正常,您应该能看到 Docker 的版本信息,并且 hello-world 容器应该能够成功运行。

故障排除

  1. 如果遇到权限问题,确保您已经将用户添加到 docker 组并重新登录。

  2. 如果镜像拉取速度仍然很慢,可以尝试其他的国内镜像源,例如:

  3. 阿里云:https://mirrors.aliyun.com/docker-ce/linux/ubuntu
  4. 网易:https://hub-mirror.c.163.com

替换 /etc/docker/daemon.json 中的 URL 即可。

  1. 如果 docker version 命令显示 Client 版本但没有 Server 版本,检查 Docker 守护进程是否正在运行:

    sudo systemctl status docker
    

  2. 如果在安装过程中遇到网络问题,可以尝试更换 Ubuntu 的软件源为国内镜像。

注意事项

  • 定期更新 Docker:

    sudo apt-get update
    sudo apt-get upgrade docker.io
    

  • 在生产环境中使用 Docker 时,请确保了解并遵循最佳安全实践。

  • 如果您需要使用最新版本的 Docker,可能需要考虑使用 Docker 的官方仓库,但这可能需要额外的网络配置。

希望这个指南能帮助您在中国大陆的网络环境下顺利安装和使用 Docker。如果遇到任何问题,请随时查阅 Docker 的官方文档或寻求社区帮助。