文档首页/ 云搜索服务 CSS/ 用户指南/ OpenSearch/ 访问OpenSearch集群/ 通过OpenSearch Dashboards登录OpenSearch集群
更新时间：2026-01-09 GMT+08:00
查看PDF
分享

通过OpenSearch Dashboards登录OpenSearch集群

OpenSearch Dashboards是专为OpenSearch设计的可视化分析平台，适用于需要深度数据分析和交互式可视化的场景。CSS服务的OpenSearch集群默认集成开箱即用的OpenSearch Dashboards工具，无需安装部署即可一键启动。OpenSearch Dashboards不仅提供丰富的仪表盘构建能力和可视化工具，还深度整合了OpenSearch的统计分析功能，支持从数据探索到业务洞察的全流程分析。

CSS服务的OpenSearch Dashboards支持多种访问方式，不同访问方式登录OpenSearch集群的操作有差异，如表1所示。

表1 通过OpenSearch Dashboards登录OpenSearch集群的方式

OpenSearch Dashboards访问方式

使用约束

参考文档

控制台一键访问OpenSearch Dashboards

无。

通过控制台访问OpenSearch Dashboards登录OpenSearch集群

公网地址访问OpenSearch Dashboards
  • 仅安全模式的集群支持通过Dashboards公网访问地址访问OpenSearch Dashboards。

通过公网地址访问OpenSearch Dashboards登录OpenSearch集群

内网地址访问OpenSearch Dashboards

访问OpenSearch Dashboards的客户端地址和OpenSearch Dashboards的内网地址之间的网络必须是互通的。

通过内网地址访问OpenSearch Dashboards登录OpenSearch集群

OpenSearch Dashboards使用限制

OpenSearch Dashboards中可以自定义用户名、角色名、租户名等，不能包含中文字符。

通过控制台访问OpenSearch Dashboards登录OpenSearch集群

  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理 > OpenSearch”。
  3. 在集群列表，选择目标集群，单击操作列的“Dashboards”，登录OpenSearch Dashboards。
    • 非安全模式的集群：将直接进入OpenSearch Dashboards操作页面。
    • 安全模式的集群：需要在登录页面输入用户名和密码，单击“Log In”进入OpenSearch Dashboards操作页面。用户名默认为admin，密码为创建集群时设置的管理员密码。
  4. 登录成功后，可在OpenSearch Dashboards页面进行相关操作访问集群。

通过公网地址访问OpenSearch Dashboards登录OpenSearch集群

  • 仅安全模式的集群支持通过Dashboards公网访问地址访问OpenSearch Dashboards。
  • Dashboards公网访问配置的白名单依赖ELB的白名单能力。更新白名单后，白名单对新建的连接是实时生效的，但对于已存在的长连接，可能会出现去掉的白名单IP地址还能访问OpenSearch Dashboards的场景，这是因为要等长连接断开后才生效，预计1分钟左右。
  • 当关闭Dashboards公网访问后再重新打开，Dashboards的公网地址可能会发生变化，请谨慎操作。
  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理 > OpenSearch”。
  3. 在集群列表，单击目标集群名称，进入集群详情页。
  4. 选择“访问配置 > Dashboards公网访问”，查看集群是否开启Dashboards公网访问。
    • 是，执行6。
    • 否，执行下一步。
  5. 开启OpenSearch集群的Dashboards公网访问。
    1. 在“Dashboards公网访问”页面，单击右侧开关，打开Dashboards公网访问功能。
    2. 在“开启Dashboards公网访问”页面，配置相关参数。
      表2 配置Dashboards公网访问

      参数

      说明

      带宽

      设置OpenSearch Dashboards公网访问的带宽。

      取值范围：1Mbit/s~200Mbit/s

      设置访问白名单

      通过设置访问白名单实现Dashboards公网访问控制。

      • 设置访问白名单，则表示只允许白名单列表中的IP地址或网段通过公网访问集群OpenSearch Dashboards。

        单击“添加”，输入允许公网访问集群OpenSearch Dashboards的IP地址或网段（CIDR格式），以英文逗号分隔，不可重复。例如输入“192.168.1.1,10.0.0.0/24”，不支持“0.0.0.0”、“xx.xx.xx.xx/0”、“172.16.0.0-172.16.255.255”、非标准格式（如“192.168.1”）或重复项。

      • 不设置访问白名单，则表示所有公网IP地址都可以访问集群OpenSearch Dashboards。此时会有安全风险，不推荐。
    3. 配置完成后，单击“确定”，开启Dashboards公网访问。

    如果集群已配置Dashboards公网访问，也支持修改相关配置。

  6. 开启Dashboards公网访问后，在Dashboards公网访问页面获取“Dashboards公网访问地址”。
    图1 获取Dashboards公网访问地址
  7. 在浏览器中，输入“Dashboards公网访问地址”即可进入OpenSearch Dashboards登录页面。

    在登录页面输入用户名和密码，单击“Log In”进入OpenSearch Dashboards操作页面。用户名默认为admin，密码为创建集群时设置的管理员密码。

  8. 登录成功后，可在OpenSearch Dashboards页面进行相关操作访问OpenSearch集群。

通过内网地址访问OpenSearch Dashboards登录OpenSearch集群

