在 macos 上配置自动化镜像推送的本地 docker 仓库，需四步：①用 registry:2 启动绑定局域网 ip（如 192.168.1.100:5000）的私有仓库并挂载持久化目录；②通过 docker desktop 设置 insecure-registries 允许 http 推送；③统一使用仓库地址前缀标记镜像（如 192.168.1.100:5000/myapp:v1.0）；④封装构建、tag、push 为脚本实现自动化。
在 macos 上配置支持自动化镜像推送的本地 docker 仓库，核心是搭建一个可信任、可访问、且能被 docker cli 正确识别的私有 registry，并打通从构建 → 标记 → 推送的完整链路。这不是单纯运行一个容器，而是要解决 https 限制、地址可达性、镜像命名规范和客户端信任四个关键问题。
启动可信的本地私有仓库
使用官方 registry:2 镜像启动服务，绑定内网可访问地址（不只限于 127.0.0.1），并挂载持久化目录：
- 拉取镜像：
docker pull registry:2 - 运行仓库（以
192.168.1.100为例，替换为你 Mac 的实际局域网 IP）：docker run -d -v ~/docker-registry:/var/lib/registry -p 5000:5000 --name my-registry -e REGISTRY_HTTP_ADDR=0.0.0.0:5000 registry:2 - 验证服务可用：
curl -I http://192.168.1.100:5000/v2/应返回200 OK
配置 Docker Desktop 允许非 HTTPS 推送
macOS 上 Docker Desktop 不读取 /etc/docker/daemon.json，需通过图形界面设置 insecure registries：
- 打开 Docker Desktop → Settings → Docker Engine
- 在 JSON 配置中添加
"insecure-registries"字段，例如："insecure-registries": ["192.168.1.100:5000"] - 点击 Apply & Restart 使配置生效
- 确认生效：
docker info | grep -A 1 "Insecure Registries"
标准化镜像标记与推送流程
自动化依赖可复用的命名规则。所有镜像必须显式打标为本地仓库地址前缀，再推送：
- 构建后标记：
docker tag nginx:latest 192.168.1.100:5000/myapp:v1.0 - 推送命令固定：
docker push 192.168.1.100:5000/myapp:v1.0 - 验证推送结果：
curl http://192.168.1.100:5000/v2/_catalog查看镜像列表 - 其他机器拉取时，同样使用该完整地址：
docker pull 192.168.1.100:5000/myapp:v1.0
集成到 CI/CD 或脚本实现自动化
将上述步骤封装为 shell 脚本或 Makefile，配合构建工具触发：
- 示例推送脚本
push-to-local.sh：#!/bin/bash<br>IMAGE_NAME="myapp"<br>VERSION="v$(date +%Y%m%d%H%M)"<br>REGISTRY="192.168.1.100:5000"<br>docker build -t "$IMAGE_NAME:$VERSION" .<br>docker tag "$IMAGE_NAME:$VERSION" "$REGISTRY/$IMAGE_NAME:$VERSION"<br>docker push "$REGISTRY/$IMAGE_NAME:$VERSION"
- 确保脚本执行前 Docker Desktop 已运行且配置已生效
- 可进一步接入 GitHub Actions 或本地 Jenkins，监听代码提交后自动构建并推送
