Longhorn UI 镜像文档

1. 镜像概述和主要用途

Longhorn UI 是 Longhorn 分布式存储系统的官方 Web 用户界面，提供直观的图形化管理界面，用于部署、监控和管理 Longhorn 存储集群。Longhorn 是一个轻量级、可靠且功能强大的云原生分布式块存储解决方案，专为 Kubernetes 环境设计。

该镜像包含 Longhorn 存储系统的前端管理界面组件，通常与 Longhorn 后端服务配合使用，提供存储卷生命周期管理、集群监控、备份恢复、节点管理等核心功能的可视化操作界面。

2. 核心功能和特性

• 存储卷管理：创建、删除、扩容、快照和恢复卷
• 集群监控：实时监控存储集群状态、资源使用率和性能指标
• 节点管理：查看和管理集群中的存储节点
• 备份与恢复：配置备份目标、执行备份操作和恢复数据
• 存储类管理：创建和管理 Kubernetes 存储类
• 事件与告警：查看系统事件日志和配置告警规则
• 性能分析：提供存储性能 metrics 和可视化图表
• 多租户支持：基于 Kubernetes RBAC 的访问控制

3. 使用场景和适用范围

适用场景

• Kubernetes 集群中的持久化存储管理
• 云原生应用的持久卷声明(PVC)管理
• 存储资源监控与性能优化
• 数据备份策略实施与灾难恢复
• 分布式存储集群的日常运维

适用范围

• 开发、测试和生产环境的 Kubernetes 集群
• 中小型企业的容器化基础设施
• 需要持久化存储的云原生应用
• 对存储可靠性和数据安全有要求的场景
• 需要简化存储管理操作的团队

4. 前置要求

• Kubernetes 集群 (v1.21+)
• Longhorn 后端服务已部署
• 集群网络能够访问 Longhorn 后端 API
• 适当的 RBAC 权限配置

5. 安装与部署

使用 Docker 运行（开发测试）

docker run -d \
  --name longhorn-ui \
  -p 8080:80 \
  -e LONGHORN_MANAGER_API_URL=[***] \
  longhornio/longhorn-ui:latest

Docker Compose 配置（开发环境）

version: '3'

services:
  longhorn-ui:
    image: longhornio/longhorn-ui:latest
    container_name: longhorn-ui
    ports:
      - "8080:80"
    environment:
      - LONGHORN_MANAGER_API_URL=[***]
    depends_on:
      - longhorn-manager
    restart: unless-stopped

  longhorn-manager:
    image: longhornio/longhorn-manager:latest
    container_name: longhorn-manager
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /dev:/dev
      - /var/lib/longhorn:/var/lib/longhorn
      - /var/lib/kubelet/plugins_longhorn:/var/lib/kubelet/plugins_longhorn
      - /var/lib/kubelet/pods:/var/lib/kubelet/pods
    environment:
      - POD_NAMESPACE=default
      - NODE_NAME=localhost
    restart: unless-stopped

Kubernetes 部署（生产环境）

推荐通过 Longhorn 官方 Helm Chart 进行部署：

helm repo add longhorn [***]
helm repo update
helm install longhorn longhorn/longhorn --namespace longhorn-system --create-namespace

6. 配置说明

环境变量配置

7. 使用方法

访问 UI 界面

部署完成后，通过以下方式访问 Longhorn UI：

1. NodePort 方式: http://<node-ip>:<node-port>
2. Ingress 方式: http://<ingress-domain>/longhorn
3. Port Forward 方式:

   kubectl port-forward -n longhorn-system svc/longhorn-frontend 8080:80
   

   然后访问 http://localhost:8080

基本操作流程

1. 登录界面：使用配置的认证方式登录系统
2. 集群概览：查看存储集群整体状态和资源使用情况
3. 创建存储卷：在"卷"页面点击"创建"，配置卷名称、大小等参数
4. 部署工作负载：在 Kubernetes 中创建使用该卷的 Pod
5. 创建快照：在卷详情页面执行快照操作
6. 配置备份：在"设置"页面配置备份目标并创建备份策略

8. 常见问题与故障排除

无法访问 UI 界面

• 检查 Longhorn UI Pod 是否正常运行：kubectl get pods -n longhorn-system
• 验证服务和端口配置：kubectl describe svc longhorn-frontend -n longhorn-system
• 检查网络策略是否阻止访问

UI 显示连接错误

• 确认 Longhorn Manager 服务是否正常运行
• 检查网络是否允许 UI 连接到 Manager API
• 验证 LONGHORN_MANAGER_API_URL 配置是否正确

权限问题

• 确保当前用户具有适当的 RBAC 权限
• 检查 Kubernetes 集群角色绑定配置

9. 相关资源

• Longhorn 官方文档
• Longhorn GitHub 仓库
• Longhorn 社区支持
• Kubernetes 存储文档
• Longhorn Slack 社区