在Minikube中部署Harbor镜像仓库遇503错误求助

核心问题分析 #

你遇到的nginx: [emerg] socket() [::]:8080 failed (97: Address family not supported by protocol)错误，根源是Harbor Portal容器默认尝试监听IPv6端口，但Minikube节点未启用IPv6支持，导致容器启动失败，最终引发Ingress返回503（后端服务不可用）。

解决方案步骤 #

1. 重新安装Harbor Helm Chart并禁用IPv6 #

执行helm install时添加以下配置参数，强制Harbor所有组件仅使用IPv4：

helm install harbor goharbor/harbor \
  --create-namespace \
  --namespace harbor \
  --set portal.service.ipv6=false \
  --set core.service.ipv6=false \
  --set registry.service.ipv6=false \
  --set ingress.core.hosts.core=core.harbor.domain \
  --set ingress.core.hosts.portal=core.harbor.domain

• *.service.ipv6=false：禁用所有组件的IPv6监听逻辑，强制绑定IPv4端口
• ingress.core.hosts：统一配置Core和Portal的Ingress域名，避免因域名不一致导致的路由失效

2. 验证Pod运行状态 #

安装完成后，检查Harbor命名空间下所有Pod是否正常启动：

kubectl get pods -n harbor

需确保harbor-portal、harbor-core等核心Pod的状态为Running。

3. 确认Ingress路由配置 #

检查Ingress资源的后端关联是否正确：

kubectl describe ingress harbor-ingress -n harbor

重点查看Rules和Backend部分，确认core.harbor.domain指向的服务端口为默认的80端口。

4. 测试访问有效性 #

等待所有Pod就绪后，访问https://core.harbor.domain（Harbor默认启用HTTPS，首次访问需跳过浏览器安全提示）。

额外排查要点 #

• 用minikube ip确认192.168.49.2是Minikube节点的正确IP，避免hosts配置错误
• 若仍出现503，可查看Nginx Ingress Controller日志排查路由问题：

kubectl logs -n kube-system -l app.kubernetes.io/name=nginx-ingress

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