GeekIt

Cilium命令速查

安装状态、Endpoint 与身份、网络连接跟踪、monitor 实时监控、Hubble、策略安全与多集群等 128 条命令

共 128 条命令 · 10 类场景 · 点击右侧图标可复制

命令说明复制
cilium version查看客户端与服务端版本,版本偏差过大会导致命令不可用
cilium status最常用的总览:控制器、代理、IPAM 与加密状态
cilium status --verbose输出详细状态,含 BPF map 使用率与错误计数
cilium status --wait阻塞等待集群就绪,脚本化部署时常用
cilium install按默认参数快速安装 Cilium
cilium install --version 1.16.0指定版本安装,生产需固定版本
helm install cilium cilium/cilium -n kube-system用 Helm 安装,便于精细控制参数
cilium upgrade升级 Cilium 到 CLI 对应版本
cilium uninstall卸载 Cilium(先确认其他 CNI 未接管)
cilium connectivity test端到端连通性自检,覆盖 Pod 到 Pod、Service 与外部访问
cilium connectivity test --test-namespace cilium-test在指定命名空间执行测试,便于隔离资源
cilium config view查看当前生效的配置项
cilium sysdump一键收集诊断包,提 issue 前必备
kubectl -n kube-system get pod -l k8s-app=cilium确认每个节点上的 Cilium Pod 是否运行
命令说明复制
cilium endpoint list列出全部端点(Pod)及其策略与健康状态
cilium endpoint get <id>查看单个端点详情,含标签、策略与网络配置
cilium endpoint health <id>查看端点健康检查结果,定位控制器失败原因
cilium endpoint config <id>查看端点的运行时配置(如策略模式)
cilium endpoint log <id>查看端点相关事件日志
cilium endpoint list -o jsonJSON 输出,便于脚本统计
cilium node list查看节点信息、Pod CIDR 与隧道地址
cilium identity list列出安全身份与对应标签组合
cilium identity get <id>查看某个身份的标签明细
cilium bpf endpoint list查看 BPF 端点映射表
cilium service list查看负载均衡服务表,确认 VIP 与后端
cilium service get <id>查看单个服务的后端与权重
cilium policy get查看当前生效的网络策略
cilium policy selectors查看策略选择器缓存,排查策略未匹配
命令说明复制
cilium ip list查看 IP 缓存(本节点与远端 Pod IP 映射)
cilium bpf ipcache list底层 IP 缓存表,排查 IP 到身份映射异常
cilium bpf tunnel list隧道模式下查看节点间封装映射
cilium bpf lb list查看负载均衡 BPF 表,核对 VIP 到后端
cilium bpf nat list查看 NAT 映射与端口分配
cilium bpf ct list global查看全局连接跟踪表,连接异常时使用
cilium bpf ct list global | wc -l统计连接跟踪条目数量,评估表压力
cilium bpf ipmasq list查看出口 SNAT 规则
cilium bpf nodeid list查看节点 ID 映射(隧道与多集群场景)
cilium ipam list查看 IPAM 分配情况,Pod 拿不到 IP 时必查
cilium status | grep -i mtu确认 MTU 设置,跨节点大包丢失常见原因
cilium encrypt status查看 WireGuard 或 IPsec 加密状态
cilium bpf fs show查看 BPF 文件系统挂载信息
命令说明复制
cilium monitor实时查看流量与策略判定事件
cilium monitor --type drop只看丢包事件,定位拒绝来源最快的方式
cilium monitor --type trace查看详细转发追踪
cilium monitor --type policy-verdict只看策略裁决结果(allowed/denied)
cilium monitor --from-endpoint <id>只看某个端点的流量
cilium monitor --to-endpoint <id>只看发往某个端点的流量
cilium monitor -v输出更详细的报文信息(含端口与身份)
cilium monitor --type l7查看七层(HTTP/gRPC)解析事件
cilium monitor --type agent查看代理内部事件
cilium monitor --type debug调试级事件,仅在排障时短时开启
cilium monitor -o jsonJSON 输出,便于接入日志系统
按 Ctrl+C 停止监控,长时间运行会占用资源高流量集群建议配合过滤条件使用
命令说明复制
cilium hubble enable启用 Hubble 服务(默认不含 UI)
cilium hubble enable --ui同时启用 Hubble UI 图形界面
cilium hubble port-forward端口转发到本地,供 hubble CLI 与 UI 使用
hubble status查看 Hubble 服务与节点连接状态
hubble observe实时查看全部流量事件
hubble observe --namespace app只看指定命名空间
hubble observe --pod app/web-0只看指定 Pod
hubble observe --verdict DROPPED只看被丢弃的流量,策略排查首选
hubble observe --type l7 --http-status 500只看返回 500 的 HTTP 请求
hubble observe --protocol tcp --port 80按协议与端口过滤
hubble observe --since 10m --last 200查看最近 10 分钟内的 200 条事件
hubble observe --follow持续跟踪,不退出
hubble observe -o jsonpb输出 JSON,便于二次处理
hubble observe --from-pod app/a --to-pod app/b定位两个服务之间的调用与丢包
hubble ui打开 UI 入口(需先 enable --ui 与 port-forward)
命令说明复制
cilium policy get查看当前生效策略与其规则
cilium policy trace --src-k8s-pod app/a --dst-k8s-pod app/b --dport 80模拟一次访问并输出策略裁决过程,最强排障工具
cilium bpf policy get <endpoint-id>查看端点 BPF 策略表,确认规则是否真正下发
cilium endpoint config <id> PolicyEnforcement=audit切到审计模式,只记录不拦截,验证策略影响范围
cilium endpoint config <id> PolicyEnforcement=default恢复默认强制模式
cilium policy import policy.json导入策略(调试用,常规应通过 CRD 管理)
cilium policy delete --all清空全部策略(高风险操作,先确认业务影响)
cilium encrypt status确认节点间加密是否生效
helm upgrade --set encryption.enabled=true --set encryption.type=wireguard启用 WireGuard 加密
hubble observe --verdict DROPPED --type policy-verdict查看被策略拦截的具体规则
kubectl get cnp,ccnp -A查看 CiliumNetworkPolicy 与集群级策略
kubectl get pods -n kube-system -l k8s-app=cilium -o yaml | grep -i policy确认策略强制模式配置
命令说明复制
cilium metrics list列出全部指标,定位丢包与错误计数
cilium metrics list | grep -i drop筛出丢包相关指标
cilium bpf metrics list查看 BPF datapath 层指标
cilium status --verbose | grep -i "map"查看 BPF map 使用率,接近上限会导致丢包
bpftool prog list确认 eBPF 程序已加载(需宿主机安装 bpftool)
bpftool map show查看 BPF map 类型与条目上限
cilium bpf bandwidth list查看带宽管理(EDT)配置
cilium monitor --type drop丢包根因常在事件里直接给出
cilium debuginfo -f /tmp/cilium-debug.txt导出调试信息,包含状态、配置与 BPF 表
cilium sysdump --output-filename cilium-sysdump收集完整诊断包
cilium bpf ct list global | sort | uniq -c | sort -rn | head统计连接跟踪分布,发现异常连接来源
cilium status | grep -i "kube-proxy"确认是否已替换 kube-proxy(kubeProxyReplacement)
命令说明复制
cilium clustermesh enable为当前集群启用 Cluster Mesh
cilium clustermesh status查看多集群互联状态
cilium clustermesh status --wait等待互联就绪
cilium clustermesh connect --destination-context ctx2连接另一个集群
cilium clustermesh disconnect --destination-context ctx2断开指定集群连接
cilium clustermesh disable关闭当前集群的 Cluster Mesh
cilium service list | grep -i global确认全局服务是否生效
cilium bpf ipcache list | grep <remote-pod-ip>确认远端 Pod IP 是否被发现
cilium connectivity test --multi-cluster ctx2多集群连通性测试
跨集群需放通 2379 与 4240 端口防火墙未放通是 clustermesh 连不上的首要原因
hubble observe --cluster <name>查看指定集群的流量事件
多集群场景建议开启 global service 注解service.cilium.io/global: "true"
命令说明复制
cilium config view查看全部运行时配置项
cilium config set debug true开启调试日志(影响性能,用完关闭)
cilium config set debug false关闭调试日志
cilium status --all-addresses显示所有相关地址(含节点内部地址)
cilium preflight check安装前环境检查(内核版本、挂载点)
cilium-dbg endpoint list新版将 bpf 子命令迁移到 cilium-dbg,两者可混用
cilium version --client只输出客户端版本
cilium bpf proxy list查看 L7 代理配置
kubectl -n kube-system rollout restart ds/cilium重启全部 Cilium Pod(会短暂影响转发)
kubectl -n kube-system logs ds/cilium --tail=200查看代理日志,启动与配置错误都在这里
helm upgrade cilium cilium/cilium -n kube-system --reuse-values更新配置时保留既有值
升级前先 cilium connectivity test 建立基线升级后对比结果,快速判断回归
命令说明复制
unable to connect to Cilium agent代理未就绪或端口转发失败:先看 cilium pod 状态
Cilium is not readycilium status 查看具体未就绪组件与错误计数
Pod 之间不通cilium policy trace 模拟访问 → cilium monitor --type drop → hubble observe --verdict DROPPED
DNS 解析失败hubble observe --to-port 53 看请求是否发出,再查 CoreDNS 与 NetworkPolicy
大包丢失、小包正常典型 MTU 问题:核对 cilium status 中的 MTU 与底层网络封装开销
Pod 拿不到 IPcilium ipam list 看地址池是否耗尽,或节点 PodCIDR 分配失败
no such endpoint端点已重建,用 cilium endpoint list 重新获取 ID
BPF map 接近上限提升 map 容量或清理异常连接,长期需扩容节点
clustermesh connection refused检查 2379/4240 端口与证书,确认对端 clustermesh-apiserver 正常
command not found: cilium-dbg旧版本没有该命令,继续使用 cilium bpf 子命令
策略改了不生效确认 CRD 已创建、身份已同步(cilium identity list)与 BPF 表已下发
cilium connectivity test 失败先看失败用例所属场景(Pod 到 Pod、Service、外部),再针对性排查

