Docker镜像加速配置教程

全面指南:在Linux、Windows、OpenWrt及带luci-app-dockerman的OpenWrt上配置Docker镜像加速器

重要提示

由于国内镜像源变动频繁,请根据实际情况选择可用的镜像源。配置前请确保Docker服务已正确安装并运行。

阿里云镜像加速器
本人自建镜像加速器(Cloudflare)
amingg镜像加速器
1panel(live)镜像加速器

Linux系统

Ubuntu/CentOS/Debian

1 修改配置文件

sudo mkdir -p /etc/docker sudo nano /etc/docker/daemon.json

2 添加镜像加速器

{ "registry-mirrors": [ "https://<阿里云加速地址>", "https://registry2.xcqcoo.top", "https://docker.amingg.com", "https://docker.1panel.live" ] }

3 重启Docker服务

sudo systemctl restart docker
请将<阿里云加速地址>替换为阿里云容器镜像服务提供的专属加速器地址

Windows系统

Docker Desktop

1 Docker设置

右键点击系统托盘中的Docker图标,选择"Settings"

2 配置镜像加速器

导航到"Docker Engine"选项卡,添加:

{ "registry-mirrors": [ ""https://<阿里云加速地址>", "https://registry2.xcqcoo.top", "https://docker.amingg.com", "https://docker.1panel.live" ] }

3 应用并重启

点击"Apply & Restart"按钮使配置生效

Windows版Docker Desktop需要开启WSL 2或Hyper-V后端支持

OpenWrt

基础配置

1 安装Docker

opkg update opkg install dockerd docker

2 编辑配置文件

vim /etc/docker/daemon.json

3 添加镜像加速器

{ "registry-mirrors": ["https://https://registry2.xcqcoo.top"], "data-root": "/to/your/disk/docker/" }

4 重启服务

/etc/init.d/dockerd restart
请确保OpenWrt设备有足够的存储空间,建议将data-root指向外部存储

OpenWrt进阶

luci-app-dockerman

1 安装插件

opkg update opkg install luci-app-dockerman

2 Web界面配置

登录OpenWrt Web管理界面 → 服务 → Docker → 配置

3 设置镜像源

在"Docker 守护程序配置"区域添加:

https://registry2.xcqcoo.top

4 保存并应用

点击"保存&应用"按钮,然后重启Docker服务

在luci-app-dockerman界面也可以直接管理容器和镜像

验证与测试

验证镜像加速是否生效

$
docker info | grep -A 1 "Registry Mirrors"

在输出中查找"Registry Mirrors"部分,确认列出的镜像地址

测试镜像拉取速度

$
docker pull ubuntu:22.04

观察下载速度,通常使用镜像加速后速度会有显著提升

查看当前使用的镜像源

$
docker system info | grep Registry
如果配置后拉取镜像仍缓慢,请尝试更换其他镜像源或检查网络连接