Headlamp 部署体验：Kubernetes 官方推荐的 Dashboard 替代方案

月初，Kubernetes 官方宣布 Dashboard 项目正式归档（Archived），并推荐用户逐步迁移到 Headlamp。

不少朋友可能会问：

Headlamp 到底是什么？ 和 Dashboard 有什么区别？ 值不值得部署？

最近我在实验环境中实际部署体验了一下，简单分享一下过程和感受。

什么是 Headlamp？

Headlamp 是 Kubernetes SIG（Special Interest Group）维护的开源图形化管理工具。

简单理解：

它就是 Kubernetes Dashboard 的下一代接班人。

相比传统 Dashboard，Headlamp 具有：

✅ 更现代的界面设计

✅ 更好的资源展示能力

✅ 支持插件扩展架构

✅ 支持多集群管理

✅ 社区持续活跃维护

目前已经成为 Kubernetes 官方推荐的图形化管理方案。

部署非常简单

本文实验环境：

• Kubernetes v1.34.3
• containerd
• Calico
• Nginx Ingress

通过 Helm 即可完成安装：

helm repo add headlamp https://kubernetes-sigs.github.io/headlamp/
helm repo update

helm install headlamp headlamp/headlamp -n headlamp --create-namespace

安装完成后查看：

kubectl get pods -n headlamp

正常情况下会看到 Pod 进入 Running 状态。

访问方式

部署完成后可以通过：

• NodePort
• Ingress

两种方式暴露服务。

生产环境建议使用 Ingress。

整体架构非常简单：

Browser
   ↓
Ingress
   ↓
Headlamp
   ↓
Kubernetes API

Headlamp 本身并不保存任何集群数据，所有资源信息都来自 Kubernetes API Server。

登录认证

Headlamp 不提供独立账号系统。

权限完全继承 Kubernetes RBAC。

创建 ServiceAccount：

apiVersion: v1
kind: ServiceAccount
metadata:
  name: headlamp-admin
  namespace: kube-system

测试环境可直接绑定：

cluster-admin

权限。

Kubernetes 1.34 的一个变化

这里特别提醒一下。

部分教程会让你创建：

type: kubernetes.io/service-account-token

类型的 Secret 获取 Token。

但在 Kubernetes 1.24+环境中，这种方式已经不再推荐。

直接执行：

kubectl create token headlamp-admin -n kube-system

即可生成登录 Token。

实际体验如何？

登录后第一感觉：

比 Dashboard 更像一个现代化产品。

主要体现在：

集群总览

资源展示更加清晰。

Node 管理

能够快速查看：

• 节点状态
• CPU
• 内存
• Labels
• Taints

Pod 管理

支持：

• 查看日志
• 查看 YAML
• 查看事件
• 终端访问

Deployment 管理

可以直接查看：

• 副本数
• 镜像版本
• 资源配置

对于日常排查来说非常方便。

关于插件功能

这里有一个容易混淆的地方。

Headlamp 支持插件系统。

这没错。

但需要注意：

Desktop 版

支持插件市场和插件管理界面。

In-Cluster 版（本文部署方式）

默认不提供插件安装界面。

因此部署完成后看不到：

Plugins
Marketplace

相关菜单属于正常现象。

如果需要插件功能，通常需要在部署阶段提前构建集成。

我的看法

如果你目前仍然使用 Dashboard：

短期内继续使用没有问题。

但对于：

• 新建 Kubernetes 环境
• Homelab
• 学习测试环境

更推荐直接部署 Headlamp。

毕竟 Dashboard 已经停止维护，而 Headlamp 正在成为 Kubernetes 官方推荐的图形化管理工具。

完整部署

本文仅保留核心流程。

包含：

• Helm 安装
• Ingress 配置
• RBAC 权限配置
• Token 获取
• 页面截图演示