Skip to content

Harbor企业级容器镜像仓库实践 ​

作者: ryan 发布于: 2025/11/17 更新于: 2025/11/17 字数: 0 字 阅读: 0 分钟

Harbor 简介与基础概念 ​

简介 ​

Harbor 是一个开源的云原生容器镜像仓库(Container Registry),由 VMware 中国团队开发并贡献给 CNCF(Cloud Native Computing Foundation),现已成为 CNCF Graduated(毕业)级 项目。它专为企业级场景设计,由 Go 语言开发,扩展 Docker Registry V2,提供 Web UI、多租户、权限控制等企业特性。在 DevOps 流程中充当镜像中心化存储与分发平台,解决原生 Registry 缺乏管理、安全、审计等问题。

核心概念 ​

功能说明
Registry核心镜像存储服务,基于 Docker Distribution 实现,支持推送(push)和拉取(pull)镜像。
Project(项目)逻辑隔离单元,一个 Project 包含多个镜像仓库(Repository),支持公有/私有设置。
Repository(仓库)存储具体镜像的地方,例如 library/nginx。每个镜像有多个 Tag(如 latest、1.25)。
Artifact(工件)泛指存储在 Harbor 中的内容,包括: Docker 镜像 、Helm Chart •、OCI 标准工件(CNAB、WASM 等)
Replication(复制)支持将镜像在多个 Harbor 实例间同步,实现灾备、高可用、边缘分发。
Scanner(漏洞扫描)集成 Trivy、Clair 等扫描器,自动扫描镜像漏洞并生成报告。
Webhook镜像推送、删除等事件触发 HTTP 回调,可对接 CI/CD 流水线。
Proxy Cache支持缓存公共仓库(如 Docker Hub)的镜像,加速拉取并减少外部依赖。

Harbor 的架构组件 ​

Harbor 采用微服务架构,主要组件包括:

组件功能
CoreAPI 服务、认证授权、项目管理
Database存储元数据(PostgreSQL)
Registry实际镜像存储(可接 S3、Swift、OSS 等对象存储)
Job Service异步任务(如复制、垃圾回收、扫描)
PortalWeb 管理界面
Admin Server配置管理
Webhook Service事件通知
Scanner Adapter对接漏洞扫描器(如 Trivy)

所有组件支持容器化部署(Docker Compose / Kubernetes Helm Chart)。

核心功能亮点 ​

功能说明
✅ 企业级安全支持 RBAC 权限控制、LDAP/AD、OIDC 认证、镜像签名(Notary/Content Trust)
✅ 漏洞扫描内置 Trivy 扫描,CVE 报告,支持策略阻止高危镜像部署
✅ 镜像复制Push/Pull 模式,支持跨地域、跨集群同步
✅ 访问控制项目级公有/私有,细粒度用户权限
✅ 审计日志记录所有操作,便于合规审计
⭐ Helm Chart 管理完整支持 Helm v3 Chart 仓库
⭐ Proxy Cache缓存 docker.io、gcr.io 等,适合内网环境
⭐ 多租户支持通过 Project 实现团队隔离

与 Docker Registry 的对比 ​

特性Docker RegistryHarbor
界面管理无✅ Web UI
权限控制简单✅ RBAC + LDAP
漏洞扫描无✅ 内置 Trivy
镜像复制无✅ 多实例同步
Helm 支持无✅ 完整支持
企业就绪基础✅ 高可用、安全合规

官方资源 ​

官网:https://goharbor.io

GitHub:https://github.com/goharbor/harbor

文档:https://goharbor.io/docs/

Helm Chart:helm repo add harbor https://helm.goharbor.io

安装与配置 ​

镜像管理与操作 ​

安全与漏洞扫描 ​

镜像复制与分发 ​

高级功能:高可用性、监控与集成 ​

故障排查与最佳实践 ​