Kubernetes容器端口与集群端口映射及多副本Pod访问问题

1. Pod内容器端口重叠的解决方法 #

Kubernetes Pod内的所有容器共享同一个网络命名空间（即同一个IP地址和端口范围），两个容器不能同时监听相同端口，否则会触发端口占用冲突，导致其中一个容器启动失败——这和Docker的宿主机端口映射逻辑完全不同，Docker是将宿主机端口映射到容器内部端口，而Pod内是直接共享端口空间。

最优解决方式是修改其中一个服务的配置，使用不冲突的端口：

• 比如调整ClickHouse的端口配置：将默认TCP端口9000改为9001，HTTP端口9009改为9010（具体修改参考ClickHouse的config.xml文件，调整tcp_port和http_port参数）。
• 然后在Pod的YAML配置中，分别声明每个容器的containerPort：

containers:
- name: questdb
  image: questdb/questdb:latest
  ports:
  - containerPort: 9000  # QuestDB原TCP端口
  - containerPort: 9009  # QuestDB原HTTP端口
- name: clickhouse
  image: yandex/clickhouse-server:latest
  ports:
  - containerPort: 9001  # 修改后的ClickHouse TCP端口
  - containerPort: 9010  # 修改后的ClickHouse HTTP端口
- name: grafana
  image: grafana/grafana:latest
  ports:
  - containerPort: 3000

如果确实无法修改服务内部端口，不推荐使用hostPort或nodePort（会限制Pod调度且占用节点资源），这种场景下建议将两个服务拆分到不同Pod中，通过Service互相访问。

2. 单独访问每个副本Pod的方法 #

minikube service命令是通过Service实现负载均衡，只会返回统一的访问入口。要单独访问每个Pod，可采用以下两种方式：

方式一：使用kubectl port-forward直接转发 #

这是测试场景下最便捷的方法：

1. 先列出所有目标Pod的名称：

kubectl get pods -l app=test-app

2. 针对指定Pod执行端口转发，比如访问名为test-app-xyz-123的Pod的Grafana服务：

kubectl port-forward test-app-xyz-123 3000:3000

之后在本地浏览器访问localhost:3000，即可直接连接到该特定Pod。同理可转发QuestDB或ClickHouse的端口。

方式二：通过minikube节点访问Pod内部IP #

1. 获取目标Pod的集群内部IP：

kubectl describe pod test-app-xyz-123 | grep IP

2. 进入minikube节点：

minikube ssh

3. 在节点内部直接访问Pod的IP和对应端口，比如：

curl http://<pod-ip>:9000  # 访问QuestDB服务

这种方法适合集群内部调试，无需暴露到本地机器。

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