访问OpenSearch Dashboards的客户端地址和OpenSearch Dashboards的内网地址之间的网络必须是互通的。

  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理 > OpenSearch”。
  3. 在集群列表，单击目标集群名称，进入集群详情页。
  4. 选择“概览”页签，在“网络信息”下方，获取并记录“内网访问IPv4地址”。
  5. 获取OpenSearch Dashboards的内网地址。

    将集群的内网访问地址的端口号从“9200”改为“5601”，即为OpenSearch Dashboards的内网地址。例如，集群的“内网访问IPv4地址”是“xx.xx.xx.xx:9200”，则OpenSearch Dashboards的内网地址为“xx.xx.xx.xx:5601”。

  6. （可选）配置回程路由。当客户端访问OpenSearch Dashboards时，如果客户端的地址和OpenSearch Dashboards的内网地址位于不同VPC网络，需要配置OpenSearch集群路由打通网络。
    1. 通过专线或对等连接打通客户端和OpenSearch Dashboards内网之间的网络。
    2. 在OpenSearch集群中添加客户端的路由信息。

      在集群概览页面，单击“集群路由”的“添加路由”。输入客户端的子网地址和子网掩码。

    详细操作指导请参见配置OpenSearch集群路由。

  7. 访问OpenSearch Dashboards。
    • OpenSearch开启安全模式，OpenSearch Dashboards访问地址是“https://{Dashboards内网地址}”，如“https://xx.xx.xx.xx:5601”。
    • OpenSearch未开启安全模式，OpenSearch Dashboards访问地址是“http://{Dashboards内网地址}”，如“http://xx.xx.xx.xx:5601”。

更多功能：支持自定义OpenSearch Dashboards的Base Path

在多集群管理场景中，OpenSearch Dashboards默认的根路径访问方式可能无法满足安全鉴权和请求校验需求。CSS服务支持在控制台自定义OpenSearch Dashboards Base Path配置，使您能够为不同集群设置专属访问路径，实现细粒度的访问控制，简化多集群管理流程，提升整体系统安全性。

  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理 > OpenSearch”。
  3. 在集群列表，单击目标集群名称，进入集群详情页。
  4. 选择“集群配置 > 参数配置 > Dashboards配置”。
  5. 单击“编辑”，配置参数值。
    表3 配置Base Path

    参数

    说明

    server.basePath

    自定义Base Path的参数值。

    当需要通过反向代理（如Nginx）访问OpenSearch Dashboards时，此参数值将会作为一个子路径跟在代理地址后面。例如反向代理的地址是“http://example.com”，“server.basePath”是“/test”，则通过地址“http://example.com/test”即可访问OpenSearch Dashboards。

    取值范围：
    • 必须以“/”开头。
    • 不能有连续的斜杠（如“//”）。
    • 只能包含字母、数字、短横线“-”、下划线“_”、点“.”和“/”。
    • 允许多层路径，但长度不能超过254字符。
    • 不能以“/”结尾。

    server.rewriteBasePath

    指定由OpenSearch Dashboards还是反向代理移除请求路径中server.basePath前缀。

    可选配置，如果没有使用反向代理访问OpenSearch Dashboards的需求，则忽略此参数。

    取值范围：
    • true，表示OpenSearch Dashboards会自动移除请求路径中的server.basePath前缀。
    • false（默认值），表示需要由反向代理（如Nginx）来移除请求路径中的server.basePath前缀。此时只能通过反向代理访问OpenSearch Dashboards。
  6. 修改完成后，单击“保存”，在弹窗中确认参数无误后勾选“修改Dashboards配置会自动重启Dashboards进程，期间可能短暂影响Dashboards访问。请稍后重试。”，单击“确定”。

    当下方的参数配置任务列表显示“作业状态”为“成功”时，表示参数修改成功。系统最多显示1000条修改记录。

  7. 访问OpenSearch Dashboards。
    • 通过Dashboards内网地址访问OpenSearch Dashboards
      • OpenSearch开启安全模式，“server.rewriteBasePath”为“true”，OpenSearch Dashboards内外网访问地址是“https://{Dashboards内网地址}{server.basePath}”，如“https://xx.xx.xx.xx:5601/test”。
      • OpenSearch开启安全模式，“server.rewriteBasePath”为“false”，只能通过反向代理访问OpenSearch Dashboards。
      • OpenSearch未开启安全模式，“server.rewriteBasePath”为“true”，OpenSearch Dashboards只支持内网访问，地址是“http://{Dashboards内网地址}{server.basePath}”，如“http://xx.xx.xx.xx:5601/test”。
      • OpenSearch未开启安全模式，“server.rewriteBasePath”为“false”，只能通过反向代理访问OpenSearch Dashboards。
    • 通过Dashboards公网访问地址访问OpenSearch Dashboards（依赖集群开启Dashboards公网访问）
      • “server.rewriteBasePath”为“true”，OpenSearch Dashboards公网访问地址是“https://{Dashboards公网访问地址}{server.basePath}”，如“https://xx.xx.xx.xx:5601/test”。
      • “server.rewriteBasePath”为“false”，只能通过反向代理访问OpenSearch Dashboards。
    • 通过反向代理服务器地址访问OpenSearch Dashboards

      OpenSearch Dashboards访问地址是“http://{反向代理服务器地址}{server.basePath}”，如“http://xx.xx.xx.xx:port/test”。是否支持公网访问取决于反向代理服务器地址是否为公网IP。此方案依赖反向代理服务器配置。

相关文档

父主题： 访问OpenSearch集群