4. Longhorn UI 与 CLI：Dashboard 功能概览、kubectl 插件安装、longhornctl 命令行工具使用

在生产环境中，SRE 工程师需要同时掌握图形化界面与命令行工具，才能高效地管理 Longhorn 存储集群。本章将系统讲解 Longhorn Dashboard 的核心功能模块、kubectl 插件的安装与验证，以及 longhornctl 命令行工具的常用操作，帮助你在版本漂移校准和备份恢复场景中快速定位问题并执行操作。

4.1 Longhorn Dashboard 功能概览

Longhorn Dashboard 是部署在 Kubernetes 集群内的 Web 管理界面，默认通过 longhorn-ui Service 暴露。它提供了集群存储资源的全局视图，是日常巡检和故障排查的第一入口。

Dashboard 主要分为以下功能区域：

4.2 kubectl 插件安装与使用

Longhorn 官方提供了 kubectl-longhorn 插件，用于通过命令行直接管理 Longhorn 资源，无需频繁切换 Web 界面。该插件在版本漂移校准和批量操作场景中尤为高效。

4.2.1 插件安装

推荐使用 krew 插件管理器进行安装，确保版本与集群匹配：

# 安装 krew（如未安装）
(
  set -x; cd "$(mktemp -d)" &&
  OS="$(uname | tr '[:upper:]' '[:lower:]')" &&
  ARCH="$(uname -m | sed -e 's/x86_64/amd64/' -e 's/arm64/arm64/')" &&
  curl -fsSLO "https://github.com/kubernetes-sigs/krew/releases/latest/download/krew-${OS}_${ARCH}.tar.gz" &&
  tar zxvf "krew-${OS}_${ARCH}.tar.gz" &&
  ./krew-"${OS}_${ARCH}" install krew
)

# 添加 krew 到 PATH
export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"

# 安装 longhorn 插件
kubectl krew install longhorn

# 验证安装
kubectl longhorn --version

4.2.2 常用命令速查

4.2.3 插件输出示例

执行 kubectl longhorn node list 可快速发现版本不一致节点：

NAME           STATUS   READY   ALLOW_SCHEDULING   ENGINE_IMAGE_VERSION   NODE_ID
node-01        Healthy  True    True               v1.6.2                 k8s-node-01
node-02        Healthy  True    True               v1.6.2                 k8s-node-02
node-03        Healthy  True    True               v1.5.3                 k8s-node-03  ← 版本漂移
node-04        Healthy  True    True               v1.6.2                 k8s-node-04

4.3 longhornctl 命令行工具使用

longhornctl 是 Longhorn 提供的独立 CLI 工具，用于在节点本地执行诊断、安装前检查、版本迁移等操作。与 kubectl 插件不同，longhornctl 直接与 Longhorn 后端服务交互，适合在 SSH 到节点后执行底层操作。

4.3.1 安装 longhornctl

支持二进制下载和容器化运行两种方式：

# 方式一：二进制安装（Linux amd64）
curl -sSfL https://github.com/longhorn/cli/releases/latest/download/longhornctl-linux-amd64 -o longhornctl
chmod +x longhornctl
sudo mv longhornctl /usr/local/bin/

# 方式二：容器运行（无需安装）
docker run --rm -v /var/lib/longhorn:/var/lib/longhorn longhornio/longhornctl:latest version

# 验证安装
longhornctl version

4.3.2 核心命令分类

4.3.3 版本漂移场景实战：使用 longhornctl 进行版本检查

当集群出现版本漂移时，longhornctl check 可以快速定位不一致的组件：

# 在疑似版本漂移的节点上执行
longhornctl check --kubeconfig /etc/kubernetes/admin.conf

# 输出示例
[PASS]  Kernel module: iscsi_tcp
[PASS]  Kernel module: nbd
[PASS]  Multipath: disabled
[FAIL]  Engine image version mismatch: expected v1.6.2, found v1.5.3
[FAIL]  Longhorn manager version mismatch: expected v1.6.2, found v1.5.3
[PASS]  Disk space: /var/lib/longhorn (85% used, threshold 90%)

4.4 工具选择建议

根据不同的运维场景，选择合适的工具可以提升效率：

• 日常巡检与批量操作： 优先使用 kubectl-longhorn 插件，通过 Kubernetes API 获取结构化数据，便于脚本化处理。
• 节点级诊断与版本迁移： 使用 longhornctl 直接在节点上执行，避免网络延迟和 API 版本兼容问题。
• 可视化分析与新手入门： 使用 Longhorn Dashboard，通过图形界面快速理解集群状态。
• 版本漂移校准： 组合使用：Dashboard 发现异常 → kubectl-longhorn 确认版本差异 → longhornctl 执行本地迁移和修复。