一、Harbor镜像仓库名称查看方法

Harbor作为企业级私有镜像仓库，其名称信息是镜像管理的核心标识。以下是三种主要查看方式：

1.1 通过Harbor Web界面查看

Harbor的图形化管理界面提供了最直观的名称查看方式：

登录Harbor管理控制台（默认端口9443）
导航至”Projects”（项目）菜单
每个项目名称即对应镜像仓库名称
点击具体项目可查看详细信息，包括名称、描述、访问级别等

操作示例：

1. 浏览器访问 https://<harbor-server>:9443
2. 输入管理员账号（admin/Harbor12345）
3. 在左侧导航栏点击"Projects"
4. 查看项目列表中的名称列

1.2 通过Harbor API接口获取

对于自动化运维场景，可通过RESTful API获取仓库名称：

curl -u "admin:Harbor12345" -X GET "https://<harbor-server>:9443/api/v2.0/projects" -H "accept: application/json"

返回JSON中包含name字段，示例：

[
  {
    "name": "library",
    "project_id": 1,
    "public": true
  },
  {
    "name": "dev-team",
    "project_id": 2,
    "public": false
  }
]

1.3 通过Harbor配置文件查看

在Harbor服务器上，配置文件/etc/harbor/harbor.yml中包含基础配置：

hostname: harbor.example.com
http:
  port: 80
https:
  port: 443
  certificate: /data/cert/server.crt
  private_key: /data/cert/server.key

虽然不直接显示仓库名称，但可通过hostname结合项目名称构成完整仓库地址。

二、Harbor镜像仓库地址获取方式

镜像仓库地址是客户端访问的核心信息，包含多种格式和获取途径：

2.1 基础仓库地址构成

标准Harbor仓库地址格式为：

<协议>://<域名或IP>:<端口>/<项目名称>

示例：

HTTP：http://harbor.example.com/library
HTTPS：https://harbor.example.com:9443/dev-team

2.2 通过Harbor系统信息获取

登录Harbor Web界面
点击右上角用户头像 → “System Settings”
查看”General”选项卡中的：
- Hostname：基础域名
- UI Secret（可选）：认证相关
- Database（可选）：数据库配置

2.3 通过Docker客户端配置

在/etc/docker/daemon.json中配置insecure-registries（非HTTPS场景）：

{
  "insecure-registries": ["harbor.example.com"]
}

重启Docker服务后，可直接使用harbor.example.com/project/image:tag格式推送镜像。

2.4 通过Kubernetes集成获取

在K8s的imagePullSecrets中配置Harbor认证：

apiVersion: v1
kind: Secret
metadata:
  name: harbor-secret
type: kubernetes.io/dockerconfigjson
data:
  .dockerconfigjson: <base64-encoded-config>

其中.dockerconfigjson内容示例：

{
  "auths": {
    "https://harbor.example.com:9443": {
      "auth": "base64(username:password)",
      "email": "user@example.com"
    }
  }
}

三、高级管理技巧

3.1 多项目仓库地址管理

对于大型企业，建议采用命名规范：

<环境>-<团队>-<应用>
示例：prod-ai-team-model-service

通过Harbor的”Label”功能可进一步分类管理。

3.2 自动化脚本示例

获取所有仓库地址的Python脚本：

import requests
import json
HARBOR_URL = "https://harbor.example.com:9443"
USERNAME = "admin"
PASSWORD = "Harbor12345"
def get_projects():
    response = requests.get(
        f"{HARBOR_URL}/api/v2.0/projects",
        auth=(USERNAME, PASSWORD),
        verify=False
    )
    projects = response.json()
    return [f"{HARBOR_URL}/{p['name']}" for p in projects]
if __name__ == "__main__":
    repos = get_projects()
    for repo in repos:
        print(repo)

3.3 安全最佳实践

强制使用HTTPS（修改harbor.yml中的https.port）
定期轮换管理员密码
为不同团队创建独立项目
启用镜像扫描功能（需安装Clair或Trivy）

四、常见问题解决

4.1 地址无法访问

检查防火墙规则：iptables -L -n | grep 9443
验证DNS解析：nslookup harbor.example.com
检查Harbor服务状态：docker-compose ps

4.2 认证失败

确认密码正确性（区分大小写）
检查项目权限设置
验证/etc/harbor/harbor.yml中的auth_mode（支持db_auth和ldap_auth）

4.3 镜像推送缓慢

优化网络带宽
启用Harbor的P2P加速功能（需安装Dragonfly）
调整storage配置中的redis_url

五、总结与建议

标准化命名：建立企业级的Harbor命名规范，建议采用<部门>-<应用>-<环境>格式
自动化管理：将仓库地址管理纳入CI/CD流水线，使用Terraform或Ansible自动化创建项目
监控告警：集成Prometheus监控Harbor指标，设置磁盘空间告警阈值
备份策略：定期备份Harbor数据库（PostgreSQL）和存储目录（/data）

通过系统掌握Harbor仓库名称和地址的管理方法，开发者能够显著提升镜像管理效率，降低运维复杂度。建议结合企业实际需求，制定适合的Harbor使用规范，并定期进行健康检查和性能优化。

Harbor镜像仓库管理指南：名称与地址查看全攻略