配置Nginx ingress关联ExternalName指向Azure CDN出现504超时如何解决

• 端口报错&504原因：日志显示上游请求为https://0.0.0.1:80，属于典型的协议端口不匹配问题。你指定了HTTPS作为后端协议，但ExternalName Service没有正确配置443端口映射，导致nginx尝试用HTTPS协议访问CDN的80端口，必然触发连接超时或端口无效错误。
• Ingress合并风险：同域名下的多份Ingress规则默认会被nginx ingress控制器自动合并，如果你默认后端的Ingress配置了rewrite-target注解，没有给CDN专用Ingress显式添加对应覆盖注解的话，默认Ingress的注解会被继承到合并后的规则中，导致路径匹配异常。

方案1：修复现有ExternalName配置（改造成本最低） #

1. 先修正ExternalName Service的端口配置，明确指定HTTPS对应443端口：

apiVersion: v1
kind: Service
metadata:
  name: azure-cdn-svc
spec:
  type: ExternalName
  externalName: cdn.address.com
  ports:
  - name: https
    port: 443
    protocol: TCP
    targetPort: 443

2. 给CDN专用Ingress显式添加注解，避免被默认Ingress的配置覆盖，同时补全上游配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cdn-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: $uri # 显式指定不修改原路径，覆盖默认Ingress的rewrite规则
    nginx.ingress.kubernetes.io/upstream-vhost: cdn.address.com
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
    nginx.ingress.kubernetes.io/service-upstream: "true" # 强制用CDN域名作为上游，避免直接访问解析后的IP被CDN拦截
spec:
  rules:
  - host: domain.com
    http:
      paths:
      - path: /site.webmanifest
        pathType: Exact # 精确匹配避免被前缀规则覆盖
        backend:
          service:
            name: azure-cdn-svc
            port:
              number: 443
      # 其他需要走CDN的路径可在此追加

3. 配置完成后执行kubectl exec -it <nginx-ingress控制器Pod名> -- cat /etc/nginx/nginx.conf，搜索domain.com对应的配置，确认路径规则、上游端口为cdn.address.com:443即可。

方案2：直接用配置片段实现（绕开ExternalName，稳定性更高） #

如果不想维护额外的ExternalName Service，也可以直接通过nginx配置片段把指定路径的请求代理到CDN，完全规避端口解析和规则合并问题：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: unified-ingress
  annotations:
    nginx.ingress.kubernetes.io/configuration-snippet: |
      location = /site.webmanifest {
          proxy_pass https://cdn.address.com$request_uri;
          proxy_set_header Host cdn.address.com;
      }
      # 其他需要走CDN的路径直接追加location规则即可
spec:
  rules:
  - host: domain.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: 你的默认后端服务名
            port:
              number: 你的默认后端端口

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