私有Harbor镜像仓库内网高速拉取镜像的完整教程

企业在内网部署私有Harbor镜像仓库后，拉取镜像出现超时或速度慢，通常不是Harbor本身的问题，而是Docker客户端没有正确配置连接方式。
本文从实操角度出发，帮你一分钟内完成配置，实现内网高速拉取。

确认内网网络与Harbor可达性

首先确保Docker客户端与Harbor服务器在同一内网段，且能通过主机名或IP访问。
检查方法：

ping harbor.example.com

如果域名解析失败，先在 /etc/hosts 中添加映射：

192.168.1.100 harbor.example.com

如果Harbor使用了自签名HTTPS证书，需要将证书放到Docker信任目录，或直接跳过证书验证（本文采用后者，适合纯内网场景）。

配置Docker daemon.json启用insecure-registries

Docker客户端默认只信任HTTPS仓库，
内网Harbor如果未配置公网证书，
需要在 /etc/docker/daemon.json 中添加 insecure-registries 字段。

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

如果文件不存在则新建。
重启Docker使配置生效：

sudo systemctl restart docker

这一步是内网高速拉取的核心——避免Docker因证书验证反复重试，从而大幅提升速度。

登录并测试拉取速度

配置完成后，先登录Harbor：

docker login harbor.example.com

输入用户名密码（admin账户或项目专属机器人账户）。
拉取一个稍大的镜像测试：

time docker pull harbor.example.com/library/nginx:latest

观察输出，正常应看到每一层下载速度达到内网带宽水平（例如100MB/s以上）。
如果依然慢，检查Harbor后端存储是否使用NFS或远程对象存储，那会成为瓶颈。

避坑说明：常见卡慢问题

1. 连接被拒绝：检查Harbor服务状态 docker-compose ps，确保core、registry等服务正常运行。
2. x509证书错误：确认 insecure-registries 已添加并重启Docker，或者将Harbor证书的CA文件复制到 /etc/docker/certs.d/harbor.example.com/ 目录下。
3. 没有权限：在Harbor Web界面检查项目是否为公开，或确保登录的账户有拉取权限。
4. DNS解析慢：直接用IP地址替换域名，并确保 /etc/hosts 中IP对应正确。

效果验证与长期维护

拉取完成后，用 docker images 确认镜像已下载。
重复拉取相同镜像时，Docker会使用缓存，速度更快。
建议将配置好的 daemon.json 纳入自动化运维脚本，批量推到所有内网节点。

如果你在配置过程中遇到其他异常，请在评论区留言，我会结合你的Harbor版本和Docker版本给出具体排查思路。