Debian Docker怎么配置

Debian 下的 Docker 配置，一般分安装 Docker、基础配置、常用进阶配置三部分。下面从零开始说明（适用于 Debian 10/11/12）。

一、安装 Docker（Debian）

1. 卸载旧版本（如有）

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

2. 安装依赖

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

3. 添加 Docker 官方 GPG 密钥

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4. 添加 Docker APT 源

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/debian \
$(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. 安装 Docker Engine

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

6. 验证安装

sudo docker run hello-world

二、基础配置（强烈推荐）

1. 允许非 root 用户使用 Docker

sudo usermod -aG docker $USER

重新登录或执行 newgrp docker

2. 设置 Docker 开机自启

sudo systemctl enable docker
sudo systemctl start docker

三、常用配置（/etc/docker/daemon.json）

1. 配置镜像加速器（国内必备）

{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com"
  ]
}

然后重启：

sudo systemctl daemon-reexec
sudo systemctl restart docker

2. 修改 Docker 存储路径（可选）

{
  "data-root": "/data/docker"
}

3. 开启 IPv6（可选）

{
  "ipv6": true,
  "fixed-cidr-v6": "fd00::/80"
}

四、Docker Compose 使用（推荐）

Debian 已内置 compose 插件：

docker compose version

示例：

mkdir nginx && cd nginx
cat > docker-compose.yml <<EOF
version: "3"
services:
  nginx:
    image: nginx:latest
    ports:
      - "80:80"
EOF

docker compose up -d

五、防火墙 & 安全建议

1. 查看 Docker 网络

docker network ls

2. 不暴露 Docker API（除非内网）

不要直接监听 0.0.0.0:2375

六、常见问题

1. Debian 无法拉取镜像？

✅ 配置镜像加速器
✅ 检查 DNS：/etc/resolv.conf

2. Docker 占用磁盘太大？

docker system df
docker system prune -a

七、总结（最小可用配置）

apt update
apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
usermod -aG docker $USER
systemctl enable docker

如果你有具体需求（如：
✅ 内网 Docker
✅ Docker + Nginx + PHP
✅ Docker 私有仓库
✅ Debian 无 GUI / 服务器环境）

可以直接告诉我，我可以给你定制配置方案。