手把手教你安装 Kubernetes Dashboard 仪表盘，小白也能轻松上手！

什么是 Kubernetes Dashboard？

Kubernetes Dashboard 是一个基于 Web 的用户界面，允许用户通过图形化操作来管理集群资源，比如查看 Pod 状态、创建服务、更新 Deployment 等等。相比命令行，它更适合初学者和希望快速了解集群状态的人。

环境准备

在开始之前，请确保你的 Kubernetes 集群已经搭建完成，并且可以正常运行。以下是基本要求：

• kubectl 已经安装并配置好
• 集群版本建议为 v1.20 或更高
• 有管理员权限或能够使用 RBAC 授权机制

如果你还没有搭建集群，可以参考我之前的教程《如何在本地搭建 Kubernetes 开发环境》进行操作。

安装 Dashboard

我们可以通过官方提供的 YAML 文件直接部署 Dashboard：

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

执行完成后，Dashboard 就会被部署到 kubernetes-dashboard 命名空间下。

你可以通过以下命令查看部署状态：

kubectl get pods -n kubernetes-dashboard

如果看到所有 Pod 处于 Running 状态，说明部署成功。

访问 Dashboard

默认情况下，Dashboard 并不会暴露给外部网络，我们需要手动创建访问方式。

方式一：使用 kubectl proxy

执行如下命令开启代理：

kubectl proxy

然后打开浏览器，访问：http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/

这时会进入登录界面，需要选择认证方式（Token 或 Kubeconfig）。

方式二：配置 Ingress 暴露服务

如果你想让 Dashboard 可以通过公网访问，可以使用 Ingress + TLS 的方式进行配置。这部分内容较为复杂，我会在后续文章中详细讲解。

创建 Token 登录凭证

为了安全起见，推荐使用 Token 登录。首先，我们需要创建一个 ServiceAccount：

kubectl create serviceaccount dashboard-admin -n kubernetes-dashboard

接着绑定 ClusterRole：

kubectl create clusterrolebinding dashboard-cluster-admin --clusterrole=cluster-admin --serviceaccount=kubernetes-dashboard:dashboard-admin

最后获取 Token：

kubectl -n kubernetes-dashboard describe secret $(kubectl -n kubernetes-dashboard get secret | grep dashboard-admin | awk '{print $1}')

复制输出中的 Token 字符串，粘贴到 Dashboard 登录页即可。

常见问题与解决办法

在安装过程中，可能会遇到一些常见问题，下面列出几个常见的解决方案：

• 无法访问 Dashboard 页面：检查是否开启了 proxy 或者 Ingress 配置是否正确
• Token 登录失败：确认是否有足够的权限，ClusterRoleBinding 是否正确绑定
• Pod CrashLoopBackOff：可能是镜像拉取失败，尝试更换国内镜像源

总结

通过本文的步骤，你应该已经成功安装并运行了 Kubernetes Dashboard。虽然这只是 Kubernetes 生态的一小部分，但对于新手来说是一个非常实用的工具。

如果你在操作过程中遇到了其他问题，欢迎留言交流，我会尽力为你解答。也欢迎关注我的账号，后续将持续更新更多关于云原生、Kubernetes 和 DevOps 的实战教程。

📌点击下方标签，快速跳转阅读：
什么是 Dashboard | 环境准备 | 安装步骤 | 访问方式 | 创建 Token | 常见问题 | 总结