JFrog Artifactory配置Dockerhub远程仓库复制功能提示Unknown host如何解决

首先，JFrog Artifactory的Pull Replication功能完全适用主动缓存Dockerhub远程镜像的场景。和远程仓库默认的懒加载被动缓存不同，Pull Replication支持提前批量同步指定镜像到本地存储，用户拉取镜像时直接访问本地副本，完全避免拉取过程依赖公网网络，能有效解决网络波动导致的拉取失败问题。

上述报错是配置格式错误导致的：

Error testing pull replication config: Unknown host 'https://registry-1.docker.io/'

Replication配置的URL字段不需要填写https://协议前缀和末尾的/斜杠，填入的完整地址会被Artifactory整体识别为主机名，自然会触发未知主机报错。正确的Dockerhub上游地址应该填写registry-1.docker.io。

1. 基础连接参数配置 #

• 复制类型选择「Pull Replication」
• 仓库URL字段仅填写registry-1.docker.io
• 用户名/密码填写Dockerhub有效凭证，推荐使用Dockerhub个人访问令牌替代账户密码，安全性更高
• 勾选「Enable Replication」启用复制任务

2. 主动缓存规则配置 #

• 勾选「Sync Properties」同步镜像元数据，避免镜像标签异常
• 触发方式按需选择：
  • 需要定期同步固定镜像列表的，选择「Cron Expression」设置同步周期
  • 需要上游镜像更新后立即同步的，选择事件触发模式
• 路径过滤规则：填写需要主动缓存的镜像路径前缀，避免同步无关内容占用存储，例如仅同步官方镜像填library/**，仅同步个人Dockerhub账号下的镜像填对应用户名/**
• 「Delete artifacts」选项按需勾选：如果需要保留本地缓存镜像即使上游已删除，不要勾选该选项

3. 验证和排错 #

配置完成后点击Test按钮，正常情况下会返回连接成功的提示。如果仍然报错，可以按以下顺序排查：

• 确认Artifactory所在服务器网络可以正常访问registry-1.docker.io的443端口
• 确认填入的Dockerhub凭证有权限拉取配置的路径下的镜像
• 如果配置了全局代理，确认该复制任务已经关联了正确的代理配置

配置参考截图：

内容的提问来源于stack exchange，提问作者erv2