daemon.json 是 docker 守护进程的全局 json 配置文件，位于 linux 的 /etc/docker/daemon.json，用于配置镜像加速、日志限制、dns、data-root、存储驱动、网络网段（bip）、代理（proxies）等；修改后需验证 json 格式并执行 systemctl restart docker 生效。
daemon.json 是 Docker 守护进程的配置文件，用于全局控制 Docker 的行为，比如镜像仓库地址、日志驱动、默认网络设置等。它不是启动时通过命令行传参，而是由 Docker 守护进程在启动时自动读取的 JSON 格式文件。
文件位置和基础结构
Linux 系统默认路径是 /etc/docker/daemon.json；Windows（Docker Desktop）不直接使用该文件，macOS 同理；只有 Linux 服务器或自建 Docker 环境才需要手动创建和编辑它。
文件必须是合法的 JSON 格式，不能有注释，键名区分大小写，建议用双引号包裹所有字符串，结尾不加逗号。
最简可用内容：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
常用配置项说明
以下是一些高频、实用的配置项，按功能归类：
-
镜像加速与私有仓库：加快拉取速度或指向内部 registry
"registry-mirrors": ["https://mirror.gcr.io", "https://docker.mirrors.ustc.edu.cn"],
"insecure-registries": ["192.168.1.100:5000"] -
存储驱动与数据目录：更换存储后端（如 overlay2 是默认推荐），或迁移镜像/容器数据
"storage-driver": "overlay2",
"data-root": "/data/docker" -
网络配置：自定义默认 bridge 网络网段，避免与内网冲突
"default-address-pools": [
{"base": "172.30.0.0/16", "size": 24}
] -
守护进程绑定方式：开放 TCP 接口（慎用，需配合防火墙或 TLS）
"hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2376"]
修改后生效方式
改完 daemon.json 不会自动生效，必须重载或重启 Docker 守护进程：
- 先验证语法是否正确：
sudo dockerd --validate（无输出即为 OK） - 重载配置（推荐，不中断运行中的容器）：
sudo systemctl reload docker - 或重启服务：
sudo systemctl restart docker - 检查是否生效：
docker info | grep -E "(Registry|Root Dir|Logging Driver)"
注意事项和避坑点
容易出错的地方：
- JSON 格式错误（多逗号、单引号、中文标点）会导致 Docker 启动失败，
systemctl status docker可查报错 - 修改
data-root前，确保目标目录存在且 Docker 有读写权限，否则启动失败 -
insecure-registries仅对 HTTP 仓库有效，HTTPS 仓库无需添加；但若证书不被信任，还需额外配置certs.d - 不要随意改动
storage-driver，除非明确知道当前驱动不适用，且已备份数据
