Docker 装完能跑,很多人就再也没碰过它的全局配置。但有几个坑几乎人人会踩:容器日志无上限,跑几个月把系统盘吃满;dockerd 升级重启,所有容器跟着全停;默认网段 172.17 和公司内网、VPN 撞车,容器莫名其妙连不通。这些问题其实都归同一个文件管——/etc/docker/daemon.json 是整个 Docker 守护进程的总开关,日志、网络、存储、拉取行为全在这里定规矩。这篇给一份可以直接抄走的定版配置,再逐项拆开讲它为什么这么写,最后是数据目录迁移和改完起不来时的自救办法。
动手之前:先备份,再验语法
daemon.json 的位置固定在 /etc/docker/daemon.json(部分发行版可能是 /etc/docker/daemon.json 之外的路径,但绝大多数就是这里)。这个文件不存在时 Docker 用内置默认跑,文件一旦存在,里面的每一项都会覆盖默认值。
改它之前先做两件事。第一,备份:
sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null || echo "原本没有这个文件,直接新建即可"第二,写完先验语法再重启。Docker 23 及以上版本可以让 dockerd 自己校验配置文件:
sudo dockerd --validate --config-file=/etc/docker/daemon.json校验通过会输出 configuration OK。别小看这一步:
WARNINGdaemon.json 是严格 JSON,多一个逗号、少一个引号,dockerd 会直接拒绝启动,机器上所有容器跟着一起停摆。任何时候改完这个文件,都必须先跑一遍
--validate再重启服务;校验报错就对照行号改,改不动就先把备份覆盖回去把服务拉起来,再慢慢查。
定版配置:直接抄这一份
下面是本站长期在用的组合,日志封顶、关掉 userland 代理、开 IPv6 并锁定网段,再加上 live-restore 和拉取并发。逐项含义在下一节拆开讲,这里先给完整文件:
{ "log-driver": "json-file", "log-opts": { "max-size": "20m", "max-file": "3" }, "userland-proxy": false, "ipv6": true, "fixed-cidr-v6": "fdb::/64", "live-restore": true, "max-concurrent-downloads": 5, "max-concurrent-uploads": 5, "registry-mirrors": [], "features": { "buildkit": true }}registry-mirrors 这里留了空数组占位,实际使用时填你自己的加速地址(原因见下文「镜像加速」一节)。写入后别急着重启,先跑上面的 --validate,通过了再执行:
sudo systemctl restart dockersudo docker info逐项拆解:每个开关在管什么
日志:json-file + 20m × 3,先把磁盘保住
log-driver 选 json-file 是 Docker 的默认驱动,胜在简单、docker logs 直接可用。真正的关键是后面两个 log-opts:max-size: 20m 表示单个日志文件长到 20 MB 就滚动切分,max-file: 3 表示最多保留 3 个文件。两者相乘,单个容器的日志占用被硬性封顶在约 60 MB,再话痨的容器也吃不满磁盘。不设这两个参数时,json-file 是无限增长的——这是生产环境最常见的磁盘爆满原因,没有之一。日志驱动和日志查看的更多玩法,可以看日志管理那篇:Docker 日志管理。
userland-proxy:关掉它,端口转发走 iptables
userland-proxy: false 关掉的是 Docker 自带的用户态端口代理。默认开启时,容器端口映射会同时走 iptables 规则和一个用户态进程转发;关掉之后转发完全由 iptables 承担,少一层中转,性能略好,也少一个出故障的环节。绝大多数场景关掉没有副作用;只有极少数 iptables 不可用的环境才需要它兜底。iptables 相关的其他配置不要在这个文件里乱动——Docker 会自己管理它的链,手改容易和它打架。
IPv6:开开关还不够,要锁定网段
光写 ipv6: true 只是允许 Docker 用 IPv6,每个网络实际分到什么前缀还不确定。再配上 fixed-cidr-v6: "fdb::/64",把默认 bridge 的 IPv6 网段固定成 fdb::/64 这段 ULA 地址,行为可预期、好排障。这套组合本站所有机器统一,省得每台分到的段都不一样。IPv6 在容器网络里的完整玩法见 Docker 网络详解。
live-restore:dockerd 重启,容器不陪葬
live-restore: true 是最被低估的一项。没有它时,dockerd 每次升级或重启,全部容器都会被停掉再拉起;开启后守护进程重启期间容器保持运行,进程回来再重新接管。对跑着正经服务的机器,这意味着升级 Docker 版本不再等于全站闪断。注意一个边界:live-restore 与 Swarm 模式不兼容,开了 Swarm 的节点不要启用它(排障一节还会提到)。
拉取并发:按带宽调,别照抄数字
max-concurrent-downloads 和 max-concurrent-uploads 控制同时拉取、推送的镜像层数量,默认都是 3。示例里写 5 是给带宽充裕的机器:层与层并行下载,总时间更短。反过来,带宽小或者和别的业务抢出口时,把并发调低到 1–2 反而更稳,避免把链路打满导致每个层都超时重试。
镜像加速:填你可用的地址,不要迷信公共源
registry-mirrors 是给 Docker Hub 拉取配置的加速镜像列表,只影响 pull,不影响 push。要提醒的是:
WARNING网上流传的公共加速源地址可用性随时间变化非常大,今天能用的下个月可能就停了,不要把任何一个公共源地址当成长期方案写死在配置里。临时救急可以填一个你当下验证可用的;长久之计是在内网自建一个 registry 做 pull-through cache,地址稳定、速度可控。自建私有仓库的做法见 Docker 私有仓库搭建。
features.buildkit:新版默认已开,老版本显式打开
features: { "buildkit": true } 是显式启用 BuildKit 构建引擎。较新的 Docker 版本已经默认开启,这项写上也无妨;还在跑老版本的机器靠它打开 BuildKit,才能用上缓存挂载、并行构建那些新特性。
一张表把定版配置收一下:
| 配置项 | 定版值 | 解决什么问题 |
|---|---|---|
| log-driver / log-opts | json-file + 20m × 3 | 日志无限增长吃满磁盘 |
| userland-proxy | false | 端口转发少一层用户态中转 |
| ipv6 / fixed-cidr-v6 | true / fdb::/64 | IPv6 网段不确定、不可预期 |
| live-restore | true | dockerd 重启导致容器全停 |
| max-concurrent-downloads / uploads | 按带宽取 1–10 | 拉取慢或抢满出口带宽 |
| registry-mirrors | 填自有/当下可用地址 | Docker Hub 拉取慢 |
| features.buildkit | true | 老版本用不上 BuildKit |
data-root 迁移:系统盘不够了,把数据搬走
镜像、容器、卷默认都存在 /var/lib/docker,这个目录就是 Docker 的 data-root。系统盘小、数据涨得快时,需要把它迁到大盘。迁移必须在 Docker 停机状态下做,步骤如下:
sudo systemctl stop dockersudo rsync -aP /var/lib/docker/ /data/docker/rsync -aP 保留全部属性并显示进度。然后在 daemon.json 里加上 data-root 指向新位置:
{ "data-root": "/data/docker"}(实际写入时是把这一项并入你现有的完整配置,不要只留这一项把其他配置冲掉。)启动并确认:
sudo systemctl start dockersudo docker info | grep "Docker Root Dir"docker ps -adocker imagesdocker info 输出的 Docker Root Dir 变成 /data/docker、原有容器和镜像都在、随便挑一个容器能正常启动,迁移才算成功。确认无误之前绝对不要删旧目录;观察几天没问题,再删 /var/lib/docker 释放空间。万一新位置出问题,把 daemon.json 里的 data-root 删掉、重启 Docker 就能回到旧数据,等于留了后路。
default-address-pools:默认网段和内网撞车时
Docker 每建一个自定义网络,就从默认地址池里切一段子网,默认从 172.17 开始往后分。如果你的内网、VPN 或者云厂商 VPC 恰好也用了 172.x 的某些段,就会撞车,表现是容器访问内网地址时路由走错、莫名其妙不通。
解法是在 daemon.json 里用 default-address-pools 换一段干净的池子:
{ "default-address-pools": [ { "base": "172.30.0.0/16", "size": 24 } ]}意思是:所有新建网络都从 172.30.0.0/16 这个大段里切,每段切 /24 大小。选 base 时避开你内网和 VPN 在用的段即可。注意它只对新建的网络生效,已有网络的网段不会变,老项目要生效得重建网络——这点在排障里也常见。
重启与验证清单
改完 daemon.json 的标准收尾动作是重启服务加逐项核对:
sudo systemctl restart dockersudo docker infoWARNING
systemctl restart docker会重启守护进程:没开 live-restore 的机器上,所有容器会随之全部重启一遍。挑低峰期操作,别在业务正忙的时候改这个文件。
docker info 的输出里逐项对:Logging Driver 是不是 json-file、Live Restore Enabled 是不是 true、Docker Root Dir 是不是迁移后的路径、输出里的 IPv6 和 Registry Mirrors 是否符合预期。对不上的项,基本就是配置没被读到,回排障一节排查。整理成清单就是下面这张表,每次改完照着打勾:
| 核对项 | 在哪里看 | 期望结果 |
|---|---|---|
| 配置语法 | dockerd --validate 输出 | configuration OK |
| 日志驱动 | docker info 的 Logging Driver | json-file |
| 日志上限 | 新建容器的 docker inspect 里 LogConfig | max-size 20m、max-file 3 |
| live-restore | docker info 的 Live Restore Enabled | true |
| 数据目录 | docker info 的 Docker Root Dir | 迁移后的新路径 |
| 镜像加速 | docker info 末尾 Registry Mirrors | 与配置填写一致 |
| 容器存活 | docker ps | 原有容器都在且状态正常 |
补充一句生效方式:daemon.json 里只有少数几项(比如镜像加速列表、debug 开关)支持给 dockerd 发 SIGHUP 信号热重载,其余绝大多数改动都必须完整重启守护进程才生效。分不清哪项支持热重载时,不要试,直接按备份 → 校验 → 重启 → 核对的完整流程走,最稳妥。
排障
1. 改完 daemon.json,Docker 直接起不来。 十有八九是 JSON 语法错误,systemctl status docker 和 journalctl -u docker -n 50 里能看到具体的解析报错行。先跑 dockerd --validate --config-file=/etc/docker/daemon.json 定位;修不好就用备份覆盖回去:sudo cp /etc/docker/daemon.json.bak /etc/docker/daemon.json,先把服务恢复,再慢慢改。更多守护进程起不来的排查思路见 Docker 深度排障。
2. 配置明明改了,docker info 里却没生效。 先确认改的是不是 Docker 实际读的那个文件——dockerd --validate 时指定的路径要和服务实际加载的一致;再查启动参数是否覆盖了文件:有些安装方式在 systemd unit 或启动脚本里给 dockerd 带了命令行参数,命令行参数的优先级高于 daemon.json,同名项以参数为准。改 unit 的要 systemctl daemon-reload 后再重启。另外,某些项(比如地址池)只影响新建对象,老对象不变,别误判成没生效。
3. 开了 live-restore,Docker 却报冲突或 Swarm 行为异常。 live-restore 与 Swarm 模式不兼容:节点一旦加入 Swarm,live-restore 就不该开,dockerd 也可能直接给出警告甚至拒绝。单机跑普通容器才用 live-restore;要组 Swarm 集群,就把这一项去掉。
4. 填了 registry-mirrors 还是拉不动镜像。 先确认加速地址本身现在是否可用(公共源失效是常态),再确认配置已生效:docker info 输出末尾有 Registry Mirrors 一栏,列出的就是实际在用的。再就是记住它只管 pull,push 慢和它无关。
小结
daemon.json 的调优本质上就三件事:给日志这类会失控的东西加上限(20m × 3),给守护进程重启这类必然发生的事留活路(live-restore),把网段和数据目录这类环境相关的东西定死成可预期的值(fixed-cidr-v6、data-root、地址池)。改动流程永远是备份 → 写文件 → --validate 验语法 → 重启 → docker info 逐项核对,一步都不要省。这份配置配好之后,Docker 才算从「能跑」变成「可长期托管」。