Harbor 私有镜像仓库安装部署和最佳实践

Sat, 03 Oct 2026 11:32:44 +0800

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 离线安装流程