Helm部署NGINX Ingress如何配置自定义TCP端口9000
常见配置踩坑说明
- 你之前的两次尝试都因为配置方向或层级错误,导致自定义端口不生效:
- 把Service端口配置错放到
controller.spec层级下:ingress-nginx的Helm chart,所有和LoadBalancer Service相关的配置(包括注解、端口映射、服务类型)都嵌套在controller.service节点下,在controller根节点直接写spec不会被渲染逻辑识别,属于完全无效的配置 - 修改
defaultBackend相关端口属于找错配置对象:defaultBackend是独立的404兜底响应服务,和Ingress Controller的对外监听端口、LoadBalancer暴露的端口完全解耦,修改它的端口只会调整兜底服务本身的配置,不会影响入口负载均衡的对外端口映射 - 之前写的端口条目存在YAML语法问题:
- name:"proxy-tcp"的写法在冒号后没有空格,就算层级正确,也会因为YAML解析失败导致配置不生效
- 把Service端口配置错放到
- 你需要的纯TCP 9000端口监听、无公网IP暴露、不需要HTTP/HTTPS代理的场景,完全可以通过ingress-nginx内置的TCP转发能力实现,不需要额外修改Deployment资源的配置
正确的配置写法
将原有internal-ingress.yaml修改为如下结构,保留原有内网负载均衡注解的同时,补充9000端口的相关配置:
controller: service: # 保留原有Azure内网负载均衡注解,确保不会绑定公网IP annotations: service.beta.kubernetes.io/azure-load-balancer-internal: "true" # 配置LoadBalancer的端口映射,如果不需要保留80/443端口,可以直接替换默认配置 ports: - port: 9000 targetPort: 9000 protocol: TCP name: proxy-tcp # 配置9000端口的TCP转发规则,将值替换为实际要转发的后端服务地址 格式为<命名空间/服务名:服务端口> tcp: 9000: "your-namespace/your-backend-service:your-backend-port" config: # 启用TCP转发支持 enable-tcp: "true"
部署与验证
- 部署时保持原有Helm命令即可,不需要额外追加
--set参数:
helm install nginx-ingress ingress-nginx/ingress-nginx -f internal-ingress.yaml --set controller.nodeSelector."beta\.kubernetes\.io/os"=linux
- 部署完成后查看LoadBalancer服务状态,会看到9000端口的暴露条目:
nginx-ingress-ingress-nginx-controller LoadBalancer 10.10.36.81 10.13.17.35 9000:3xxxx/TCP
- 可选调整项:
- 如果需要保留原有80/443 HTTP代理能力,只需要在
controller.service.ports下把默认的80、443端口条目和9000端口条目并列写在一起即可,不会产生冲突 - 如果完全不需要HTTP/HTTPS代理能力,直接删除
controller.service.ports下默认的80、443端口条目即可,减少不必要的端口暴露
- 如果需要保留原有80/443 HTTP代理能力,只需要在
内容的提问来源于stack exchange,提问作者vel
相关产品推荐
相关产品推荐