运维常用组合

健康巡检cilium status --verbose → cilium connectivity test → cilium metrics list | grep -i drop
Pod 不通排查cilium policy trace --src-k8s-pod ... --dst-k8s-pod ... --dport 80 → cilium monitor --type drop
策略调试cilium endpoint config <id> PolicyEnforcement=audit → hubble observe --verdict DROPPED
连接与 NAT 核对cilium bpf ct list global → cilium bpf lb list → cilium service list
多集群排查cilium clustermesh status → cilium bpf ipcache list → cilium connectivity test --multi-cluster
现场收集cilium sysdump --output-filename cilium-sysdump → cilium debuginfo -f debug.txt

常见问题排查

1. 排查顺序

cilium status → cilium connectivity test → cilium monitor --type drop → hubble observe --verdict DROPPED

2. 策略不生效

用 cilium policy trace 模拟访问,能直接看到哪条策略放行或拒绝;再核对 cilium identity list 的标签

3. 偶发丢包

多为 MTU 或 BPF map 压力:核对 MTU 设置、观察 map 使用率与 cilium bpf ct list 条目数

4. Hubble 看不到数据

确认 cilium hubble enable 已执行、port-forward 正常,且观察的命名空间有流量经过 Cilium

5. 升级前准备

先跑 connectivity test 建立基线、备份 Helm values,并确认内核版本满足目标版本要求

