Harbor 2.15.4 介绍与选型指南
Harbor 2.15.4 软件定位、CNCF 毕业项目的制品仓库核心能力与内置组件、官方安装器快速上手，以及与 Distribution/Nexus/zot 的联网实查选型对比（2026-10-18）。
Harbor 2.15.4 介绍与选型指南
目标：说清 Harbor 是什么、核心能力与内置组件有哪些、版本与运行要求是什么，并给出可落地的选型判断。本篇为认知篇：全部内容基于官方文档、官方发布页与 GitHub 公开数据联网查证编写（查询日期 2026-10-18），不做本地安装实测；未能从官方来源直接核实的细节以【参考】标注。
一、信息基准
- 查询日期：2026-10-18
- 版本依据：GitHub 仓库
goharbor/harbor最新稳定发布 v2.15.4（发布于 2026-10-09）；官方文档线为 2.15.0（goharbor.io/docs/2.15.0） - 官方来源清单：
- 安装与配置文档（2.15.0）：https://goharbor.io/docs/2.15.0/install-config/
- 安装前置要求：https://goharbor.io/docs/2.15.0/install-config/installation-prereqs/
- 下载安装器：https://goharbor.io/docs/2.15.0/install-config/download-installer/
- 运行安装脚本：https://goharbor.io/docs/2.15.0/install-config/run-installer-script/
- GitHub 仓库：https://github.com/goharbor/harbor
- 说明：本篇不含本地实测数据；快速上手为官方文档原文引用形态（Harbor 官方安装流程即容器化部署，5.2 原文照录）；第七章对比数据均标注实查来源与日期。
二、软件概述
2.1 定位与发展沿革
Harbor 是开源的云原生制品仓库：以项目（Project）为隔离单位，存储与分发容器镜像、Helm Chart 等 OCI 制品，并在其上叠加漏洞扫描、内容签名与信任、跨实例复制、配额与保留策略、审计与 RBAC 等企业化治理能力【官方文档归纳，2026-10-18】。
关键节点：由 VMware 发起，现为 CNCF 毕业项目【参考：CNCF 项目页 https://www.cncf.io/projects/ 】；官方文档当前线为 2.15.0，最新稳定发布 v2.15.4（2026-10-09，GitHub releases/latest 重定向核验【实查 2026-10-18】）。
2.2 版本与生态
| 项 | 内容 | 来源 |
|---|---|---|
| 最新稳定版 | 2.15.4（2026-10-09） | GitHub releases/latest 重定向核验【实查 2026-10-18】 |
| 官方文档线 | 2.15.0 | goharbor.io/docs/2.15.0【实查 2026-10-18】 |
| 内置组件（官方组件表） | PostgreSQL 15.10、Redis 7.2.6、Beego 2.3.4、Distribution/Distribution 2.8.3、Helm 相关组件等 | 官方 install-config 组件表【实查 2026-10-18】 |
| 许可 | Apache-2.0 | GitHub API【实查 2026-10-18】 |
| 社区热度 | GitHub 29560 stars，仓库最近推送 2026-10-16 | GitHub API【实查 2026-10-18】 |
三、核心架构
Harbor 由一组成套服务构成，官方安装器统一编排启动【官方文档归纳，2026-10-18】：
| 概念 | 说明 |
|---|---|
| Project 项目 | 制品的顶层隔离与权限边界，分公开/私有 |
| Core / Registry | 平台服务核心 + 制品存储（Registry 组件基于 Distribution） |
| Job Service | 后台任务（复制、清理、扫描调度等）执行器 |
| Trivy | 内置漏洞扫描服务（安装时可选 --with-trivy） |
| Notary / 内容信任 | 制品签名与信任链【参考：官方文档】 |
| 复制（Replication） | 跨 Harbor 实例/远端仓库的制品同步规则 |
| Robot Account | 面向自动化流水线的机器人账号 |
| OIDC / RBAC | 对接外部认证与项目级角色控制（官方兼容列表含第三方复制/扫描/OIDC 适配器） |
四、功能特性
- OCI 制品存储与分发：镜像与 Chart 等制品的统一托管【官方定位】。
- 安全治理：Trivy 漏洞扫描（官方安装参数直装）、内容签名信任、审计【官方 2.15.0 文档】。
- 复制与高可用：跨实例复制规则；Kubernetes 上经官方 Helm Chart 部署高可用【官方 install-config 页"Deploying Harbor with High Availability via Helm"，实查 2026-10-18】。
- 治理配置：项目配额、tag 保留策略、Webhook、机器人账号【参考：官方管理文档】。
- 适配器生态：官方维护兼容列表（复制/扫描/OIDC 三类适配器）【官方 install-config 页原文，实查 2026-10-18】。
五、快速上手
5.1 硬件与软件要求（官方前置要求页原文，来源：https://goharbor.io/docs/2.15.0/install-config/installation-prereqs/ ，查询 2026-10-18）
| 资源 | 最低 | 推荐 |
|---|---|---|
| CPU | 2 CPU | 4 CPU |
| 内存 | 4 GB | 8 GB |
| 磁盘 | 40 GB | 160 GB |
软件栈（官方原文）：Docker Engine > 20.10、Docker Compose > 2.3、OpenSSL（可选，用于生成证书）；网络需开放 80/443 端口。
5.2 官方安装流程（官方文档原文形态，来源：download-installer 与 run-installer-script 页，查询 2026-10-18）
1）下载并解压安装器（releases 页选在线或离线安装器；可选 .asc 做 OpenPGP 校验，签名密钥 644FF454C0B4115C）：
tar xzvf harbor-online-installer-version.tgz
2）配置：从 harbor.yml.tmpl 复制为 harbor.yml，按需配置主机名/协议/口令；如需 HTTPS 先按官方页生成证书。
3）运行安装脚本（默认不带 Trivy；带扫描器则加参数）：
sudo ./install.sh
sudo ./install.sh --with-trivy
安装成功后浏览器访问 http://reg.yourdomain.com（harbor.yml 中配置的主机名）；默认管理员 admin / Harbor12345（未修改时）。
4）推送验证（官方页原文示例）：登录管理台建项目（如 myproject）后，从客户端登录并推送：
docker login reg.yourdomain.com
docker push reg.yourdomain.com/myproject/myrepo:mytag
5）HTTP 注意事项（官方原文要点）：若使用 HTTP 而非 HTTPS，客户端需在 daemon 配置加 --insecure-registry；修改后先 systemctl restart docker，再在安装目录 docker compose down -v 与 docker compose up -d 重启 Harbor。
本专栏部署与配置的逐步实操见：《Ubuntu 22.04 安装 Harbor 指南》（https://www.quzuo.net/document/CYRpYZsJEmyE）、《Harbor Docker Compose 部署指南》（https://www.quzuo.net/document/eVv5AluTNLum）、《Harbor 配置参数详解》（https://www.quzuo.net/document/bDqcgInbFM1i）、《Harbor 常用 CLI 命令详解》（https://www.quzuo.net/document/mXSu76vB1K8i）。
六、适用场景与限制
6.1 适用场景
- 自托管镜像仓库：私有化分发、权限隔离与审计合规；
- CI/CD 制品中转：流水线推送/拉取制品、机器人账号授权、与扫描联动；
- 多环境/多站点制品同步（复制规则）与灾备。
6.2 限制与成本
- 成套服务栈：官方组件表可见其内置 PostgreSQL/Redis 等多个服务组件，资源底线高于轻量仓库（最低 2C4G40G，官方前置页）；
- HTTPS 应到位：默认自签场景需要客户端放行不安全注册表，生产建议配置受信证书（官方 run-installer-script 页专节说明）；
- 升级需迁移：跨版本升级可能需要更新配置并迁移数据库模式（官方 install-config 页提示）；
- 扫描/签名组件选装：Trivy 在安装时需显式加
--with-trivy【官方安装页】。
七、同类选型对比
7.1 候选画像
- Harbor：治理能力最全的开源制品仓库（扫描/签名/复制/配额/RBAC），CNCF 毕业项目。
- Distribution：OCI Distribution 规范的参考实现，Docker Hub/GitLab Registry 等的上游核心库，纯 registry 无治理面【参考：项目 README】。
- Nexus Repository OSS：多格式制品仓库（Maven/npm/PyPI 等一仓多用），镜像只是其能力之一【参考：项目定位】。
- zot：轻量 OCI 原生 registry，CNCF 沙箱项目【参考：项目定位】。
7.2 对比总表（全部为 2026-10-18 联网实查）
| 维度 | Harbor | Distribution | Nexus Repository OSS | zot |
|---|---|---|---|---|
| GitHub Stars | 29560 | 10650 | 2678 | —（本次未实查到） |
| 最新版本 | v2.15.4（2026-10-09） | v3.1.2 | 3.97.0（release-3.97.0-13） | v2.1.22 |
| 版本节奏 | 2.15.x 补丁滚动（实查） | 滚动发版（实查） | 滚动发版（实查） | 滚动发版（实查） |
| 许可 | Apache-2.0（实查） | Apache-2.0（项目 README 徽标实查） | —（未实查） | —（未实查） |
| 治理能力 | 扫描/签名/复制/配额/RBAC 全套 | 无（纯存储分发） | 多格式仓库+部分治理 | OCI 原生、轻量【参考】 |
| 兼容矩阵 | Docker Engine > 20.10、Docker Compose > 2.3、端口 80/443（官方前置页明示）；K8s 经官方 Helm 部署 HA | OCI Distribution 规范兼容【参考】 | 多格式仓库（Java/JS/Python 等）【参考】 | OCI 规范兼容【参考】 |
| 数据来源 | GitHub API / releases/latest 重定向，2026-10-18 | 同左 | 同左 | 同左 |
7.3 选型建议
- 要企业级治理（安全扫描、签名、多站点复制、审计）→ Harbor；
- 只要一个干净轻量的 OCI 仓库、愿意自己补治理 → Distribution 或 zot；
- 团队同时要管 Maven/npm/PyPI 等多格式制品、仓库收敛为一 → Nexus Repository（OSS/商业版按需）。
一句话总结：Harbor 是"制品仓库 + 安全治理"的默认开源答案，用资源与运维成本换治理完备度；纯分发看 Distribution/zot，多格式仓库收敛看 Nexus。
八、参考链接
- 安装与配置文档（2.15.0）：https://goharbor.io/docs/2.15.0/install-config/
- 安装前置要求：https://goharbor.io/docs/2.15.0/install-config/installation-prereqs/
- 下载安装器：https://goharbor.io/docs/2.15.0/install-config/download-installer/
- 运行安装脚本：https://goharbor.io/docs/2.15.0/install-config/run-installer-script/
- GitHub 仓库：https://github.com/goharbor/harbor
- 对比数据：GitHub API 与 releases/latest 重定向实查（2026-10-18）
- 本专栏相关篇目：《Ubuntu 22.04 安装 Harbor 指南》《Harbor Docker Compose 部署指南》《Harbor 配置参数详解》《Harbor 常用 CLI 命令详解》