K9s
K9s 是 Kubernetes 的終端機 UI(TUI)。它比點擊網頁儀表板更快,也比原始的 kubectl 更容易探索。
使用時機
- 基於終端機的 Kubernetes 叢集管理:快速、互動式的 curses UI,用於導覽 Pod、Service 與 Deployment。
- 即時日誌串流與資源監控:追蹤多個 Pod 的日誌、按 CPU/記憶體排序,以及連接埠轉發。
- 自訂 K9s 外掛與別名:透過自訂 Shell 指令(例如執行 stern、cert-manager status)擴充 CLI。
- 唯讀檢查與疑難排解:以唯讀模式安全地除錯生產叢集。
快速開始
# 以現有 kubeconfig 啟動 k9s
k9s
# k9s 中的導覽快捷鍵:
# :pods - 檢視所有命名空間中的 Pod
# :deploy - 檢視 Deployment
# :svc - 檢視 Service
# /<term> - 在目前檢視中過濾項目
# l - 串流選取 Pod 的日誌
# s - 在選取容器內開啟 Shell (exec)
核心概念
#自訂外掛設定(plugins.yaml)
新增自訂鍵盤指令以快速除錯:
# ~/.config/k9s/plugins.yaml
plugin:
# 在 Deployment 上按 'Shift-D' 來檢視詳細的更新歷程
rollout-history:
shortCut: Shift-D
confirm: false
description: "更新歷程"
scopes:
- deployments
command: kubectl
background: false
args:
- rollout
- history
- deployment/$NAME
- -n
- $NAMESPACE
# 在 Pod 上按 'Shift-F' 來啟動互動式除錯容器
debug-pod:
shortCut: Shift-F
confirm: true
description: "除錯 Pod"
scopes:
- pods
command: kubectl
background: false
args:
- debug
- -it
- $NAME
- --image=nicolaka/netshoot
- -n
- $NAMESPACE
#重要導覽與鍵盤快捷鍵
加速叢集管理:
:pod:跳至所有命名空間的 Pod 檢視。:svc、:deploy、:ing:跳至 Service、Deployment 與 Ingress 檢視。/:依名稱或狀態搜尋與過濾資源。l:追蹤選取 Pod 或容器的日誌。s:在選取容器內開啟互動式 Shell(sh/bash)。Shift-F:將本機連接埠轉發至選取 Pod 的服務連接埠。y:檢視選取資源的完整 YAML 清單。
#以自訂選項啟動 K9s
以安全模式啟動 K9s:
# 以唯讀模式啟動,防止在生產環境中意外刪除 Pod
k9s --readonly --namespace production
# 指定自訂 context 與重新整理頻率
k9s --context prod-eks-cluster --refresh 2
常見模式
#自訂 K9s 快捷鍵與外掛
問題:在不同命名空間中頻繁執行自訂 kubectl 指令。
解決方案:在 ~/.config/k9s/plugin.yaml 中定義自訂外掛。
# ~/.config/k9s/plugin.yaml
plugin:
raw-logs:
shortCut: Shift-L
description: "追蹤未截斷的日誌"
scopes:
- pods
command: kubectl
background: false
args:
- logs
- -f
- $NAME
- -n
- $NAMESPACE
- --context
- $CONTEXT
最佳實踐(2026)
- 務必在連接到生產環境時使用
k9s --readonly,以防止意外刪除。 - 務必在
~/.config/k9s/plugins.yaml中設定自訂外掛,以處理重複性的kubectl指令。 - 務必使用連接埠轉發快捷鍵(
Shift-F),而不是輸入冗長的kubectl port-forward指令。 - 務必使用
<all>命名空間或特定命名空間來過濾檢視,以減少 API 伺服器的查詢負載。 - 切勿保持數十個活躍的連接埠轉發;請在
:portforwards檢視中管理並終止它們。 - 切勿在沒有設定適當的
--refresh間隔的情況下,對大型企業叢集執行 K9s。 - 切勿在未確認備份的情況下,透過 K9s 刪除持續性磁碟區聲明(PVC)。
疑難排解
| 錯誤 | 原因 | 解決方案 |
|---|---|---|
Boom!! K9s 無法連接到叢集 | 目前的 kubeconfig 環境無效,或叢集端點無法連線。 | 驗證連線:kubectl cluster-info,並使用 kubectl config use-context 切換環境。 |
在 k9s 中 Pod 日誌串流失敗 | Pod 容器崩潰,或使用者缺乏 RBAC pods/log 權限。 | 檢查容器狀態,並驗證叢集角色權限。 |
終端機顯示畫面損毀/出現異常 | 不相容的終端機 terminfo,或終端機視窗太小。 | 執行 export TERM=xterm-256color,並將終端機視窗最大化。 |