Rook Ceph Dashboard 通过Ingress配置子路径访问的注意事项

在使用Rook部署Ceph集群时，Dashboard是一个非常实用的管理界面。很多用户希望通过Ingress将Dashboard暴露到外部网络，并且配置在非根路径下访问。本文将详细介绍如何正确配置Ceph Dashboard的子路径访问。

常见配置问题

许多用户在尝试通过Ingress将Ceph Dashboard配置在子路径(如/dashboard)下访问时，会遇到以下问题：

1. 页面可以加载，但所有API请求返回404错误
2. 完全无法访问Dashboard界面
3. 浏览器控制台显示大量资源加载失败

这些问题通常是由于路径配置不正确导致的。

正确配置方法

要让Ceph Dashboard在子路径下正常工作，需要进行以下两个关键配置：

1. Ingress配置

在Ingress资源中，需要确保路径配置正确。以下是一个示例配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: rook-ceph-dashboard-ingress
  namespace: rook-ceph
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
    nginx.ingress.kubernetes.io/rewrite-target: /$2
    nginx.ingress.kubernetes.io/configuration-snippet: |
      rewrite ^(/dashboard)$ $1/ permanent;
spec:
  ingressClassName: nginx
  tls:
    - hosts:
        - example.com
      secretName: example-tls
  rules:
    - host: example.com
      http:
        paths:
          - path: /dashboard(/|$)(.*)
            pathType: ImplementationSpecific
            backend:
              service:
                name: rook-ceph-mgr-dashboard
                port:
                  number: 8443

关键点说明：

• 使用正则表达式捕获路径
• 配置rewrite-target将路径重写
• 添加configuration-snippet确保路径以斜杠结尾

2. Ceph Dashboard配置

除了Ingress配置外，还需要在Ceph中设置url_prefix：

ceph config set mgr mgr/dashboard/url_prefix "/dashboard/"

注意：

• 路径必须以斜杠开头和结尾
• 设置后需要重启Dashboard服务

工作原理

这种配置方式之所以有效，是因为：

1. Ingress控制器将外部请求的/dashboard路径重写为/
2. Ceph Dashboard知道它被挂载在/dashboard/下，会正确处理前端请求和API调用
3. 前端应用生成的URL都会包含正确的前缀

常见错误排查

如果配置后仍然无法访问，可以检查以下几点：

1. 确认url_prefix设置正确且包含结尾斜杠
2. 检查Ingress控制器的日志是否有错误
3. 使用curl测试API端点是否可达
4. 确认Dashboard服务本身是否健康

总结

通过合理配置Ingress和Ceph Dashboard的url_prefix，可以轻松实现将Dashboard部署在任意子路径下。关键是要确保路径重写规则正确，并且Ceph端知道自己的部署位置。这种配置方式特别适合需要在同一域名下部署多个服务的场景。

记住，路径配置中的斜杠处理是常见的问题来源，务必仔细检查。正确的配置可以带来无缝的用户体验，而错误的配置则可能导致各种奇怪的404错误。