6. 收集现场

cilium sysdump 一次打包状态、配置与 BPF 表,比逐条命令截图更高效

共 128 条 Cilium 命令 · 多数命令依赖 cilium-agent,建议在任一 Cilium Pod 内或通过 port-forward 执行

关于Cilium命令速查

在线 Cilium 命令速查手册,按安装版本与状态、Endpoint 与身份、网络路由与连接跟踪、实时监控 monitor、Hubble 可观测、策略与安全、性能指标与 eBPF、多集群 Cluster Mesh、运维操作与配置、常见故障等 10 类场景整理 125+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 cilium version 与 status --verbose 与 --wait、cilium install/upgrade/uninstall 与 helm 安装、connectivity test 与 --test-namespace、config view/set、sysdump 与 debuginfo、endpoint list/get/health/config/log、node list、identity list/get、bpf endpoint list、service list/get、policy get 与 selectors 与 trace 与 import 与 delete、cilium ip list 与 bpf ipcache/tunnel/lb/nat/ct/ipmasq/nodeid list、cilium ipam list、encrypt status、bpf fs show、monitor 的 --type drop/trace/policy-verdict/l7/agent/debug 与 --from-endpoint/--to-endpoint/-v/-o json、hubble enable 与 --ui 与 port-forward、hubble status/observe 的 --namespace/--pod/--verdict DROPPED/--type l7/--http-status 500/--protocol/--port/--since/--last/--follow/-o jsonpb/--from-pod/--to-pod、PolicyEnforcement=audit、CNP 与 CCNP、metrics list 与 bpf metrics list、bpftool prog/map、带宽与 map 使用率、clustermesh enable/status/connect/disconnect/disable 与 global service 与 2379/4240 端口、cilium-dbg 与 cilium bpf 差异、unable to connect to Cilium agent 与 Pod 不通与 DNS 失败与 MTU 与 Pod 无 IP 与 BPF map 满 等排查思路。适用于 Cilium eBPF 网络运维、Kubernetes Pod 连通性与网络策略排障、Hubble 流量观测、丢包与连接跟踪分析、多集群 Cluster Mesh 管理,以及运维与 DevOps 面试复习。

