国外VPS部署K8s集群Pod无法启动故障排查实录
文章分类：技术文档 /
创建时间：2025-07-07
在国外VPS上部署K8s（Kubernetes，容器编排系统）集群时，最让人头疼的莫过于Pod（K8s中最小的可部署单元）卡在Pending或ContainerCreating状态，始终无法进入Running。本文结合实际操作经验，从现象观察到逐步诊断，帮你快速定位并解决这类问题。
现象：Pod卡在"启动中"动不了
部署时输入`kubectl get pods`查看状态，发现Pod像被施了定身咒——要么显示Pending（等待调度），要么停在ContainerCreating（容器创建中）。这时候点开详情（`kubectl describe pod
诊断：三步定位核心问题
排查这类故障就像拆盲盒，得逐层拆解可能的阻碍。
第一步：镜像拉取是否成功？
Pod启动的第一步是从镜像仓库拉取容器镜像。如果拉取失败，后续步骤根本走不下去。执行`kubectl describe pod
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 5m default-scheduler Successfully assigned test-ns/test-pod to vps-node-01
Warning Failed 2m kubelet Failed to pull image "myrepo.com/app:v1": rpc error: code = NotFound desc = failed to pull and unpack image...
这种情况可能是镜像地址写错（比如把`myrepo.com`写成`myreop.com`）、仓库需要认证但没配置密钥，或是国外VPS的网络连不上镜像仓库（比如被防火墙拦截）。
第二步：节点资源够不够用？
K8s调度Pod时，会检查节点的CPU、内存是否满足Pod的资源请求（requests）。输入`kubectl describe node <节点名称>`，看Allocatable（可分配资源）和Allocated resources（已分配资源）的对比：
Allocatable:
cpu: 4
memory: 7988168Ki
Allocated resources:
cpu: 3500m (87%)
memory: 6Gi (77%)
如果CPU或内存使用率超过90%，新Pod就可能因资源不足无法调度，停留在Pending状态。
第三步：网络是否畅通？
国外VPS的网络环境比国内复杂，容易踩坑。比如镜像仓库在海外，但VPS所在机房的出口带宽小，拉取大镜像超时；或是防火墙没放行50000/TCP（K8s节点间通信端口）、443/TCP（HTTPS仓库端口）等必要端口。可以用`ping 镜像仓库地址`测试连通性，用`telnet 仓库地址 443`检查端口是否开放。
解决：针对性修复三大痛点
镜像拉取失败：
- 地址错误：检查Pod的YAML文件`spec.containers.image`字段，确认镜像名称、标签（如`:v1`）拼写正确。
- 认证问题：创建镜像拉取密钥（`kubectl create secret docker-registry regcred --docker-server=myrepo.com --docker-username=user --docker-password=pass`），并在Pod的YAML中添加`imagePullSecrets: [{name: regcred}]`。
- 网络问题：尝试用`curl -v https://myrepo.com/v2/`测试仓库连通性，若超时可联系VPS服务商检查出口IP是否被仓库封禁，或更换镜像加速地址（如使用Docker Hub的官方加速器）。
资源不足：
- 短期方案：调整Pod的资源请求，比如将`requests.cpu: "2"`改为`requests.cpu: "1"`（前提是业务允许）。
- 长期方案：购买新的国外VPS节点加入集群（K8s支持动态扩缩容），用`kubeadm join`命令将新节点接入控制平面。
网络不通：
- 防火墙：登录VPS管理面板，检查安全组规则，添加允许443/TCP（HTTPS）、50000/TCP（K8s节点通信）等端口的入站/出站规则。
- 延迟问题：如果VPS到镜像仓库的RTT（往返时间）超过500ms，可尝试更换同区域的VPS（比如仓库在美西，选择美西机房的VPS）。
在国外VPS上部署K8s集群，Pod启动故障看似棘手，实则通过“查镜像-看资源-测网络”三步法，90%的问题都能快速定位。关键是养成“先看事件日志，再查底层资源”的排查习惯，遇到问题别急着重启，先保留现场日志，这样才能高效解决问题。
工信部备案：苏ICP备2025168537号-1