一、前言

关于Ubuntu更换docker镜像源，网上有很多的教程，但在实操中发现，更换的源无法生效——原因是我的docker是在系统安装时，选择附加安装的package的方式安装的。
现将处理过程记录如下。

二、获取镜像源

在网上随便找个几个镜像源几个，这是我找到的最新可用的几个（2025年3月16日可用）：

"https://docker.1ms.run"
"https://docker.xuanyuan.me"
"https://mirror.ccs.tencentyun.com"

三、在daemon.json中添加镜像源

3.1 找到daemon.json的位置

网上很多教程是在/etc/目录下新建docker目录和daemon.json文件,并在其中添加并重启应用，但经过我实操，并没有生效。
这里我列举两种可行的方式：

3.1.1 根据docker进程中的加载配置目录定位

ps -ef | grep docker

这条命令会找到正在运行的docker进程，如下图所示。

根据其中的--config-file参数，拿到对应的daemon.json所在路径。

3.1.2 全局搜索该文件

sudo find / -name "daemon.json"

根据网上的各教程，我们可以初步断定，无论这个配置文件在哪个路径，它的文件名大概率都会叫做"daemon.json"，因此我们可以用该文件名进行全局搜索。如下图所示。

注意：
系统配置相关目录，有部分使用普通用户无权限访问，因此建议使用sudo权限运行find命令。
为什么会有两个daemon.json文件。根据我的检查，它们确实是两个文件，而非软连接或硬链接，而其中的/var/snap/docker/3064/config/daemon.json是docker在启动是加载的配置，/snap/docker/3064/config/daemon.json则是在docker启动后，从/var/snap/docker/3064/config/daemon.json加载过来的。
如果你不确定是哪个路径，可以将两个文件都进行修改。

3.2 将配置新增到daemon.json中

{"registry-mirrors": ["https://docker.1ms.run","https://docker.xuanyuan.me","https://mirror.ccs.tencentyun.com"]
}

建议对原配置文件进行备份，然后将文件置空，再将上方内容插入后保存退出。

3.3 重启docker服务

sudo systemctl restart docker.service

注：如果没报错，那么可能你已经成功了。但如果你报错了，如下图所示：

那么就还得确定你的docker服务的名称，它可能不叫做docker。

3.3.1 确定docker服务名

cd /etc
sudo grep -rl docker . | grep "service$"

如下图所示

注：
有两个名称包含“docker”的服务。我们可以对service的配置细节进行查看，这里不做展开，仅将它们的区别简述如下：

服务名称	职责	依赖关系
snap.docker.dockerd.service	容器生命周期管理	依赖snap.docker.nvidia-container-toolkit.service
snap.docker.nvidia-container-toolkit.service	GPU资源分配与容器集成	独立运行

也就是说snap.docker.nvidia-container-toolkit.service负责GPU加速，而snap.docker.dockerd.service才是我们要找的docker服务。

3.3.2 根据找到的服务名重启docker服务

sudo systemctl restart snap.docker.dockerd.service

应该该命令，重启docker

3.3.3 重启报错处理方法

sudo systemctl status snap.docker.dockerd.service

查看运行状态和日志等信息，做进一步定位。

四、验证配置是否成功

sudo docker pull mysql

如果你的配置没问题，那么运行这条命令后，将开始拉取mysql镜像，如下图所示：

注意：不要使用docker search mysql命令代替docker pull mysql进行测试。因为镜像站仅缓存了常用的镜像以供下载，但无法代理搜索请求到Docker Hub，所以docker search命令在更换镜像源后一般也无法正常使用。

---

原创，转发请注明。