部署PieCloudDB时Harbor服务启动失败：goharbor/harbor-core:dev-arm镜像未找到

问题场景 #

执行命令sudo ./install.sh --with-chartmuseum后，启动Harbor服务出现如下错误：

Error response from daemon: manifest for goharbor/harbor-core:dev-arm not found: manifest unknown: manifest unknown.

核心原因 #

Docker无法找到goharbor/harbor-core:dev-arm镜像，常见诱因包括：

• 该dev-arm标签的镜像未公开推送，仅为内部测试版本
• 当前机器CPU架构与镜像架构不匹配（比如x86机器拉取arm架构镜像）
• 安装脚本中指定的Harbor镜像标签配置错误

解决步骤 #

1. 验证本地CPU架构 #

先确认当前机器的架构是否与镜像匹配：

uname -m

• 若输出x86_64，说明是x86架构，dev-arm是arm架构镜像，自然无法拉取
• 若输出aarch64/arm64，则继续下一步排查

2. 检查安装脚本的镜像配置 #

打开install.sh脚本，搜索goharbor/harbor-core相关设置，确认是否误指定了dev-arm标签。建议替换为官方公开的、适配当前架构的稳定版标签（比如arm64架构的v2.8.3-arm64）。

3. 手动拉取适配镜像并打标签 #

如果脚本依赖dev-arm标签，可手动拉取官方对应架构的镜像，再添加所需标签：

# 示例：拉取arm64架构的Harbor v2.8.3核心镜像
docker pull goharbor/harbor-core:v2.8.3-arm64
# 为镜像添加脚本需要的dev-arm标签
docker tag goharbor/harbor-core:v2.8.3-arm64 goharbor/harbor-core:dev-arm

4. 调整Harbor版本或镜像源 #

如果dev-arm是PieCloudDB内部私有镜像，确认是否有内部镜像仓库地址可配置；若没有，修改安装脚本中的Harbor版本参数，使用官方公开支持当前架构的版本。

5. 重新执行安装 #

完成上述调整后，重新运行安装命令：

sudo ./install.sh --with-chartmuseum

内容的提问来源于stack exchange，提问作者Joe