Docker 安装与配置指南

一、安装#

Note

安装前必读：本文的命令使用的是 root 用户登录执行，不是 root 的话所有命令前面要加 sudo

Tip

现在可以使用轩辕镜像站的一键安装脚本进行安装了

CentOS#

1
# 查看当前内核版本（官方建议 3.10 以上）
2
uname -r
3

4
# 卸载旧版本
5
yum remove docker docker-common docker-selinux docker-engine
6

7
# 安装需要的软件包
8
yum install -y yum-utils device-mapper-persistent-data lvm2
9

10
# 设置 yum 源（推荐阿里源）
11
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
12

13
# 查看可用版本
14
yum list docker-ce --showduplicates | sort -r
15

16
# 安装 Docker
17
yum -y install docker-ce

Ubuntu#

1
# 卸载旧版本
2
sudo apt-get remove docker docker-engine docker.io containerd runc
3

4
# 安装必要支持
5
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release
6

7
# 添加 Docker 阿里源 GPG key
8
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
9

10
# 添加 apt 源
11
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
12

13
# 更新源并安装
14
sudo apt update
15
sudo apt install docker-ce docker-ce-cli containerd.io
16

17
# 查看版本和状态
18
sudo docker version
19
sudo systemctl status docker

Alpine#

1
# 启用 cgroups（不启用会导致 Docker 无法启动）
2
rc-update add cgroups boot
3
rc-service cgroups start
4
mount | grep cgroup
5

6
# 安装 Docker
7
apk add docker docker-compose
8

9
# 创建配置目录
10
mkdir -p /etc/docker
11

12
# 写入基础配置
13
cat > /etc/docker/daemon.json << 'EOF'
14
{
15
  "log-driver": "json-file",
16
  "log-opts": {
17
    "max-size": "5m",
18
    "max-file": "2"
19
  },
20
  "storage-driver": "overlay2",
21
  "default-ulimits": {
22
    "nofile": {
23
      "Name": "nofile",
24
      "Hard": 1024,
25
      "Soft": 512
26
    }
27
  },
28
  "max-concurrent-downloads": 1,
29
  "max-concurrent-uploads": 1
30
}
31
EOF
32

33
# 重启 Docker
34
rc-service docker restart

常用服务命令#

1
# systemctl 系统（CentOS / Ubuntu）
2
systemctl start docker
3
systemctl stop docker
4
systemctl restart docker
5
systemctl enable docker
6

7
# rc-service 系统（Alpine）
8
rc-service docker start
9
rc-service docker stop
10
rc-service docker restart

二、daemon.json 配置#

Tip

Docker Compose 的安装与使用参见：Docker Compose 安装配置，YML 编写参见：Docker Compose YML 编写

迁移存储目录#

Docker 默认将所有数据（镜像、容器、卷）存储在 /var/lib/docker/，生产环境系统盘通常空间有限，建议迁移到数据盘。

Warning

此操作建议在刚安装完 Docker 后执行，迁移前务必停止所有容器，避免数据丢失。

1
# 1. 停止 Docker 服务
2
sudo systemctl stop docker
3

4
# 2. 创建新的数据目录
5
mkdir -p /opt/docker/
6
chmod -R 755 /opt/docker/
7

8
# 3. 迁移现有数据（如有）
9
sudo cp -a /var/lib/docker/* /opt/docker/
10

11
# 4. 修改配置
12
mkdir -p /etc/docker
13
vim /etc/docker/daemon.json

1
{
2
  "data-root": "/opt/docker"
3
}

1
# 5. 重载配置并重启
2
sudo systemctl daemon-reload
3
sudo systemctl restart docker
4

5
# 6. 验证新目录是否生效
6
sudo docker info | grep "Docker Root Dir"
7

8
# 7. 确认数据无误后删除旧目录（可选）
9
rm -rf /var/lib/docker

限制容器日志大小#

方法一：全局配置（推荐，对新容器生效）

1
{
2
  "log-opts": {
3
    "max-size": "500m",
4
    "max-file": "3"
5
  }
6
}

max-size：单个日志文件最大 500MB
max-file：最多保留 3 个日志文件（滚动）

1
systemctl daemon-reload
2
systemctl restart docker

Note

此配置只对重启后新创建的容器生效，已运行的容器需重建才能应用。

方法二：脚本主动清理日志

1
#!/bin/bash
2
# 根据实际 data-root 修改此路径（默认 /var/lib/docker/containers）
3
log_path="/var/lib/docker/containers"
4
for container_id in $(ls "$log_path"); do
5
    log_file="${log_path}/${container_id}/${container_id}-json.log"
6
    if [ -f "$log_file" ]; then
7
        echo "清理容器 ${container_id} 的日志"
8
        truncate -s 0 "$log_file"
9
    fi
10
done
11
echo "日志清理完成"

私服仓库地址#

Note

如需搭建私有镜像仓库，参见：Harbor 私有镜像仓库安装指南。使用自签名证书时还需配置信任：Docker 配置私服自签名证书信任

1
{
2
  "insecure-registries": [
3
    "http://harbor:30001"
4
  ]
5
}

镜像加速#

1
{
2
  "registry-mirrors": [
3
    "http://harbor:30001",
4
    "https://docker.1panel.live"
5
  ]
6
}

三、完整 daemon.json 参考#

1
{
2
  "data-root": "/opt/docker",
3
  "log-opts": {
4
    "max-size": "500m",
5
    "max-file": "3"
6
  },
7
  "insecure-registries": [
8
    "harbor.example.com"
9
  ],
10
  "registry-mirrors": [
11
    "https://docker.example.com"
12
  ]
13
}

一、安装#

CentOS#

Ubuntu#

Alpine#

常用服务命令#

二、daemon.json 配置#

迁移存储目录#

限制容器日志大小#

私服仓库地址#

镜像加速#

三、完整 daemon.json 参考#

支持与分享

评论区

文章目录