懒猫微服进阶心得（七）：懒猫的镜像仓库

这几年国内访问 Dockerhub 总有类似的问题，所以很多情况都建议自建docker 仓库，比如 Habor，Nexus 或者。毕竟 GFW的花样我们想不到。

云厂商的 ECR。但是对于个人玩家或者爱好者来说这一套实在是太重太难以维护了，可能也就是这个原因，懒猫微服也提供了镜像仓库的和本地仓库的功能。

先说镜像仓库，就是从懒猫微服的服务器上先拉 Docker image，然后再推到自己的registry。这一步骤通常由出海链路比较好的机器来完成。

懒猫镜像同步功能

懒猫提供了便捷的镜像同步命令：

lzc-cli appstore copy-image cloudsmithy/lazycat-nav

执行之后就可以看到镜像仓库，registry.lazycat.cloud 这个地址。

重要说明：
这个地址只能在微服环境中使用，如果在其他地方使用会出现认证错误：

docker pull registry.lazycat.cloud/u04123229/cloudsmithy/lazycat-nav:854b14e73ab0726e
Error response from daemon: Head "https://registry.lazycat.cloud/v2/u04123229/cloudsmithy/lazycat-nav/manifests/854b14e73ab0726e": no basic auth credentials

其实就一个加了认证的registry，只是微服有凭证可以直接进。

内置Docker Registry V2

懒猫微服内置了一个简化版的registry，完整使用流程如下：

# 构建x86架构镜像
docker build --platform linux/amd64 -t helloworld:latest .

# 获取当前微服名称
BOXNAME=$(lzc-cli box default)

# 为镜像打上仓库标签
docker tag helloworld:latest dev.$BOXNAME.heiyu.space/helloworld:latest

# 推送镜像到仓库
docker push dev.$BOXNAME.heiyu.space/helloworld:latest

# 从仓库拉取镜像
docker pull dev.$BOXNAME.heiyu.space/helloworld:latest

实际操作演示：

在M2芯片设备上的构建过程：

在Orbstack上拉取验证（先删除本地镜像再拉取）：

通过API查看镜像列表：

这个简单版本的docker registry v2，后面用来做跑CI的镜像仓库应该是够了。

插曲：

如果遇到这个问题，千万别信 AI 是 buildX 坏了，就是中文路径的问题。（AI查一小时。Google一分钟）

docker-container:multiarchERROR: failed to dial gRPC: rpc error: code = Internal desc = rpc error: code= Internal desc =header key"x-docker-expose-session-sharedkey" contains value with non-printable ASCII characters