Harbor 私有镜像仓库安装部署和最佳实践
1. 简介 Harbor 是 CNCF 托管、VMware 开源的企业级容器镜像仓库,基于 Docker Registry 二次开发。除基础镜像存储能力外,还提供 Web UI、细粒度RBAC权限、镜像漏洞扫描、垃圾回收、镜像复制同步、审计日志等企业级能力,是 Kubernetes 集群离线部署、容器镜像统一管理的核心组件。 适用场景:企业内网私有镜像托管、Kubespray 离线集群镜像分发、CI/CD流水线镜像仓库。 官方参考文档: Harbor 官方安装指南:https://goharbor.io/docs/2.8.0/install-config/ Harbor HTTPS 证书配置文档:https://goharbor.io/docs/main/install-config/configure-https/ Harbor 版本生命周期与版本策略:https://goharbor.io/docs/main/install-config/versioning/ Harbor 备份恢复官方文档:https://goharbor.io/docs/main/administration/backup-restore/ Harbor 生产环境最佳实践:https://www.cncf.io/blog/2026/02/24/making-harbor-production-ready-essential-considerations-for-deployment/ Harbor 官方 Trivy 文档:https://goharbor.io/docs/2.14.0/scan/ Trivy 官方文档:https://aquasecurity.github.io/trivy/ 2. 前置环境准备 2.1 Harbor版本选型指南 当前最新版已经到 v2.15.x,很多人会直接选用最新版,但不建议生产直接上最新大版本。 Harbor版本命名规则:主版本.次版本.补丁号,例如 2.10.2、2.15.0 奇数小版本(2.11、2.13、2.15):新特性版本,引入新功能、重构模块;bug相对多,适合测试体验,不推荐生产直接使用。 偶数小版本(2.10、2.12、2.14):长期维护稳定分支,重点修复漏洞,新增功能保守,生产首选。 举例: v2.15.x:新特性版,适合尝鲜、学习测试; v2.14.x:当前最新稳定偶数版; v2.10.x:久经大规模生产验证,bug少,社区问题资料极多,如果不需要新版本的一些新特性的话,推荐使用。 企业生产环境:优先选择偶数LTS稳定分支,发布至少3个月以上,积累足够补丁。不要选用刚发布的 .0 首版(例如 2.15.0),这类版本会存在较多未发现的bug。 2.2 基础依赖 Harbor 基于 Docker Compose V2 编排运行,提前准备依赖环境: Docker Engine:20.10+ Docker Compose V2 系统架构:amd64 / arm64 均可支持(OrbStack、VMware虚拟机均可正常运行) 硬件资源:测试环境≥2核4G;生产环境≥4核8G,推荐SSD存储提升镜像读写性能 3. Harbor 离线安装流程 离线包稳定性高于在线安装,内网、离线集群优先选用。本文部署以v2.14.4版本为例。 ...