核心能力

  • 涵盖 cilium version 与 status --verbose 与 --wait、cilium install/upgrade/uninstall 与 helm 安装、connectivity test 与 --test-namespace、config view/set、sysdump 与 debuginfo、endpoint list/get/health/config/log、node list、identity list/get、bpf endpoint list、service list/get、policy get 与 selectors 与 trace 与 import 与 delete、cilium ip list 与 bpf ipcache/tunnel/lb/nat/ct/ipmasq/nodeid list、cilium ipam list、encrypt status、bpf fs show、monitor 的 --type drop/trace/policy-verdict/l7/agent/debug 与 --from-endpoint/--to-endpoint/-v/-o json、hubble enable 与 --ui 与 port-forward、hubble status/observe 的 --namespace/--pod/--verdict DROPPED/--type l7/--http-status 500/--protocol/--port/--since/--last/--follow/-o jsonpb/--from-pod/--to-pod、PolicyEnforcement=audit、CNP 与 CCNP、metrics list 与 bpf metrics list、bpftool prog/map、带宽与 map 使用率、clustermesh enable/status/connect/disconnect/disable 与 global service 与 2379/4240 端口、cilium-dbg 与 cilium bpf 差异、unable to connect to Cilium agent 与 Pod 不通与 DNS 失败与 MTU 与 Pod 无 IP 与 BPF map 满 等排查思路

适用场景

适用于 Cilium eBPF 网络运维、Kubernetes Pod 连通性与网络策略排障、Hubble 流量观测、丢包与连接跟踪分析、多集群 Cluster Mesh 管理,以及运维与 DevOps 面试复习。Cilium命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Cilium命令速查是免费的吗?需要注册或安装吗?
Cilium命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Cilium命令速查支持哪些功能?
涵盖 cilium version 与 status --verbose 与 --wait、cilium install/upgrade/uninstall 与 helm 安装、connectivity test 与 --test-namespace、config view/set、sysdump 与 debuginfo、endpoint list/get/health/config/log、node list、identity list/get、bpf endpoint list、service list/get、policy get 与 selectors 与 trace 与 import 与 delete、cilium ip list 与 bpf ipcache/tunnel/lb/nat/ct/ipmasq/nodeid list、cilium ipam list、encrypt status、bpf fs show、monitor 的 --type drop/trace/policy-verdict/l7/agent/debug 与 --from-endpoint/--to-endpoint/-v/-o json、hubble enable 与 --ui 与 port-forward、hubble status/observe 的 --namespace/--pod/--verdict DROPPED/--type l7/--http-status 500/--protocol/--port/--since/--last/--follow/-o jsonpb/--from-pod/--to-pod、PolicyEnforcement=audit、CNP 与 CCNP、metrics list 与 bpf metrics list、bpftool prog/map、带宽与 map 使用率、clustermesh enable/status/connect/disconnect/disable 与 global service 与 2379/4240 端口、cilium-dbg 与 cilium bpf 差异、unable to connect to Cilium agent 与 Pod 不通与 DNS 失败与 MTU 与 Pod 无 IP 与 BPF map 满 等排查思路。
Cilium命令速查适合哪些场景使用?
适用于 Cilium eBPF 网络运维、Kubernetes Pod 连通性与网络策略排障、Hubble 流量观测、丢包与连接跟踪分析、多集群 Cluster Mesh 管理,以及运维与 DevOps 面试复习。