Skip to content

Dashboard 配置

在EMQX中, Dashboard 是一个基于 Web 的图形界面,用于实时管理和监控 EMQX 及连接的设备。您可以配置以下 Dashboard 配置项:

  • listeners
  • token_expired_time
  • cors
  • swagger_support
  • sso

例如,要为EMQX Dashboard 配置 swagger_support 和一个监听器,以接受所有传入连接,您可以使用以下配置:

bash
dashboard {
  listeners {
    http {
      bind = "0.0.0.0:18083"
      max_connections = 512
    }
    https {
      # set 'bind = 0' will disable this listener
      bind = "0.0.0.0:18084"
      ssl_options {
        certfile = "${EMQX_ETC_DIR}/certs/cert.pem"
        keyfile = "${EMQX_ETC_DIR}/certs/key.pem"
      }
    }
  }
  swagger_support = true
  default_password = jEdOgGS6vzQ
}

其中,

  • swagger_support = true 用于启用所有与 swagger 相关的功能,如生成Swagger API文档。默认情况下,其值始终为 true,您可以将值设置为 false 以禁用它。
  • bind = "0.0.0.0:18083" 用于设置监听器绑定的网络地址和端口号。在这种情况下,监听器将绑定到所有可用的网络接口(0.0.0.0)上的端口 18083
  • max_connections = 512 用于设置监听器将接受的最大并发连接数。在这种情况下,最大连接数设置为 512
  • ssl_options.certfile: 指向包含 PEM 格式证书的文件。文件中第一个证书必须是服务器证书,紧接着是签发这个证书的中间 CA 证书,依次罗列到根 CA 证书为止。(根 CA 证书可选)。
  • ssl_options.keyfile: 指向包含 PEM 格式的私钥文件。
  • default_password: 用于为 admin 用户初始化数据库条目的默认密码。注意:一旦 EMQX 初次启动成功,修改这个密码将不再不起作用。初始化后,密码必须在控制台或者命令行进行修改。

TIP

EMQX 提供了更多配置项以更好地满足定制化需求。详情请参见 EMQX 开源版配置手册EMQX 企业版配置手册