kubernetes 中 nodeport 端口范围由 kube-apiserver 的 --service-node-port-range 参数控制，默认为 30000–32767；可通过修改该参数全局调整范围，仅适用于自建集群，需重启 kube-apiserver 并确保端口不冲突。

在 Kubernetes 中，NodePort 服务的端口范围是固定的，默认为 30000–32767，你不能直接“修改默认端口”，但可以通过修改 kube-apiserver 的启动参数来调整这个端口范围。注意：这不是修改某个服务的端口，而是全局调整 NodePort 可用的端口池。

确认当前 NodePort 端口范围

NodePort 范围由 kube-apiserver 的 --service-node-port-range 参数控制。默认值通常是 30000-32767。你可以通过以下方式确认集群当前配置：

• 登录到控制平面节点（如 master 节点）
• 检查 kube-apiserver 的启动参数（常见于 systemd unit 文件或静态 Pod 清单）：
  ps -ef | grep kube-apiserver | grep service-node-port-range
• 若未显式指定，则使用默认范围

修改 NodePort 全局端口范围

需要在所有运行 kube-apiserver 的控制平面节点上操作：

• 编辑 kube-apiserver 的启动配置（例如：/etc/kubernetes/manifests/kube-apiserver.yaml，如果是静态 Pod 部署）
• 添加或修改参数：
  - --service-node-port-range=20000-35000
  （示例：将范围扩大为 20000–35000）
• 保存后，kubelet 会自动重启 kube-apiserver 容器（静态 Pod 场景）
• 验证是否生效：
  kubectl get nodes -o wide 并尝试创建一个 NodePort 类型 Service，观察是否允许指定新范围内的端口

创建 Service 时指定特定 NodePort

即使修改了全局范围，你仍需在 Service 定义中显式指定 nodePort 字段，才能固定使用某个端口：

• 该端口必须落在修改后的 --service-node-port-range 范围内
• YAML 示例片段：

spec:
  type: NodePort
  ports:
  - port: 80
    targetPort: 8080
    nodePort: 20080  # 必须在新范围内，如 20000–35000

若未指定 nodePort，Kubernetes 会从可用范围内自动分配一个端口。

注意事项与限制

• 修改后，已存在的 NodePort Service 不会自动迁移端口，只影响新建或更新的 Service
• 确保新端口范围不与宿主机上其他服务（如 nginx、ssh、数据库等）冲突
• 云厂商托管集群（如 EKS、AKS、GKE）通常不开放 kube-apiserver 参数修改权限，此方法仅适用于自建集群
• 修改范围后建议滚动重启 kube-apiserver，并检查集群健康状态（如 API 可用性、Service 功能）