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 json | JSON 输出,便于脚本统计 | |
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 json | JSON 输出,便于接入日志系统 | |
按 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 ready | cilium 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 拿不到 IP | cilium 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 dropcilium policy trace --src-k8s-pod ... --dst-k8s-pod ... --dport 80 → cilium monitor --type dropcilium endpoint config <id> PolicyEnforcement=audit → hubble observe --verdict DROPPEDcilium bpf ct list global → cilium bpf lb list → cilium service listcilium clustermesh status → cilium bpf ipcache list → cilium connectivity test --multi-clustercilium 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 表,比逐条命令截图更高效
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 面试复习。