K8s进阶之修改Service的NodePort的端口范围

概述

Kubernetes 默认的NodePort端口范围为 30000~32767。
NodePort端口范围为什么是30000~32767呢？

• 避免与系统保留端口冲突
  
  
  
  • 知名端口（0~1023）
    这些端口通常分配给 HTTP（80）、HTTPS（443）、SSH（22）等系统服务或标准协议，Kubernetes 不会占用。
    
  • 注册端口（1024~49151）
    1024~49151 端口用于动态分配给用户进程或应用程序（如 Docker 容器、数据库等）。
    若 Kubernetes 使用此范围，可能与集群内其他应用的端口冲突（例如用户手动指定端口的容器）。
    
  • 临时端口（49152~65535）
    该范围用于临时端口（客户端动态请求的端口），但 Kubernetes 选择了其中较高的一段（30000~32767），既避免与临时端口大量重叠，又留出了足够的端口空间。
    
  
  
• 端口数量与实用性平衡
  
  
  
  • 范围大小：30000~32767共包含 2768 个端口，足够满足中小型集群的服务暴露需求（每个服务需要一个 NodePort）。
    
  • 端口连续性：连续的端口范围便于管理和监控，例如通过防火墙规则一次性开放整个区间。
    
  
  
• 历史原因与社区惯例
  
  
  
  • Kubernetes 早期版本参考了云服务商的习惯（如 AWS ELB 默认使用高位端口），逐渐形成了这一默认配置。
    
  • 社区实践中，高位端口（如 30000+）通常用于非标准服务，避免与常见应用（如 Web 服务器、数据库）的端口混淆。
    
  
  
• 与其他技术的兼容性
  
  
  
  • Docker 宿主机端口：Docker 默认使用32768~61000等高位端口映射（如-p 32768:80），Kubernetes 的30000~32767范围与之略有重叠，但通过合理规划可避免冲突。
    
  • 云服务商限制：部分云厂商（如早期的 GCE）对节点端口有限制，30000 + 范围在多数环境中可正常使用。
    
  
  
• 为什么不是更大的范围？
  
  
  
  • 端口耗尽风险：虽然 65535 是 TCP/UDP 端口的上限，但预留部分端口给其他服务（如运维工具、监控代理）更为合理。
    
  • 用户习惯：过大的范围可能导致端口分配混乱，固定范围更便于用户记忆和管理。
    
  
  

测试，当NodePort不在默认范围之内会怎么样呢？

1. [root@master01 ~/service]# cat service-nodeport.yaml
2. apiVersion: v1
3. kind: Service
4. metadata:
5.   namespace: default
6.   name: tomcat-svc-nodeport
7. spec:
8.   type: NodePort
9.   selector:
10.     app: tomcat
11.   ports:
12.   - name: nodeport-tomcat
13.     # 访问service的端口
14.     port: 16789
15.     # 容器的端口
16.     targetPort: 8080
17.     # 定义nodePort的端口为80，默认为30000-32767
18.     nodePort: 80
19.     protocol: TCP
21. # 创建service，这里提示我们端口范围要在30000-32767之间
22. [root@master01 ~/service]# kubectl apply -f service-nodeport.yaml
23. The Service "tomcat-svc-nodeport" is invalid: spec.ports[0].nodePort: Invalid value: 80: provided port is not in the valid range. The range of valid ports is 30000-32767

复制代码

修改nodePort的端口范围

Kubernetes 默认的NodePort端口范围为 30000~32767。
该范围由 Kubernetes 的配置参数 --service-node-port-range 控制（通常在 API Server 启动时设置），该配置参数通常在
/etc/kubernetes/manifests/kube-apiserver.yaml文件中添加或修改。
修改kube-apiserver.yaml文件

master节点修改

1. vim /etc/kubernetes/manifests/kube-apiserver.yaml
3. ...
4. spec:
5.   containers:
6.   - command:
7.     - kube-apiserver
8.     - --service-node-port-range=1-50000  # 进行添加这一行即可
9.     ...

复制代码

修改完之后保存该文件，保存之后Kubernetes 会自动重启 API Server 使配置生效。
验证配置是否生效

方式一：

1. [root@master01 ~/service]# ps -ef | grep kube-apiserve
2. root     1637652 1637630 24 23:16 ?        00:00:06 kube-apiserver --service-node-port-range=1-50000 --advertise-address=10.0.0.30...

复制代码

方式二：

1. [root@master01 ~/service]# kubectl get pods -n kube-system -l component=kube-apiserver -o jsonpath='{.items[0].spec.containers[0].command}'
2. ["kube-apiserver","--service-node-port-range=1-50000","--advertise-address=10.0.0.30",...

复制代码

创建service进行测试

1. [root@master01 ~/service]# cat service-nodeport.yaml
2. apiVersion: v1
3. kind: Service
4. metadata:
5.   namespace: default
6.   name: tomcat-svc-nodeport
7. spec:
8.   type: NodePort
9.   selector:
10.     app: tomcat
11.   ports:
12.   - name: nodeport-tomcat
13.     # 访问service的端口
14.     port: 16789
15.     # 容器的端口
16.     targetPort: 8080
17.     # 定义nodePort的端口为80，默认为30000-32767
18.     nodePort: 80
19.     protocol: TCP
21. # 对应的80端口
22. [root@master01 ~/service]# kubectl apply -f service-nodeport.yaml
23. service/tomcat-svc-nodeport created
24. [root@master01 ~/service]# kubectl get svc tomcat-svc-nodeport
25. NAME                  TYPE       CLUSTER-IP    EXTERNAL-IP   PORT(S)        AGE
26. tomcat-svc-nodeport   NodePort   10.96.0.191   <none>        16789:80/TCP   9s

复制代码

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

新版吗？好像是停更了吧。

这个有用。

收藏一下   不知道什么时候能用到

这个好，看起来很实用

分享、互助 让互联网精神温暖你我

鼓励转贴优秀软件安全工具和文档！

感谢发布原创作品，程序园因你更精彩

过来提前占个楼

东西不错很实用谢谢分享