简介面向需要在ARM架构服务器或国产化环境中部署Harbor的运维与开发人员这份离线安装包解决了内网环境无法直接拉取镜像、编译安装复杂的难题。资源为harbor-v2.4.0的ARM64版本zip压缩包共6个文件包含两个Shell脚本、Harbor镜像tar.gz压缩包、核心配置文件YAML、官方许可证以及prepare预检工具执行安装脚本即可自动完成部署用户只需提前装好Docker与Docker Compose。整个包约402MB避免了在线获取镜像的不稳定因素可离线快速搭建企业级镜像仓库。目前已有1571人学习下载适合掌握基础容器概念、希望高效完成私有仓库部署的读者。下载后可直接获得完整可运行的安装脚本、镜像包和配置模板便于在ARM架构服务器上一键复用也适合作为内网环境下的离线交付方案。 搞ARM服务器部署这套东西最大的麻烦不是Harbor本身而是“离线”和“架构”这两个词凑到了一起。我在一台aarch64的机器上部署Harbor v2.4.0时前前后后踩了镜像架构不匹配、docker compose版本不对、数据库起不来、推送镜像时HTTP和HTTPS互相较劲这些坑。这篇就把完整的离线安装流程和排查思路记录下来给需要在信创环境、内网机房或者自建ARM集群里装Harbor的运维和DevOps朋友做个参考。文章会覆盖环境确认、Docker与Compose的离线安装、Harbor配置部署、常见报错处理这几块按步骤走基本能一次搞定。1. 装之前先把这3件事想明白1.1 确认你的机器是不是真的aarch64很多朋友拿到一台“ARM服务器”上来就要装结果第一步就翻车。先别急着下载安装包老老实实敲三个命令确认环境。uname -m cat /etc/os-release free -huname -m输出应该是aarch64。有些国产系统或者定制内核可能会显示arm64本质一样但后续所有软件包都要认准这个架构。系统版本决定你用哪种方式装Docker内存大小决定Harbor能不能跑起来。Harbor 2.4.0全套容器nginx、core、registry、db、redis、jobservice、portal、log跑起来内存占用实测至少2GB。如果你只有1GB内存别挣扎先把swap准备好或者加内存条。我在4GB内存的ARM设备上部署开swap之后整体还算稳定在2GB内存的机器上试过postgres反反复重启最后只能关掉一部分非必要组件才勉强起来。所以给个硬性建议内存4GB起步swap再给2GB勉强算舒适区。操作系统方面Ubuntu 20.04/22.04的arm64版本是最省心的CentOS 7的aarch64版本、openEuler、麒麟V10这些我也见人跑过但本文所有步骤以Ubuntu/Debian系为主同时会标注CentOS/国产系统的差异点。1.2 离线包到底该选哪个Harbor官方Release页面提供两类安装包harbor-offline-installer-v2.4.0.tgz离线安装包里面带了一个harbor.v2.4.0.tar.gz镜像归档安装时直接docker load全程不需要联网。harbor-online-installer-v2.4.0.tgz在线安装包安装时会从Docker Hub拉取镜像离线环境完全不能用。所以答案很明确离线环境必须选offline包。有个细节需要留意官方offline包里的镜像是支持多架构的amd64和arm64都包含在aarch64机器上执行docker load后会自动加载arm64版本。这也是我推荐直接下载官方offline包而非自己在网上随便找个包的原因——网上有些“离线包”其实是在x86机器上docker save出来的copy到ARM机器上load虽然能成功但容器启动时直接exec format error那个坑等到第4节再细说。下载地址就是Harbor的GitHub Releases页面搜索harbor-offline-installer-v2.4.0.tgz就能找到。压缩包大概六七百MB下载后记得校验一下sha256。解压完目录结构大概是这样的tree -L 1 harbor harbor/ ├── common.sh ├── harbor.v2.4.0.tar.gz ├── harbor.yml.tmpl ├── install.sh ├── LICENSE └── prepare1.3 整体安装链路是什么Harbor本质上是基于Docker Compose编排的一组容器所以离线安装的核心链路非常清晰装Docker引擎装Docker Composev2插件形式导入Harbor的镜像归档修改harbor.yml配置文件执行install.sh启动全部容器这五步每一步都有各自的小坑后面章节按顺序逐个拆。2. 基础依赖离线安装实测2.1 用二进制方式离线安装Docker在ARM离线环境装Docker最通用的方式是二进制安装。网上很多教程教你先在有网的机器上apt download或者yum install后把rpm/deb包拷过去这方法在依赖简单的环境能用但一旦碰上依赖链复杂的系统会把你折腾到怀疑人生。二进制方式的好处是干净、可控、不依赖包管理器所有运行文件扔到/usr/bin就完事。具体操作如下在有网且同架构aarch64的机器上从Docker官方静态二进制地址下载# 注意地址中的stable/aarch64部分是关键 wget https://download.docker.com/linux/static/stable/aarch64/docker-24.0.7.tgz拷贝到目标机器后执行tar -xzvf docker-24.0.7.tgz cp docker/* /usr/bin/ mkdir -p /etc/docker /var/lib/docker接下来写systemd服务。创建/etc/systemd/system/docker.service内容如下[Unit] DescriptionDocker Service Afternetwork-online.target [Service] Typenotify ExecStart/usr/bin/dockerd ExecReload/bin/kill -s HUP $MAINPID LimitNOFILE1048576 LimitNPROCinfinity LimitCOREinfinity [Install] WantedBymulti-user.target启动并设置开机自启systemctl daemon-reload systemctl enable --now docker docker version建议先配置一下/etc/docker/daemon.json把Harbor的地址提前加入到insecure-registries。这个配置直接关系到后面能不能正常docker login和docker push到第4节会详细说原理这里先把配置写好{ insecure-registries: [192.168.10.20:80] }改完配置记得systemctl restart docker。2.2 安装Docker Compose v2Harbor 2.4.0的install.sh脚本在启动时会调用Compose命令。现在新环境一般都直接装Compose v2插件不再推荐老掉牙的Python版docker-compose。二进制安装方式同样适用于离线环境。在有网的aarch64机器上下载Compose v2二进制文件wget https://github.com/docker/compose/releases/download/v2.23.3/docker-compose-linux-aarch64拷贝到目标机器后mkdir -p /usr/local/lib/docker/cli-plugins cp docker-compose-linux-aarch64 /usr/local/lib/docker/cli-plugins/docker-compose chmod x /usr/local/lib/docker/cli-plugins/docker-compose docker compose version看到版本号输出就说明Compose已经就位。这里有个容易犯迷糊的点Compose v2是作为Docker的插件存在的命令是docker compose中间有空格不是老版的docker-compose。Harbor的install.sh会优先检测docker compose不行再找docker-compose所以把v2插件装好就不会卡在这一步。如果目标机器是CentOS7 aarch64这类系统需要额外确认内核版本和glibc版本是否满足Compose v2的要求。实测CentOS 7.9的aarch64内核装了太新的Compose v2可能会报/lib64/libc.so.6: version GLIBC_2.28 not found建议这种老系统改用Compose v2.20.x左右的版本或者干脆用v1的docker-compose。2.3 导入Harbor镜像并检查架构进入解压后的harbor目录执行镜像导入cd harbor docker load -i harbor.v2.4.0.tar.gz这个过程根据机器性能差异可能需要几分钟到十几分钟。导入完成后务必抽出时间检查一下镜像架构不要偷懒docker images | grep goharbor如果只看镜像列表没问题再用inspect确认关键镜像的架构docker image inspect goharbor/harbor-core:v2.4.0 --format {{.Architecture}}正常输出应该是arm64。如果这里显示amd64那你拿到的离线包有问题继续往下装必炸后面4.2节会给出解决办法。3. Harbor配置与部署全流程3.1 修改harbor.yml的关键项从模板复制一份配置文件cp harbor.yml.tmpl harbor.yml编辑器打开后重点关注以下几项第一是hostname。在离线内网环境直接填服务器的IP地址最省事比如192.168.10.20。如果你后面打算用域名访问这里就填域名并要保证内网DNS能解析到这台机器。这个字段会影响Harbor生成的所有访问URL改起来牵扯面很大一次性想清楚。第二是HTTP端口。默认http.port: 80如果80端口已经被占用Harbor的nginx容器起不来。我在一台跑着nginx的机器上部署时就撞上了改成8080后一切正常。建议提前确认端口占用ss -lntp | grep -E :80|:443第三是HTTPS配置。如果暂时没有正规证书先把整段https:配置注释掉。Harbor 2.4.0的harbor.yml.tmpl里https配置块是有内容的不注释掉的话prepare脚本会去找证书文件找不到就报错。离线内网环境可以先跑HTTP后面想升级再按照4.4节的步骤平滑切换。第四是管理员密码。默认是Harbor12345这个密码是公开的不修改等于裸奔。在harbor_admin_password字段处改成自己的强密码。第五是数据库密码。database.password默认是root123。要说清楚一个大坑如果Harbor已经初始化过数据库此时再修改这个密码会导致postgres起不来因为存量的数据库文件还是用旧密码加密的。要么在首次安装时就确定好密码要么连/data/database目录一起清理掉重新初始化会丢失所有仓库数据没有第三条路。3.2 执行安装脚本并验证服务配置改好后直接执行安装脚本./install.sh注意离线环境一定不要加--with-trivy参数。Trivy启动时会去GitHub下载漏洞数据库离线环境根本拉不下来卡在这里非常尴尬。如果确实需要漏洞扫描功能得在有网环境把trivy-db准备好再手动挂载进去这个复杂度不是一般离线部署能承受的建议第一批先跑核心功能扫描后面再补。安装脚本执行过程中会依次检查docker、compose然后执行prepare生成配置最后通过Compose把所有容器拉起来。看到以下输出基本就成功了✔ ----Harbor has been installed and started successfully.----验证服务状态docker compose ps所有服务的STATUS应该是UpHarbor的nginx容器会监听你配置的端口。浏览器访问http://192.168.10.20:8080用admin和你设置的密码登录能看到UI页面就说明部署成功。另外检查一下日志有没有隐藏报错docker compose logs -f --tail200如果某个容器在反复重启优先看它的日志大部分问题都能从这里找到线索。3.3 ARM设备上的资源分配建议在ARM设备上跑Harbor资源规划比别人x86服务器要上心得多。我实测的容器数量和默认资源占用情况如下容器主要用途稳定运行经验值harbor-dbPostgreSQL存储元数据512MB以上内存harbor-registry镜像存储OCI分发视镜像仓库容量内存占用相对小harbor-coreAPI、UI后端逻辑256MB以上内存harbor-portalUI前端静态页面内存占用很低harbor-nginx反向代理内存占用低harbor-redis缓存与锁128MB左右如果内存紧张的ARM设备建议加swapfallocate -l 2G /swapfile chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo /swapfile none swap sw 0 0 /etc/fstab另外/data目录尽量放到独立分区或者大容量的数据盘上。Harbor的所有镜像数据都落在/data/registry目录下仓库用久了之后这块的磁盘增长非常可观。系统盘只有20GB的小机器很容易被撑爆别等磁盘满了才想起来。4. 常见报错与排查记录4.1 docker push报http和https冲突部署完后在客户端执行docker login和docker push时最常见的报错是Error response from daemon: Get https://192.168.10.20:8080/v2/: http: server gave HTTP response to HTTPS client原因很简单Docker客户端默认用HTTPS协议访问registry而Harbor目前只开了HTTP端口。解决方式是在所有需要使用这个Harbor的客户端机器上修改/etc/docker/daemon.json{ insecure-registries: [192.168.10.20:8080] }注意两点一是insecure-registries里的地址必须是Harbor的hostname:port完整形式端口要对上二是改完要重启dockersystemctl restart docker之后再用docker login 192.168.10.20:8080测试就不会再报这个错了。如果不想让每台客户端都配置insecure-registries那就得走HTTPS方案见4.4节。4.2 exec format error与镜像架构不匹配容器启动时报这样的错standard_init_linux.go:228: exec user process caused: exec format error基本可以断定镜像架构不对你在aarch64上跑了个amd64的镜像。排查命令docker image inspect goharbor/harbor-core:v2.4.0 --format {{.Architecture}}输出如果是amd64说明镜像包来源有问题。直接去下载官方offline包重新load官方包的镜像在arm机器上会是arm64。如果官方包也出现这种情况可以试试在目标机器上手动指定平台重新拉取镜像仅限有网时docker pull --platform linux/arm64 goharbor/harbor-core:v2.4.0如果完全离线且手头只有amd64离线包还有一个比较重的办法找一台能联网的aarch64机器把需要的镜像全部pull下来再save成tar包copy进内网load。虽然麻烦但能解决“只有错误架构包”的窘境。4.3 改了database密码后数据库连不上这是一个非常隐蔽的坑。Harbor首次执行./install.sh时会根据harbor.yml里的database.password初始化postgres中的数据目录。如果此时Harbor已经正常运行过你再去改harbor.yml里的数据库密码然后重新执行install.sh会看到harbor-db容器不断重启日志提示密码认证失败。原因就是postgres数据文件里的密码还是旧密码而core和jobservice组件是用新密码去连接的两边对不上。解决办法备份所有镜像数据/data/registry停掉Harbor所有容器docker compose down删除旧数据库目录rm -rf /data/database重新执行./install.sh这个操作会清空所有镜像的元数据镜像文件本身如果在registry里也会丢代价非常大。所以再次强调首次安装时就要把database.password定好之后只改管理员密码别动数据库密码。4.4 HTTP平滑升级到HTTPS很多人刚开始图省事用HTTP部署后面等真要对接外部系统时又得切HTTPS。好消息是Harbor支持在不丢数据的前提下平滑升级。前提是你得有证书文件。内网环境用自签证书即可用openssl生成openssl req -x509 -nodes -newkey rsa:4096 -keyout server.key -out server.crt -days 3650 -subj /CN192.168.10.20然后在harbor.yml中取消https段落注释并把证书路径指到这两个文件https: port: 443 certificate: /data/cert/server.crt private_key: /data/cert/server.key接着执行docker compose down ./install.sh这样HTTP和HTTPS可以同时监听。客户端那边如果用的是自签证书还是需要在/etc/docker/daemon.json里加入insecure-registries或者把证书配置到客户端的证书信任目录二选一。切换完成后记得把之前镜像仓库里的镜像重新打tag推送一遍确保客户端使用新协议能正常登录和推送。最后再分享一个小技巧整个流程走完我最大的感受是ARM架构下离线部署Harbor真正难的不是Harbor本身而是基础依赖的架构匹配和离线资源准备。如果条件允许建议在装之前把下面这几样东西一次性准备好官方offline包、aarch64的Docker二进制、aarch64的Compose插件、以及至少2GB的swap。这四样齐了后面基本就顺风顺水。另外我自己习惯在部署完Harbor之后第一时间用另一台机器测试docker login和docker push而不是只在浏览器里看看UI。UI能打开只说明nginx和portal正常只有真正走完一遍推送流程才说明registry、core、db这些核心组件都协调工作了。这个部署方案后续还可以扩展比如用Harbor的复制功能做双中心仓库同步或者接入LDAP做统一认证都是内网环境下非常实用的方向。先把手上的这一套跑稳后面再慢慢加功能也不迟。本文还有配套的精品资源点击获取
简介面向需要在ARM架构服务器或国产化环境中部署Harbor的运维与开发人员这份离线安装包解决了内网环境无法直接拉取镜像、编译安装复杂的难题。资源为harbor-v2.4.0的ARM64版本zip压缩包共6个文件包含两个Shell脚本、Harbor镜像tar.gz压缩包、核心配置文件YAML、官方许可证以及prepare预检工具执行安装脚本即可自动完成部署用户只需提前装好Docker与Docker Compose。整个包约402MB避免了在线获取镜像的不稳定因素可离线快速搭建企业级镜像仓库。目前已有1571人学习下载适合掌握基础容器概念、希望高效完成私有仓库部署的读者。下载后可直接获得完整可运行的安装脚本、镜像包和配置模板便于在ARM架构服务器上一键复用也适合作为内网环境下的离线交付方案。 搞ARM服务器部署这套东西最大的麻烦不是Harbor本身而是“离线”和“架构”这两个词凑到了一起。我在一台aarch64的机器上部署Harbor v2.4.0时前前后后踩了镜像架构不匹配、docker compose版本不对、数据库起不来、推送镜像时HTTP和HTTPS互相较劲这些坑。这篇就把完整的离线安装流程和排查思路记录下来给需要在信创环境、内网机房或者自建ARM集群里装Harbor的运维和DevOps朋友做个参考。文章会覆盖环境确认、Docker与Compose的离线安装、Harbor配置部署、常见报错处理这几块按步骤走基本能一次搞定。1. 装之前先把这3件事想明白1.1 确认你的机器是不是真的aarch64很多朋友拿到一台“ARM服务器”上来就要装结果第一步就翻车。先别急着下载安装包老老实实敲三个命令确认环境。uname -m cat /etc/os-release free -huname -m输出应该是aarch64。有些国产系统或者定制内核可能会显示arm64本质一样但后续所有软件包都要认准这个架构。系统版本决定你用哪种方式装Docker内存大小决定Harbor能不能跑起来。Harbor 2.4.0全套容器nginx、core、registry、db、redis、jobservice、portal、log跑起来内存占用实测至少2GB。如果你只有1GB内存别挣扎先把swap准备好或者加内存条。我在4GB内存的ARM设备上部署开swap之后整体还算稳定在2GB内存的机器上试过postgres反反复重启最后只能关掉一部分非必要组件才勉强起来。所以给个硬性建议内存4GB起步swap再给2GB勉强算舒适区。操作系统方面Ubuntu 20.04/22.04的arm64版本是最省心的CentOS 7的aarch64版本、openEuler、麒麟V10这些我也见人跑过但本文所有步骤以Ubuntu/Debian系为主同时会标注CentOS/国产系统的差异点。1.2 离线包到底该选哪个Harbor官方Release页面提供两类安装包harbor-offline-installer-v2.4.0.tgz离线安装包里面带了一个harbor.v2.4.0.tar.gz镜像归档安装时直接docker load全程不需要联网。harbor-online-installer-v2.4.0.tgz在线安装包安装时会从Docker Hub拉取镜像离线环境完全不能用。所以答案很明确离线环境必须选offline包。有个细节需要留意官方offline包里的镜像是支持多架构的amd64和arm64都包含在aarch64机器上执行docker load后会自动加载arm64版本。这也是我推荐直接下载官方offline包而非自己在网上随便找个包的原因——网上有些“离线包”其实是在x86机器上docker save出来的copy到ARM机器上load虽然能成功但容器启动时直接exec format error那个坑等到第4节再细说。下载地址就是Harbor的GitHub Releases页面搜索harbor-offline-installer-v2.4.0.tgz就能找到。压缩包大概六七百MB下载后记得校验一下sha256。解压完目录结构大概是这样的tree -L 1 harbor harbor/ ├── common.sh ├── harbor.v2.4.0.tar.gz ├── harbor.yml.tmpl ├── install.sh ├── LICENSE └── prepare1.3 整体安装链路是什么Harbor本质上是基于Docker Compose编排的一组容器所以离线安装的核心链路非常清晰装Docker引擎装Docker Composev2插件形式导入Harbor的镜像归档修改harbor.yml配置文件执行install.sh启动全部容器这五步每一步都有各自的小坑后面章节按顺序逐个拆。2. 基础依赖离线安装实测2.1 用二进制方式离线安装Docker在ARM离线环境装Docker最通用的方式是二进制安装。网上很多教程教你先在有网的机器上apt download或者yum install后把rpm/deb包拷过去这方法在依赖简单的环境能用但一旦碰上依赖链复杂的系统会把你折腾到怀疑人生。二进制方式的好处是干净、可控、不依赖包管理器所有运行文件扔到/usr/bin就完事。具体操作如下在有网且同架构aarch64的机器上从Docker官方静态二进制地址下载# 注意地址中的stable/aarch64部分是关键 wget https://download.docker.com/linux/static/stable/aarch64/docker-24.0.7.tgz拷贝到目标机器后执行tar -xzvf docker-24.0.7.tgz cp docker/* /usr/bin/ mkdir -p /etc/docker /var/lib/docker接下来写systemd服务。创建/etc/systemd/system/docker.service内容如下[Unit] DescriptionDocker Service Afternetwork-online.target [Service] Typenotify ExecStart/usr/bin/dockerd ExecReload/bin/kill -s HUP $MAINPID LimitNOFILE1048576 LimitNPROCinfinity LimitCOREinfinity [Install] WantedBymulti-user.target启动并设置开机自启systemctl daemon-reload systemctl enable --now docker docker version建议先配置一下/etc/docker/daemon.json把Harbor的地址提前加入到insecure-registries。这个配置直接关系到后面能不能正常docker login和docker push到第4节会详细说原理这里先把配置写好{ insecure-registries: [192.168.10.20:80] }改完配置记得systemctl restart docker。2.2 安装Docker Compose v2Harbor 2.4.0的install.sh脚本在启动时会调用Compose命令。现在新环境一般都直接装Compose v2插件不再推荐老掉牙的Python版docker-compose。二进制安装方式同样适用于离线环境。在有网的aarch64机器上下载Compose v2二进制文件wget https://github.com/docker/compose/releases/download/v2.23.3/docker-compose-linux-aarch64拷贝到目标机器后mkdir -p /usr/local/lib/docker/cli-plugins cp docker-compose-linux-aarch64 /usr/local/lib/docker/cli-plugins/docker-compose chmod x /usr/local/lib/docker/cli-plugins/docker-compose docker compose version看到版本号输出就说明Compose已经就位。这里有个容易犯迷糊的点Compose v2是作为Docker的插件存在的命令是docker compose中间有空格不是老版的docker-compose。Harbor的install.sh会优先检测docker compose不行再找docker-compose所以把v2插件装好就不会卡在这一步。如果目标机器是CentOS7 aarch64这类系统需要额外确认内核版本和glibc版本是否满足Compose v2的要求。实测CentOS 7.9的aarch64内核装了太新的Compose v2可能会报/lib64/libc.so.6: version GLIBC_2.28 not found建议这种老系统改用Compose v2.20.x左右的版本或者干脆用v1的docker-compose。2.3 导入Harbor镜像并检查架构进入解压后的harbor目录执行镜像导入cd harbor docker load -i harbor.v2.4.0.tar.gz这个过程根据机器性能差异可能需要几分钟到十几分钟。导入完成后务必抽出时间检查一下镜像架构不要偷懒docker images | grep goharbor如果只看镜像列表没问题再用inspect确认关键镜像的架构docker image inspect goharbor/harbor-core:v2.4.0 --format {{.Architecture}}正常输出应该是arm64。如果这里显示amd64那你拿到的离线包有问题继续往下装必炸后面4.2节会给出解决办法。3. Harbor配置与部署全流程3.1 修改harbor.yml的关键项从模板复制一份配置文件cp harbor.yml.tmpl harbor.yml编辑器打开后重点关注以下几项第一是hostname。在离线内网环境直接填服务器的IP地址最省事比如192.168.10.20。如果你后面打算用域名访问这里就填域名并要保证内网DNS能解析到这台机器。这个字段会影响Harbor生成的所有访问URL改起来牵扯面很大一次性想清楚。第二是HTTP端口。默认http.port: 80如果80端口已经被占用Harbor的nginx容器起不来。我在一台跑着nginx的机器上部署时就撞上了改成8080后一切正常。建议提前确认端口占用ss -lntp | grep -E :80|:443第三是HTTPS配置。如果暂时没有正规证书先把整段https:配置注释掉。Harbor 2.4.0的harbor.yml.tmpl里https配置块是有内容的不注释掉的话prepare脚本会去找证书文件找不到就报错。离线内网环境可以先跑HTTP后面想升级再按照4.4节的步骤平滑切换。第四是管理员密码。默认是Harbor12345这个密码是公开的不修改等于裸奔。在harbor_admin_password字段处改成自己的强密码。第五是数据库密码。database.password默认是root123。要说清楚一个大坑如果Harbor已经初始化过数据库此时再修改这个密码会导致postgres起不来因为存量的数据库文件还是用旧密码加密的。要么在首次安装时就确定好密码要么连/data/database目录一起清理掉重新初始化会丢失所有仓库数据没有第三条路。3.2 执行安装脚本并验证服务配置改好后直接执行安装脚本./install.sh注意离线环境一定不要加--with-trivy参数。Trivy启动时会去GitHub下载漏洞数据库离线环境根本拉不下来卡在这里非常尴尬。如果确实需要漏洞扫描功能得在有网环境把trivy-db准备好再手动挂载进去这个复杂度不是一般离线部署能承受的建议第一批先跑核心功能扫描后面再补。安装脚本执行过程中会依次检查docker、compose然后执行prepare生成配置最后通过Compose把所有容器拉起来。看到以下输出基本就成功了✔ ----Harbor has been installed and started successfully.----验证服务状态docker compose ps所有服务的STATUS应该是UpHarbor的nginx容器会监听你配置的端口。浏览器访问http://192.168.10.20:8080用admin和你设置的密码登录能看到UI页面就说明部署成功。另外检查一下日志有没有隐藏报错docker compose logs -f --tail200如果某个容器在反复重启优先看它的日志大部分问题都能从这里找到线索。3.3 ARM设备上的资源分配建议在ARM设备上跑Harbor资源规划比别人x86服务器要上心得多。我实测的容器数量和默认资源占用情况如下容器主要用途稳定运行经验值harbor-dbPostgreSQL存储元数据512MB以上内存harbor-registry镜像存储OCI分发视镜像仓库容量内存占用相对小harbor-coreAPI、UI后端逻辑256MB以上内存harbor-portalUI前端静态页面内存占用很低harbor-nginx反向代理内存占用低harbor-redis缓存与锁128MB左右如果内存紧张的ARM设备建议加swapfallocate -l 2G /swapfile chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo /swapfile none swap sw 0 0 /etc/fstab另外/data目录尽量放到独立分区或者大容量的数据盘上。Harbor的所有镜像数据都落在/data/registry目录下仓库用久了之后这块的磁盘增长非常可观。系统盘只有20GB的小机器很容易被撑爆别等磁盘满了才想起来。4. 常见报错与排查记录4.1 docker push报http和https冲突部署完后在客户端执行docker login和docker push时最常见的报错是Error response from daemon: Get https://192.168.10.20:8080/v2/: http: server gave HTTP response to HTTPS client原因很简单Docker客户端默认用HTTPS协议访问registry而Harbor目前只开了HTTP端口。解决方式是在所有需要使用这个Harbor的客户端机器上修改/etc/docker/daemon.json{ insecure-registries: [192.168.10.20:8080] }注意两点一是insecure-registries里的地址必须是Harbor的hostname:port完整形式端口要对上二是改完要重启dockersystemctl restart docker之后再用docker login 192.168.10.20:8080测试就不会再报这个错了。如果不想让每台客户端都配置insecure-registries那就得走HTTPS方案见4.4节。4.2 exec format error与镜像架构不匹配容器启动时报这样的错standard_init_linux.go:228: exec user process caused: exec format error基本可以断定镜像架构不对你在aarch64上跑了个amd64的镜像。排查命令docker image inspect goharbor/harbor-core:v2.4.0 --format {{.Architecture}}输出如果是amd64说明镜像包来源有问题。直接去下载官方offline包重新load官方包的镜像在arm机器上会是arm64。如果官方包也出现这种情况可以试试在目标机器上手动指定平台重新拉取镜像仅限有网时docker pull --platform linux/arm64 goharbor/harbor-core:v2.4.0如果完全离线且手头只有amd64离线包还有一个比较重的办法找一台能联网的aarch64机器把需要的镜像全部pull下来再save成tar包copy进内网load。虽然麻烦但能解决“只有错误架构包”的窘境。4.3 改了database密码后数据库连不上这是一个非常隐蔽的坑。Harbor首次执行./install.sh时会根据harbor.yml里的database.password初始化postgres中的数据目录。如果此时Harbor已经正常运行过你再去改harbor.yml里的数据库密码然后重新执行install.sh会看到harbor-db容器不断重启日志提示密码认证失败。原因就是postgres数据文件里的密码还是旧密码而core和jobservice组件是用新密码去连接的两边对不上。解决办法备份所有镜像数据/data/registry停掉Harbor所有容器docker compose down删除旧数据库目录rm -rf /data/database重新执行./install.sh这个操作会清空所有镜像的元数据镜像文件本身如果在registry里也会丢代价非常大。所以再次强调首次安装时就要把database.password定好之后只改管理员密码别动数据库密码。4.4 HTTP平滑升级到HTTPS很多人刚开始图省事用HTTP部署后面等真要对接外部系统时又得切HTTPS。好消息是Harbor支持在不丢数据的前提下平滑升级。前提是你得有证书文件。内网环境用自签证书即可用openssl生成openssl req -x509 -nodes -newkey rsa:4096 -keyout server.key -out server.crt -days 3650 -subj /CN192.168.10.20然后在harbor.yml中取消https段落注释并把证书路径指到这两个文件https: port: 443 certificate: /data/cert/server.crt private_key: /data/cert/server.key接着执行docker compose down ./install.sh这样HTTP和HTTPS可以同时监听。客户端那边如果用的是自签证书还是需要在/etc/docker/daemon.json里加入insecure-registries或者把证书配置到客户端的证书信任目录二选一。切换完成后记得把之前镜像仓库里的镜像重新打tag推送一遍确保客户端使用新协议能正常登录和推送。最后再分享一个小技巧整个流程走完我最大的感受是ARM架构下离线部署Harbor真正难的不是Harbor本身而是基础依赖的架构匹配和离线资源准备。如果条件允许建议在装之前把下面这几样东西一次性准备好官方offline包、aarch64的Docker二进制、aarch64的Compose插件、以及至少2GB的swap。这四样齐了后面基本就顺风顺水。另外我自己习惯在部署完Harbor之后第一时间用另一台机器测试docker login和docker push而不是只在浏览器里看看UI。UI能打开只说明nginx和portal正常只有真正走完一遍推送流程才说明registry、core、db这些核心组件都协调工作了。这个部署方案后续还可以扩展比如用Harbor的复制功能做双中心仓库同步或者接入LDAP做统一认证都是内网环境下非常实用的方向。先把手上的这一套跑稳后面再慢慢加功能也不迟。本文还有配套的精品资源点击获取
