CasaOS Docker 换源无效的原因与解决方案（完整总结）#

🧩 一、问题原因#

通过查看 Docker 的启动参数：

1
ps aux | grep dockerd

得到输出：

1
/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

注意：

• 这里完全没有 --config-file 参数
• 意味着 Docker 不会自动读取 /etc/docker/daemon.json

所以你写的镜像源配置永远不会生效。

🛠 二、解决方案（必须让 Docker 正确读取 daemon.json）#

核心思路是：覆盖 systemd 中的 Docker 启动参数，加入正确的 config-file。

1
sudo mkdir -p /etc/systemd/system/docker.service.d

1
sudo nano /etc/systemd/system/docker.service.d/override.conf

1
[Service]
2
ExecStart=
3
ExecStart=/usr/bin/dockerd --config-file=/etc/docker/daemon.json

1
sudo systemctl daemon-reload

1
sudo systemctl restart docker

🔍 三、验证是否成功#

1
docker info | grep -A5 Mirrors

如果成功，会显示你配置好的镜像源，例如：

1
Registry Mirrors:
2
 https://docker.1ms.run
3
 https://docker.m.ixdev.cn
4
 http://docker.m.daocloud.io
5
 https://dockerproxy.net
6
 https://xdark.top

🏁 四、总结#

CasaOS 中 Docker 换源不生效的根本原因：

• 系统的 dockerd 启动命令没有使用 --config-file
• 导致 Docker 完全忽略了 /etc/docker/daemon.json

最终解决办法：

• 使用 systemd override 覆盖默认启动参数
• 强制 dockerd 使用 /etc/docker/daemon.json
• 重启 Docker 即可生效