4. 复制策略配置基础：创建复制策略的入口、基本参数填写、目标注册表配置
复制策略是 Harbor 实现跨实例镜像同步的核心配置单元。一个完整的复制策略由策略元数据、源/目标注册表、过滤规则和同步模式四部分组成。本章聚焦前三部分的基础配置，过滤规则将在下一章单独展开。
4.1 创建复制策略的入口
在 Harbor 管理界面中，复制策略的创建入口位于左侧导航栏的 “系统管理” → “复制管理” 模块。进入该页面后，点击右上角的 “新建复制策略” 按钮，即可打开配置表单。
权限提示：只有具备 System Admin 角色的用户才能创建和管理复制策略。项目管理员仅能查看已分配给其项目的策略执行记录。
下图展示了从 Harbor 主界面进入复制策略创建页面的完整路径：
4.2 基本参数填写
点击“新建复制策略”后，首先进入基本参数配置区域。该区域定义了策略的名称、描述、触发方式等元数据。以下为必填和推荐填写的参数清单：
| 参数名称 | 必填 | 说明 | 推荐值 / 示例 |
|---|---|---|---|
| 策略名称 | 是 | 策略的唯一标识，建议包含源/目标环境信息 | prod-to-dr-image-sync |
| 描述 | 否 | 策略用途说明，便于团队协作 | 生产环境到灾备环境的镜像同步 |
| 复制模式 | 是 | 基于推送（Push）或基于拉取（Pull） | Push-based（源端主动推送） |
| 触发模式 | 是 | 手动、定时、事件驱动 | 事件驱动（实时同步） |
| 覆盖策略 | 是 | 目标镜像已存在时的处理方式 | 覆盖（保持源端最新） |
复制模式详解：
- Push-based（推送模式）：在源 Harbor 实例上配置策略，将镜像推送到目标注册表。适用于中心管控场景。
- Pull-based（拉取模式）：在目标 Harbor 实例上配置策略，从源注册表拉取镜像。适用于边缘拉取或跨网络隔离场景。
4.3 目标注册表配置
目标注册表是复制策略中最关键的配置项，它定义了镜像同步的目的地。Harbor 支持两种目标注册表类型：
- Harbor 实例：目标为另一个 Harbor 服务，支持完整的认证和权限控制。
- 第三方注册表：目标为 Docker Hub、Amazon ECR、Google GCR、Azure ACR、Aliyun ACR 等第三方服务。
配置目标注册表时，需要填写以下核心参数：
| 参数名称 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 提供者 | 是 | 目标注册表类型 | Harbor / Docker Hub |
| 目标名称 | 是 | 注册表别名，便于识别 | dr-harbor-instance |
| 目标 URL | 是 | 目标注册表的访问地址 | https://harbor-dr.example.com |
| 访问凭证 | 是 | 认证方式：用户名/密码 或 Access Key | admin / ******** |
| 验证远程证书 | 否 | 是否验证 TLS 证书，内网环境可关闭 | 勾选（生产环境建议开启） |
安全注意事项：
- 目标注册表的访问凭证建议使用机器人账户或专用服务账户，避免使用管理员账号。
- 跨公网传输时，务必开启 TLS/SSL 并勾选“验证远程证书”。
- 内网环境若使用自签名证书，需先将 CA 证书导入 Harbor 的信任存储。
下图展示了目标注册表配置的完整流程，从选择提供者到连接测试：
4.4 配置验证与常见问题
完成基本参数和目标注册表配置后，建议执行以下验证步骤：
- 测试连接：在目标注册表配置界面点击“测试连接”，确保网络可达且凭证正确。
- 检查证书：若使用自签名证书，确认 Harbor 已导入 CA 证书，或临时关闭证书验证（仅限测试环境）。
- 验证权限：确认目标注册表的用户/机器人账户具有目标项目的 push 和 create 权限。
常见问题排查：
- 连接超时：检查网络防火墙是否放行目标端口（通常为 443 或 8443）。
- 认证失败：确认用户名/密码或 Access Key 未过期，且具有目标项目的写入权限。
- 证书错误：将目标 Harbor 的 CA 证书添加到源 Harbor 的
/etc/harbor/ssl/目录并重启。