Ubuntu系统更换Docker镜像源的完整指南（2025最新）
作者：BenChuat
在国内使用 Docker 拉取镜像时,经常会遇到连接超时、connection reset by peer 等问题,这是由于默认使用的官方镜像仓库网络不稳定导致的,所以本篇文章将教你如何为 Ubuntu 系统下的 Docker 更换国内可用的镜像加速源,需要的朋友可以参考下
引言
在国内使用 Docker 拉取镜像时，经常会遇到连接超时、connection reset by peer 等问题。这是由于默认使用的官方镜像仓库 registry-1.docker.io 网络不稳定导致的。
本篇文章将教你如何为 Ubuntu 系统下的 Docker 更换国内可用的镜像加速源，以提高镜像拉取速度和稳定性。
一、推荐的镜像源
以下是经过测试稳定可用的国内镜像源：
| 镜像源名称 | 地址 |
|---|---|
| 玄元云加速器 | https://docker.xuanyuan.me |
| 1ms 社区加速器 | https://docker.1ms.run |
| 阿里云（需登录） | https://<你的ID>.mirror.aliyuncs.com |
任选一个或多个进行配置。
二、配置步骤
1. 打开 Docker 的配置文件
sudo nano /etc/docker/daemon.json
如果该文件不存在，可以直接创建。
2. 添加镜像加速配置（推荐使用多个）：
{
"registry-mirrors": [
"https://docker.xuanyuan.me",
"https://docker.1ms.run"
]
}
注意：JSON 格式必须标准，注意逗号和括号。
3. 重启 Docker 服务
sudo systemctl daemon-reload sudo systemctl restart docker
三、验证是否生效
docker info | grep -A 10 -i registry
你应看到如下输出：
Registry Mirrors: https://docker.xuanyuan.me/ https://docker.1ms.run/
四、遇到的一些问题
1. Docker 无法启动
执行以下命令清理可能遗留的 PID 文件：
sudo pkill dockerd sudo rm -f /var/run/docker.pid sudo systemctl daemon-reexec sudo systemctl daemon-reload sudo systemctl restart docker
2. 镜像拉取仍访问 registry-1.docker.io？
- 检查是否有镜像路径写死在
docker-compose.yaml文件中； - 使用
sed批量替换镜像地址（仅适用于明文配置）：
sed -i 's#registry-1.docker.io#docker.xuanyuan.me#g' docker-compose.yaml
五、测试镜像源是否能访问
你可以使用以下命令测试镜像源是否可用：
docker pull docker.xuanyuan.me/library/redis:6-alpine docker pull docker.1ms.run/library/nginx:alpine
附：国内常见镜像加速源汇总
| 平台 | 镜像地址 |
|---|---|
| 玄元云 | https://docker.xuanyuan.me |
| 1ms | https://docker.1ms.run |
| 阿里云 | 登录阿里云https://cr.console.aliyun.com容器镜像服务获取 |
| 清华大学 | https://docker.tuna.tsinghua.edu.cn |
| 中科大 | https://docker.mirrors.ustc.edu.cn |
到此这篇关于Ubuntu系统更换Docker镜像源的完整指南（2025最新）的文章就介绍到这了,更多相关Ubuntu更换Docker镜像源内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！