使用官方registry镜像可快速搭建本地Golang镜像仓库，通过docker run启动服务并配置持久化存储；构建Golang项目镜像后需重新tag为localhost:5000/命名格式再推送；其他机器拉取前须在daemon.json中配置insecure-registries以支持HTTP访问；定期执行垃圾回收和备份registry-data目录确保存储可控与数据安全。
直接用 registry 官方镜像就能快速搭起本地 Golang 镜像仓库，不需要额外编译或复杂配置。重点是安全访问、持久化存储和正确推送拉取路径。
用 Docker 快速启动本地 registry 服务
registry 是 Docker 官方维护的轻量级镜像仓库服务，支持标准 Docker Registry HTTP API，Golang 项目构建的镜像可直接 push 到它里面。
- 运行命令（后台启动，端口 5000，数据存到
./registry-data）：
docker run -d -p 5000:5000 –restart=always –name registry /
-v $(pwd)/registry-data:/var/lib/registry /
-e REGISTRY_HTTP_ADDR=0.0.0.0:5000 /
registry:2
- 确认服务已就绪：
curl http://localhost:5000/v2/应返回{} - 注意：默认 registry 不带认证，仅限内网或开发环境使用；如需鉴权，后续可加 nginx + basic auth 或用
registry:2的 token auth 配置
为 Golang 项目构建并推送镜像到本地仓库
Golang 项目通常用多阶段构建减小镜像体积，推送前需重打 tag，使其指向本地 registry 地址。
- 假设项目根目录有
main.go和Dockerfile，先构建基础镜像：
docker build -t myapp:latest .
- 再重新打 tag，指向本地 registry（
localhost:5000）：
docker tag myapp:latest localhost:5000/myapp:latest
- 推送：
docker push localhost:5000/myapp:latest
- 验证是否成功：
curl http://localhost:5000/v2/_catalog应返回{"repositories":["myapp"]}
在其他机器或 CI 中拉取本地镜像
只要网络可达，任何安装了 Docker 的机器都能拉取。但需注意两点：Docker 默认只信任 HTTPS 仓库，而本地 registry 是 HTTP；另外要确保 DNS 或 hosts 可解析 registry 地址。
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS：编辑
/etc/docker/daemon.json，加入 insecure-registries：
{
“insecure-registries”: [“localhost:5000”, “192.168.1.100:5000”]
}
- 然后重启 Docker：
sudo systemctl restart docker（Linux）或重启 Docker Desktop（macOS） - 拉取命令与远程一致：
docker pull localhost:5000/myapp:latest - 若用 IP 访问（如
192.168.1.100:5000），请确保该 IP 在insecure-registries列表中，且防火墙放行 5000 端口
清理与日常维护建议
本地 registry 默认不自动清理旧镜像，长期运行后 registry-data 目录会不断增大。
- 手动 GC（垃圾回收）前先停止 registry 容器：
docker stop registry - 执行清理：
docker run --rm -v $(pwd)/registry-data:/var/lib/registry registry:2 bin/registry garbage-collect /etc/docker/registry/config.yml - 建议定期备份
registry-data目录；开发团队共用时，可用 NFS 或 MinIO 替代本地卷，提升可靠性 - 如果只是临时测试，也可用
--rm启动 registry，关掉即丢弃，适合 CI 流水线中的 ephemeral 仓库
基本上就这些。不复杂但容易忽略的是 insecure-registries 配置和 tag 重命名步骤，踩过坑就知道哪几行命令最关键。