国内服务器 Docker 安装部署文档

732 字

国内服务器 Docker 安装部署文档

2025-05-09

指南

Docker

目录#

环境要求
安装步骤
- 2.1 卸载旧版本
- 2.2 安装依赖工具
- 2.3 配置国内镜像源
- 2.4 安装 Docker CE
- 2.5 配置镜像加速器
- 2.6 启动与验证
常见问题
扩展配置
注意事项

环境要求#

操作系统：CentOS 7+/Ubuntu 18.04+/Debian 10+
权限要求：root 或具备 sudo 权限的用户

安装步骤#

卸载旧版本#

1
# Debian/Ubuntu 系统
2
sudo apt-get remove docker docker-engine docker.io containerd runc
3

4
# CentOS/RHEL 系统
5
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

说明：确保旧版本残留组件已清理，避免冲突。

安装依赖工具#

1
# Debian/Ubuntu 系统
2
sudo apt-get update
3
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common
4

5
# CentOS/RHEL 系统
6
sudo yum install -y yum-utils device-mapper-persistent-data lvm2

说明：安装 HTTPS 协议支持及软件源管理工具。

配置国内镜像源#

1. 添加 GPG 密钥#

1
# 使用阿里云镜像源（通用命令）
2
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

2. 配置软件源地址#

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

4
# CentOS/RHEL
5
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

说明：替换为阿里云镜像源，大幅提升下载速度。

安装 Docker CE#

1
# Debian/Ubuntu
2
sudo apt-get update
3
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
4

5
# CentOS/RHEL
6
sudo yum makecache fast
7
sudo yum install -y docker-ce docker-ce-cli containerd.io

说明：默认安装最新稳定版，如需指定版本可在包名后追加版本号（如 docker-ce-20.10.17）。

配置镜像加速器#

创建配置文件 /etc/docker/daemon.json：

1
sudo mkdir -p /etc/docker
2
sudo tee /etc/docker/daemon.json <<-'EOF'
3
{
4
  "registry-mirrors": [
5
    "https ://docker .m.daocloud.io",
6
    "https ://docker .1panel.live"
7
  ]
8
}
9
EOF

说明：我这里使用了daocloud和1Panel的镜像加速，可自行替换为其他镜像源。

重启 Docker 生效：

1
sudo systemctl enable docker
2
sudo systemctl daemon-reload
3
sudo systemctl restart docker

启动与验证#

1
# 启动服务并设置开机自启
2
sudo systemctl start docker
3
sudo systemctl enable docker
4

5
# 验证版本
6
docker --version
7

8
# 运行测试容器
9
docker run --rm hello-world

成功标志：终端输出 Hello from Docker!。

常见问题#

1. 权限不足#

1
# 将当前用户加入 docker 用户组
2
sudo usermod -aG docker $USER
3
newgrp docker  # 或重新登录终端

2. 镜像拉取失败#

检查 /etc/docker/daemon.json 格式是否正确（JSON 无注释）。
更换其他镜像源（如腾讯云 https://mirror.ccs.tencentyun.com）。

3. 防火墙拦截#

1
# CentOS 临时关闭防火墙
2
sudo systemctl stop firewalld
3

4
# Ubuntu 临时关闭防火墙
5
sudo ufw disable

扩展配置#

1. 安装 Docker Compose#

1
# 下载最新版本（替换版本号）
2
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
3
sudo chmod +x /usr/local/bin/docker-compose
4

5
# 验证安装
6
docker-compose --version

2. 开启远程 API（谨慎使用）#

1
# 修改 Docker 服务配置
2
sudo sed -i 's#ExecStart=/usr/bin/dockerd#ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375#' /lib/systemd/system/docker.service
3
sudo systemctl daemon-reload && sudo systemctl restart docker