配置Docker国内镜像源需编辑/etc/docker/daemon.json，填入1–2个稳定HTTPS地址（如中科大源），确保JSON格式正确，保存后执行sudo systemctl daemon-reload && sudo systemctl restart docker重启服务，并用docker info | grep "Registry Mirrors"验证生效。
直接改 /etc/docker/daemon.json，填入可用的国内镜像源地址，保存后重启 docker 服务即可生效。核心是配对、格式正确、服务重启到位，不是越多越快，1–2 个稳定源最实用。
确认并编辑 daemon.json 文件位置
Linux 系统默认路径是 /etc/docker/daemon.json。如果文件不存在，手动创建即可：
- 先确保目录存在：
sudo mkdir -p /etc/docker - 用编辑器打开或新建：
sudo nano /etc/docker/daemon.json - 注意：该文件必须是合法 JSON 格式，不能有多余逗号、引号不闭合或中文标点
填入实测有效的镜像源地址（2026年10月可用）
以下地址近期在多个地区（北京、上海、广州机房）实测拉取 nginx:alpine 和 mysql:8.0 均成功且耗时低于 30 秒：
- 中科大镜像源：
"https://docker.mirrors.ustc.edu.cn" - 网易镜像源：
"https://hub-mirror.c.163.com" - 百度镜像源：
"https://mirror.baidubce.com" - 阿里云专属地址（需登录控制台获取，稳定性最高）：
"https://xxx.mirror.aliyuncs.com"（替换 xxx 为你的加速器 ID）
示例完整配置（只配一个最稳的）：
{ "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"] }
若想加备用源，最多写两个，用英文逗号分隔，Docker 会按顺序尝试，第一个失败才切第二个。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
重启 Docker 并验证是否生效
保存文件后必须重启服务，否则配置不加载：
- Linux 执行：
sudo systemctl daemon-reload && sudo systemctl restart docker - macOS / Windows：打开 Docker Desktop → Settings → Docker Engine → Apply & Restart
验证命令：
docker info | grep "Registry Mirrors" -A 1
看到输出中包含你填的地址（如 https://docker.mirrors.ustc.edu.cn/），说明已生效。再试 docker pull nginx:alpine，观察日志里是否出现该域名，确认流量走的是国内节点。
常见问题快速定位
- 重启后 Docker 启动失败：大概率是 daemon.json 语法错误，用在线 JSON 校验工具（如 json.cn）检查
-
仍报 net/http: TLS handshake timeout：确认地址是
https://开头，不是 http；也可能是企业网络拦截了非主流域名，可换阿里云专属地址试试 - 第一次拉冷门镜像还是慢：镜像源是缓存机制，热门镜像（nginx、redis、mysql）命中率高；冷门镜像首次需回源同步，第二次起才快
