定价
登录 开始使用
文档 学习
首页
分析
嵌入
管理
其他资源

环境变量

本文档是通过运行以下命令从源代码生成的

clojure -M:ee:doc environment-variables-documentation

Metabase 中的许多设置可以在管理面板中查看和修改，也可以通过环境变量设置。环境变量始终优先。请注意，与 Metabase 的管理设置中配置的设置不同，环境变量不会写入应用程序数据库。

如何设置环境变量

设置环境变量的方式取决于您运行 Metabase 的方式。

JAR 文件

# Mac, Linux and other Unix-based systems
export MB_SITE_NAME="Awesome Company"
# Windows Powershell
$env:MB_SITE_NAME="Awesome Company"
# Windows batch/cmd
set MB_SITE_NAME="Awesome Company"

java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

或将其设置为 Java 属性，这在所有系统中都适用

java -DMB_SITE_NAME="Awesome Company" -jar metabase.jar

Docker

docker run -d -p 3000:3000 -e MB_SITE_NAME="Awesome Company" --name metabase metabase/metabase

Metabase 云上的环境变量

如果您运行的是 Metabase 云，您可以联系支持来调整您的 Metabase 的环境变量。

环境变量列表

MB_ADMIN_EMAIL

如果用户遇到问题，应参考的电子邮件地址。

MB_AGGREGATED_QUERY_ROW_LIMIT

  • 类型：整数
  • 默认值：10000
  • 导出为：aggregated-query-row-limit。
  • 配置文件名：aggregated-query-row-limit

通过 API 返回聚合查询的最大行数。

必须小于 1048575。另请参阅 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

MB_ALLOWED_IFRAME_HOSTS

  • 类型：字符串
  • 默认值：youtube.com, youtu.be, loom.com, vimeo.com, docs.google.com, calendar.google.com, airtable.com, typeform.com, canva.com, codepen.io, figma.com, grafana.com, miro.com, excalidraw.com, notion.com, atlassian.com, trello.com, asana.com, gist.github.com, linkedin.com, twitter.com, x.com
  • 导出为：allowed-iframe-hosts。
  • 配置文件名：allowed-iframe-hosts

允许的 iframe 主机。

MB_ANON_TRACKING_ENABLED

  • 类型：布尔值
  • 默认值：true
  • 配置文件名：anon-tracking-enabled

启用匿名使用数据收集，以帮助 Metabase 改进。

MB_API_KEY

  • 类型：字符串
  • 默认值：null

设置后，所有 API 请求都需要此 API 密钥。

中间件，用于通过请求头 X-Metabase-Apikey 强制验证客户端。如果请求头可用，则针对 MB_API_KEY 进行验证。如果匹配，则请求继续；否则，请求将被阻止并返回 403 Forbidden 响应。

MB_APPLICATION_COLORS

仅在 Metabase Pro 和 Enterprise 计划中可用。

选择在整个 Metabase 用户界面中使用的颜色，以及专门用于图表的其他颜色。您需要刷新浏览器才能看到更改生效。

要更改用户界面颜色

{
 "brand":"#ff003b",
 "filter":"#FF003B",
 "summarize":"#FF003B"
}

要更改图表颜色

{
 "accent0":"#FF0005",
 "accent1":"#E6C367",
 "accent2":"#B9E68A",
 "accent3":"#8AE69F",
 "accent4":"#8AE6E4",
 "accent5":"#8AA2E6",
 "accent6":"#B68AE6",
 "accent7":"#E68AD0"
}

MB_APPLICATION_FAVICON_URL

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：app/assets/img/favicon.ico
  • 导出为：application-favicon-url。
  • 配置文件名：application-favicon-url

上传文件以用作网站图标。

MB_APPLICATION_FONT

仅在 Metabase Pro 和 Enterprise 计划中可用。

替换字体系列 “Lato”。

MB_APPLICATION_FONT_FILES

仅在 Metabase Pro 和 Enterprise 计划中可用。

告诉我们从哪里找到每个字重的文件。您不需要包含所有文件，但如果包含所有文件，效果会更好。

示例值

[
  {
    "src": "https://example.com/resources/font-400",
    "fontFormat": "ttf",
    "fontWeight": 400
  },
  {
    "src": "https://example.com/resources/font-700",
    "fontFormat": "woff",
    "fontWeight": 700
  }
]

请参阅字体。

MB_APPLICATION_LOGO_URL

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：app/assets/img/logo.svg
  • 导出为：application-logo-url。
  • 配置文件名：application-logo-url

上传文件以替换顶部栏上的 Metabase 徽标。

不支持内联样式和内联脚本。

MB_APPLICATION_NAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

替换所有出现 “Metabase” 的字样。

MB_ATTACHMENT_TABLE_ROW_LIMIT

  • 类型：正整数
  • 默认值：20

警报或订阅图像中呈现的最大行数。

范围：1-100。要限制电子邮件仪表板订阅的文件附件中包含的总行数，请使用 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

MB_BCC_ENABLED

是否启用密件抄送电子邮件，默认行为是启用。

MB_BREAKOUT_BIN_WIDTH

  • 类型：双精度浮点数
  • 默认值：10.0
  • 配置文件名：breakout-bin-width

当对坐标类型字段（例如经度和纬度）使用默认分箱策略时，此数字将用作默认分箱宽度（以度为单位）。

MB_BREAKOUT_BINS_NUM

当使用默认分箱策略且未提供箱数时，将使用此数字作为默认值。

MB_CHECK_FOR_UPDATES

识别 Metabase 何时有新版本可用。

MB_CONFIG_FROM_FILE_SYNC_DATABASES

  • 类型：布尔值
  • 默认值：true

是否在 config-from-file 初始化期间（异步）同步新创建的数据库。默认情况下为 true，但如果您想手动同步或使用 SerDes 来填充其数据模型，则可以禁用此行为。

MB_CUSTOM_FORMATTING

按类型键控的对象，包含格式设置。

MB_CUSTOM_GEOJSON

JSON，包含有关自定义 GeoJSON 文件的信息，用于地图可视化，而不是默认的美国州或世界 GeoJSON。

MB_CUSTOM_GEOJSON_ENABLED

是否启用自定义 GeoJSON 的使用。

MB_CUSTOM_HOMEPAGE

选择一个仪表板作为主页。没有仪表板访问权限的用户将被定向到默认主页。

MB_CUSTOM_HOMEPAGE_DASHBOARD

  • 类型：整数
  • 默认值：null
  • 配置文件名：custom-homepage-dashboard

要用作主页的仪表板的 ID。

MB_DB_CONNECTION_TIMEOUT_MS

  • 类型：整数
  • 默认值：10000

如果 metabase.driver/can-connect? / can-connect-with-details? 在此毫秒数后仍无法成功连接，则认为连接失败。默认情况下，此值为 10 秒。

连接到数据库（包括 Metabase 应用程序数据库和数据连接）的超时时间（以毫秒为单位）。如果您通过 SSH 隧道连接并遇到超时，您可以考虑增加此值，因为通过隧道连接比没有隧道的连接开销更大。

MB_DB_QUERY_TIMEOUT_MINUTES

  • 类型：整数
  • 默认值：20

默认情况下，此值为 20 分钟。

数据库查询执行的超时时间（以分钟为单位），包括 Metabase 应用程序数据库和数据连接。如果您有长时间运行的查询，您可以考虑增加此值。调整超时时间不会影响 Metabase 的前端。请注意，其他服务（如 Nginx）可能仍然会丢弃长时间运行的查询。

MB_DEFAULT_MAPS_ENABLED

是否启用默认的 GeoJSON 地图。

MB_DOWNLOAD_ROW_LIMIT

  • 类型：整数
  • 默认值：null
  • 导出为: download-row-limit。

导出行的限制，不包括标题行。即使此限制更高，xlsx 下载也限制为 1048575 行。

MB_EE_AI_FEATURES_ENABLED

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: ee-ai-features-enabled

启用 AI 功能。

此功能为实验性功能。

MB_EE_OPENAI_API_KEY

Metabase 企业版中使用的 OpenAI API 密钥。

此功能为实验性功能。

MB_EE_OPENAI_MODEL

  • 类型：字符串
  • 默认值: gpt-4-turbo-preview
  • 配置文件名: ee-openai-model

OpenAI 模型 (例如 gpt-4, gpt-3.5-turbo)。

此功能为实验性功能。

MB_EMAIL_FROM_ADDRESS

您希望用于电子邮件发送者的电子邮件地址。

MB_EMAIL_FROM_NAME

您希望用于电子邮件发送者的名称。

MB_EMAIL_MAX_RECIPIENTS_PER_SECOND

  • 类型：整数
  • 默认值：null
  • 导出为: email-max-recipients-per-second。
  • 配置文件名: email-max-recipients-per-second

每秒可以发送的最大收件人数量，总计所有电子邮件。 请注意，如果最后一封发送的电子邮件有多个收件人，则可能会超出限制。

MB_EMAIL_REPLY_TO

您希望回复发送到的电子邮件地址，如果与发件人地址不同。

MB_EMAIL_SMTP_HOST

处理您的电子邮件的 SMTP 服务器地址。

MB_EMAIL_SMTP_PASSWORD

SMTP 密码。

MB_EMAIL_SMTP_PORT

您的 SMTP 服务器用于发送电子邮件的端口。

MB_EMAIL_SMTP_SECURITY

SMTP 安全连接协议。（tls、ssl、starttls 或 none）。

MB_EMAIL_SMTP_USERNAME

SMTP 用户名。

MB_EMBEDDING_APP_ORIGINS_INTERACTIVE

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 配置文件名: embedding-app-origins-interactive

允许这些以空格分隔的来源嵌入 Metabase 交互式组件。

MB_EMBEDDING_APP_ORIGINS_SDK

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: localhost:*
  • 配置文件名: embedding-app-origins-sdk

允许 Metabase SDK 访问这些以空格分隔的来源。

MB_EMBEDDING_HOMEPAGE

嵌入主页状态，指示其是否可见、隐藏或已关闭。

MB_EMBEDDING_SECRET_KEY

  • 类型：字符串
  • 默认值：null
  • 配置文件名: embedding-secret-key

用于为 /api/embed 端点的请求签名 JSON Web Tokens 的密钥。

MB_ENABLE_EMBEDDING_INTERACTIVE

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: enable-embedding-interactive

允许管理员通过交互式嵌入来嵌入 Metabase 吗？

MB_ENABLE_EMBEDDING_SDK

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: enable-embedding-sdk

允许管理员通过 SDK 嵌入 Metabase 吗？

MB_ENABLE_EMBEDDING_STATIC

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: enable-embedding-static

允许管理员通过静态嵌入来嵌入 Metabase 吗？

MB_ENABLE_FIELD_USAGE_ANALYSIS

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: enable-field-usage-analysis

为查询启用字段使用分析。 这将分析查询中使用的字段，并将其存储在应用程序数据库中。

Turn off by default since we havent had an user-facing feature that uses this data yet.

MB_ENABLE_PASSWORD_LOGIN

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: enable-password-login

允许通过电子邮件和密码登录。

MB_ENABLE_PIVOTED_EXPORTS

启用透视导出和透视订阅。

MB_ENABLE_PUBLIC_SHARING

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: enable-public-sharing

允许管理员为问题和仪表板创建公开可见的链接（和可嵌入的 iframe）吗？

MB_ENABLE_QUERY_CACHING

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: enable-query-caching

允许缓存运行时间较长的查询结果。

MB_ENABLE_XRAYS

允许用户使用 X 射线探索数据。

MB_FOLLOW_UP_EMAIL_SENT

  • 类型：布尔值
  • 默认值：false

我们是否已向实例管理员发送了跟进电子邮件？

MB_GOOGLE_AUTH_AUTO_CREATE_ACCOUNTS_DOMAIN

  • 类型：字符串
  • 默认值：null
  • 配置文件名: google-auth-auto-create-accounts-domain

设置后，如果用户的 Google 帐户电子邮件地址来自此域，则允许用户自行注册。

MB_GOOGLE_AUTH_CLIENT_ID

  • 类型：字符串
  • 默认值：null
  • 配置文件名: google-auth-client-id

Google 登录的客户端 ID。

MB_GOOGLE_AUTH_ENABLED

当前是否启用了 Google 登录？

MB_HEALTH_CHECK_LOGGING_ENABLED

  • 类型：布尔值
  • 默认值：true

是否记录来自会话中间件的健康检查请求。

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于控制帮助链接白标化的关键字设置。有效值为 :metabase、:hidden 和 :custom。如果设置了 :custom，则帮助链接将使用 help-link-custom-destination 中指定的 URL，如果未设置，则会被隐藏。

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: https://metabase.net.cn/help/premium
  • 配置文件名: help-link-custom-destination

帮助链接的自定义 URL。

MB_HUMANIZATION_STRATEGY

为了使表名和字段名更人性化，Metabase 会将它们中的破折号和下划线替换为空格。 我们还会将每个单词的首字母大写，因此 ‘last_visited_at’ 将变为 ‘Last Visited At’。

MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE

  • 类型：整数
  • 默认值: 15

c3p0 连接池的最大大小。

如果您注意到常规使用消耗了全部或接近全部连接，请将此值更改为更高的值。

当所有连接都在使用中时，Metabase 返回查询结果的速度会变慢，因为它必须等待可用连接才能处理队列中的下一个查询。

有关设置最大值，请参阅 MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE。

MB_JWT_ATTRIBUTE_EMAIL

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于检索 JWT 用户电子邮件地址的键。

MB_JWT_ATTRIBUTE_FIRSTNAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: first_name
  • 配置文件名: jwt-attribute-firstname

用于检索 JWT 用户名字的键。

MB_JWT_ATTRIBUTE_GROUPS

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: groups
  • 配置文件名: jwt-attribute-groups

用于检索 JWT 用户组的键。

MB_JWT_ATTRIBUTE_LASTNAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: last_name
  • 配置文件名: jwt-attribute-lastname

用于检索 JWT 用户姓氏的键。

MB_JWT_ENABLED

仅在 Metabase Pro 和 Enterprise 计划中可用。

是否配置并启用了 JWT 身份验证？

设置为 true 时，将使用 MB_JWT_* 变量中配置的选项启用 JWT 身份验证。 这用于 JWT SSO 身份验证，与静态嵌入无关，静态嵌入是 MB_EMBEDDING_SECRET_KEY。

MB_JWT_GROUP_MAPPINGS

仅在 Metabase Pro 和 Enterprise 计划中可用。

包含 JWT 到 Metabase 组映射的 JSON。

JSON 对象，包含 JWT 到 Metabase 组的映射，其中键是 JWT 组，值是 Metabase 组 ID 的列表。

MB_JWT_GROUP_SYNC

仅在 Metabase Pro 和 Enterprise 计划中可用。

启用与 JWT 的组成员身份同步。

MB_JWT_IDENTITY_PROVIDER_URI

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 配置文件名: jwt-identity-provider-uri

基于 JWT 的登录页面的 URL。如果仅将 JWT SSO 与嵌入式分析 SDK 一起使用，则为可选。

MB_JWT_SHARED_SECRET

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于播种私钥的字符串，该私钥用于验证 JWT 消息。 强烈建议使用十六进制编码的 256 位密钥（即，一个 64 个字符的字符串）。

MB_JWT_USER_PROVISIONING_ENABLED

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: jwt-user-provisioning-enabled

当我们启用 JWT 用户预置时，我们会为在 JWT 登录时没有 Metabase 帐户的用户自动创建一个帐户。

MB_LANDING_PAGE

输入要向用户显示的着陆页面的 URL。 这将覆盖上面的自定义主页设置。

MB_LANDING_PAGE_ILLUSTRATION

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: default
  • 导出为: landing-page-illustration。
  • 配置文件名: landing-page-illustration

用于在着陆页上显示插图的选项。

MB_LANDING_PAGE_ILLUSTRATION_CUSTOM

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 导出为: landing-page-illustration-custom。
  • 配置文件名: landing-page-illustration-custom

着陆页的自定义插图。

MB_LDAP_ATTRIBUTE_EMAIL

用于用户电子邮件的属性。（通常为 ‘mail’、‘email’ 或 ‘userPrincipalName’）。

MB_LDAP_ATTRIBUTE_FIRSTNAME

  • 类型：字符串
  • 默认值: givenName
  • 配置文件名: ldap-attribute-firstname

用于用户名字的属性。（通常为 ‘givenName’）。

MB_LDAP_ATTRIBUTE_LASTNAME

  • 类型：字符串
  • 默认值: sn
  • 配置文件名: ldap-attribute-lastname

用于用户姓氏的属性。（通常为 ‘sn’）。

MB_LDAP_BIND_DN

要绑定为的专有名称（如果有），此用户将用于查找有关其他用户的信息。

MB_LDAP_ENABLED

当前是否启用了 LDAP？

MB_LDAP_GROUP_BASE

组的搜索库。 对于提供 ‘memberOf’ 覆盖的 LDAP 目录（例如 Active Directory）不是必需的。（将递归搜索）。

MB_LDAP_GROUP_MAPPINGS

包含 LDAP 到 Metabase 组映射的 JSON。

MB_LDAP_GROUP_MEMBERSHIP_FILTER

  • 类型：字符串
  • 默认值: (member={dn})
  • 配置文件名: ldap-group-membership-filter

组成员身份查找过滤器。 占位符 {dn} 和 {uid} 将分别替换为用户的专有名称和 UID。

MB_LDAP_GROUP_SYNC

启用与 LDAP 的组成员身份同步。

MB_LDAP_HOST

服务器主机名。

MB_LDAP_PASSWORD

用于查找用户的绑定密码。

MB_LDAP_PORT

服务器端口，如果使用 SSL，通常为 389 或 636。

MB_LDAP_SECURITY

使用 SSL、TLS 或纯文本。

MB_LDAP_SYNC_USER_ATTRIBUTES

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: ldap-sync-user-attributes

当有人通过 LDAP 登录时，我们是否应该同步用户属性？

MB_LDAP_SYNC_USER_ATTRIBUTES_BLACKLIST

  • 类型: csv
  • 默认值: userPassword,dn,distinguishedName
  • 配置文件名: ldap-sync-user-attributes-blacklist

要跳过 LDAP 用户同步的用户属性的逗号分隔列表。

MB_LDAP_USER_BASE

用户的搜索库。（将递归搜索）。

MB_LDAP_USER_FILTER

  • 类型：字符串
  • 默认值: (&(objectClass=inetOrgPerson)(|(uid={login})(mail={login})))
  • 配置文件名: ldap-user-filter

用户查找过滤器。 占位符 {login} 将替换为用户提供的登录名。

MB_LDAP_USER_PROVISIONING_ENABLED

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: ldap-user-provisioning-enabled

当我们启用 LDAP 用户预置时，我们会为在 LDAP 登录时没有 Metabase 帐户的用户自动创建一个帐户。

MB_LOADING_MESSAGE

仅在 Metabase Pro 和 Enterprise 计划中可用。

选择在查询运行时显示的消息。 可能的值为 “doing-science”、“running-query” 或 “loading-results”。

MB_LOGIN_PAGE_ILLUSTRATION

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于在登录页上显示插图的选项。

MB_LOGIN_PAGE_ILLUSTRATION_CUSTOM

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 导出为: login-page-illustration-custom。
  • 配置文件名: login-page-illustration-custom

登录页的自定义插图。

MB_MAP_TILE_SERVER_URL

  • 类型：字符串
  • 默认值: https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
  • 配置文件名: map-tile-server-url

地图可视化中使用的地图瓦片服务器 URL 模板，例如来自 OpenStreetMaps 或 MapBox。

MB_NATIVE_QUERY_AUTOCOMPLETE_MATCH_STYLE

  • 类型: keyword
  • 默认值: :substring
  • 导出为: native-query-autocomplete-match-style。
  • 配置文件名: native-query-autocomplete-match-style

原生查询编辑器自动完成的匹配样式。 可以是 “substring”、“prefix” 或 “off”。 较大的实例在使用子字符串匹配时可能会出现性能问题，因此可以使用前缀匹配，或关闭自动完成。

MB_NESTED_FIELD_COLUMNS_VALUE_LENGTH_LIMIT

  • 类型：整数
  • 默认值: 50000
  • 导出为: nested-field-columns-value-length-limit。

JSON 字符串在 JSON 展开同步期间跳过之前的最大长度。 如果设置得太高，可能会导致同步缓慢或内存不足错误。

MB_NO_DATA_ILLUSTRATION

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于在问题运行后没有结果时显示插图的选项。

MB_NO_DATA_ILLUSTRATION_CUSTOM

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 导出为: no-data-illustration-custom。
  • 配置文件名: no-data-illustration-custom

问题运行后没有结果时的自定义插图。

MB_NO_OBJECT_ILLUSTRATION

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于在搜索后没有结果时显示插图的选项。

MB_NO_OBJECT_ILLUSTRATION_CUSTOM

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 导出为: no-object-illustration-custom。
  • 配置文件名: no-object-illustration-custom

搜索后没有结果时的自定义插图。

MB_NOT_BEHIND_PROXY

  • 类型：布尔值
  • 默认值：false

指示 Metabase 是否在代理后面运行，该代理为传入请求设置源地址标头。

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null

默认情况下，通知链接中使用“站点 URL”，但可以覆盖。

仪表板通知链接将指向的基准 URL，而不是 Metabase 基准 URL。 仅适用于使用交互式嵌入和订阅的用户。

MB_NOTIFICATION_THREAD_POOL_SIZE

  • 类型：整数
  • 默认值: 3

用于发送通知的线程池的大小。

MB_PERSISTED_MODEL_REFRESH_CRON_SCHEDULE

  • 类型：字符串
  • 默认值: 0 0 0/6 * * ? *
  • 配置文件名: persisted-model-refresh-cron-schedule

用于计划刷新持久化模型的 cron 语法字符串。

MB_PERSISTED_MODELS_ENABLED

允许将模型持久化到源数据库中。

MB_PREMIUM_EMBEDDING_TOKEN

  • 类型：字符串
  • 默认值：null
  • 配置文件名: premium-embedding-token

高级功能的令牌。 前往 MetaStore 获取您的令牌！

MB_QUERY_ANALYSIS_ENABLED

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: query-analysis-enabled

是否分析任何查询。

MB_QUERY_CACHING_MAX_KB

每个已保存问题的缓存最大大小，以千字节为单位。

MB_QUERY_CACHING_MAX_TTL

  • 类型：双精度浮点数
  • 默认值: 3024000.0
  • 配置文件名: query-caching-max-ttl

保持任何缓存查询结果的绝对最长时间，以秒为单位。

MB_REDIRECT_ALL_REQUESTS_TO_HTTPS

  • 类型：布尔值
  • 默认值：false
  • 配置文件名: redirect-all-requests-to-https

如果站点 URL 为 HTTPS，则强制所有流量通过重定向使用 HTTPS。

MB_REPORT_TIMEZONE

执行查询时要使用的连接时区。 默认为系统时区。

MB_RESET_TOKEN_TTL_HOURS

  • 类型：整数
  • 默认值: 48

密码重置被视为有效的小时数。

MB_RETRY_INITIAL_INTERVAL

初始重试延迟（以毫秒为单位）。

MB_RETRY_MAX_ATTEMPTS

事件的最大尝试次数。

MB_RETRY_MAX_INTERVAL_MILLIS

  • 类型：整数
  • 默认值: 30000
  • 配置文件名: retry-max-interval-millis

尝试之间的最大延迟。

MB_RETRY_MULTIPLIER

  • 类型：双精度浮点数
  • 默认值: 2.0
  • 配置文件名: retry-multiplier

尝试之间的延迟乘数。

MB_RETRY_RANDOMIZATION_FACTOR

  • 类型：双精度浮点数
  • 默认值: 0.1
  • 配置文件名: retry-randomization-factor

重试延迟的随机化因子。

MB_SAML_APPLICATION_NAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：Metabase
  • 配置文件名: saml-application-name

此应用程序名称将用于向身份提供商发出的请求。

MB_SAML_ATTRIBUTE_EMAIL

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • 配置文件名: saml-attribute-email

用户电子邮件地址的 SAML 属性。

MB_SAML_ATTRIBUTE_FIRSTNAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
  • 配置文件名: saml-attribute-firstname

用户名字的 SAML 属性。

MB_SAML_ATTRIBUTE_GROUP

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: member_of
  • 配置文件名: saml-attribute-group

用于组同步的 SAML 属性。

MB_SAML_ATTRIBUTE_LASTNAME

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
  • 配置文件名: saml-attribute-lastname

用户姓氏的 SAML 属性。

MB_SAML_ENABLED

仅在 Metabase Pro 和 Enterprise 计划中可用。

是否配置并启用了 SAML 身份验证？

MB_SAML_GROUP_MAPPINGS

仅在 Metabase Pro 和 Enterprise 计划中可用。

包含 SAML 到 Metabase 组映射的 JSON。

MB_SAML_GROUP_SYNC

仅在 Metabase Pro 和 Enterprise 计划中可用。

启用与 SAML 的组成员身份同步。

MB_SAML_IDENTITY_PROVIDER_CERTIFICATE

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 配置文件名: saml-identity-provider-certificate

身份提供商的编码证书。 根据您的 IdP，您可能需要下载此证书，在文本编辑器中打开它，然后复制并粘贴证书内容到此处。

MB_SAML_IDENTITY_PROVIDER_ISSUER

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 配置文件名: saml-identity-provider-issuer

这是 IdP 的唯一标识符。 通常称为实体 ID 或简称为颁发者。 根据您的 IdP，它通常看起来像 http://www.example.com/141xkex604w0Q5PN724v。

MB_SAML_IDENTITY_PROVIDER_URI

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 配置文件名: saml-identity-provider-uri

这是您的用户登录到身份提供商时访问的 URL。 根据您使用的 IdP，它通常看起来像 https://your-org-name.example.com 或 https://example.com/app/my_saml_app/abc123/sso/saml。

MB_SAML_KEYSTORE_ALIAS

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: metabase
  • 配置文件名: saml-keystore-alias

Metabase 应用于签署 SAML 请求的密钥的别名。

MB_SAML_KEYSTORE_PASSWORD

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值: changeit
  • 配置文件名: saml-keystore-password

用于打开密钥库的密码。

MB_SAML_KEYSTORE_PATH

仅在 Metabase Pro 和 Enterprise 计划中可用。

用于签署 SAML 请求的密钥库文件的绝对路径。

MB_SAML_SLO_ENABLED

仅在 Metabase Pro 和 Enterprise 计划中可用。

是否启用了 SAML 单点注销？

MB_SAML_USER_PROVISIONING_ENABLED

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：布尔值
  • 默认值：true
  • 配置文件名: saml-user-provisioning-enabled

当我们启用 SAML 用户预置时，我们会为在 SAML 登录时没有 Metabase 帐户的用户自动创建一个帐户。

MB_SCIM_ENABLED

当前是否启用了 SCIM？

MB_SEARCH_ENGINE

  • 类型: keyword
  • 默认值: :in-place

执行搜索时要使用的引擎。 支持的值为 :in-place 和 :appdb。

MB_SEARCH_TYPEAHEAD_ENABLED

在 Metabase 导航栏中启用预输入搜索？

MB_SEND_NEW_SSO_USER_ADMIN_EMAIL

  • 类型：布尔值
  • 默认值：null
  • 配置文件名: send-new-sso-user-admin-email

是否应向管理员发送关于所有新 SSO 用户的电子邮件通知？

会话 Cookie 的 SameSite 指令的值。

请参阅 在不同域中嵌入 Metabase。阅读更多关于 交互式嵌入 的信息。了解更多关于 SameSite Cookie 的信息。

MB_SESSION_COOKIES

设置后，对所有用户强制使用会话 Cookie，这些 Cookie 在浏览器关闭时过期。

用户登录会话始终在 MAX_SESSION_AGE 中定义的时间后过期（默认为 2 周）。 这会覆盖登录时的“记住我”复选框。另请参阅 更改会话过期时间 文档页面。

MB_SESSION_TIMEOUT

非活动用户被注销前的时间。 默认情况下，会话持续无限期。

必须为 JSON 格式 "{"amount":120,"unit":"minutes"}"，其中 unit 是 “seconds”、“minutes” 或 “hours” 之一。

MB_SETUP_EMBEDDING_AUTOENABLED

  • 类型：布尔值
  • 默认值：false
  • 导出为: setup-embedding-autoenabled。
  • 配置文件名: setup-embedding-autoenabled

指示是否在设置期间自动启用了嵌入，因为用户对嵌入感兴趣。

MB_SETUP_LICENSE_ACTIVE_AT_SETUP

  • 类型：布尔值
  • 默认值：false
  • 导出为: setup-license-active-at-setup。
  • 配置文件名: setup-license-active-at-setup

指示在设置结束时是否激活了有效的许可证。

MB_SHOW_DATABASE_SYNCING_MODAL

  • 类型：布尔值
  • 默认值：null
  • 配置文件名: show-database-syncing-modal

在添加下一个数据库连接后，是否应显示介绍性模态框。 如果任何非默认数据库已为此实例完成同步，则默认为 false。

MB_SHOW_HOMEPAGE_DATA

是否在主页上显示数据。 管理员可能会关闭此功能，以便引导用户访问比原始数据更好的内容。

MB_SHOW_HOMEPAGE_XRAYS

是否在主页上显示 X 射线建议。 如果任何仪表板被固定，它们也会被隐藏。 管理员可能会隐藏此功能，以便引导用户访问比原始数据更好的内容。

仅在 Metabase Pro 和 Enterprise 计划中可用。

是否在管理设置之外显示 Metabase 链接。

MB_SHOW_METABOT

仅在 Metabase Pro 和 Enterprise 计划中可用。

在主页上启用 Metabot 角色。

MB_SITE_LOCALE

Metabase UI、系统电子邮件、脉冲和警报中所有用户的默认语言。 用户可以从自己的帐户设置中单独覆盖此默认语言。

MB_SITE_NAME

用于此 Metabase 实例的名称。

MB_SITE_URL

此 URL 用于在电子邮件中创建链接、身份验证重定向以及某些嵌入场景等，因此更改它可能会破坏功能或使您被锁定在此实例之外。

此 URL 对于 SSO 身份验证、电子邮件链接、嵌入等至关重要。 即使 http:// 与 https:// 的差异也可能导致问题。 请确保定义的地址是 Metabase 的访问方式。

MB_SLACK_APP_TOKEN

用于连接 Metabase Slack 应用程序的 Bot 用户 OAuth 令牌。 这应该用于 Metabase v0.42.0 中开始的所有新 Slack 集成。

MB_SLACK_BUG_REPORT_CHANNEL

  • 类型：字符串
  • 默认值: metabase-bugs
  • 配置文件名: slack-bug-report-channel

应在其中发布错误报告的频道名称。

MB_SLACK_FILES_CHANNEL

  • 类型：字符串
  • 默认值: metabase_files
  • 配置文件名: slack-files-channel

Metabase 文件应初始上传到的频道名称。

MB_SOURCE_ADDRESS_HEADER

  • 类型：字符串
  • 默认值: X-Forwarded-For
  • 导出为: source-address-header。
  • 配置文件名: source-address-header

通过此标头值（而不是其远程地址）识别 HTTP 请求的来源。

MB_SQL_JDBC_FETCH_SIZE

  • 类型：整数
  • 默认值: 500

结果集提取大小。 我们希望确保 jdbc ResultSet 对象不会在内存中实现整个结果。

MB_SQL_PARSING_ENABLED

  • 类型：布尔值
  • 默认值：true

SQL 解析已禁用。

MB_SSH_HEARTBEAT_INTERVAL_SEC

  • 类型：整数
  • 默认值: 180
  • 配置文件名: ssh-heartbeat-interval-sec

控制建立 SSH 隧道时发送心跳的频率（以秒为单位）。

MB_START_OF_WEEK

这将影响按周分组或在 GUI 查询中筛选等操作。 它不会影响大多数 SQL 查询，尽管它用于在 Snowflake 中设置 WEEK_START 会话变量。

MB_SUBSCRIPTION_ALLOWED_DOMAINS

仅在 Metabase Pro 和 Enterprise 计划中可用。

  • 类型：字符串
  • 默认值：null
  • 导出为: subscription-allowed-domains。
  • 配置文件名: subscription-allowed-domains

新仪表板订阅和警报的允许电子邮件地址域。 要指定多个域，请用逗号分隔每个域，中间不要有空格。 要允许所有域，请将字段留空。 此设置不影响现有订阅。

MB_SURVEYS_ENABLED

  • 类型：布尔值
  • 默认值：true

启用或禁用调查。

MB_SYNCHRONOUS_BATCH_UPDATES

  • 类型：布尔值
  • 默认值：false
  • 导出为: synchronous-batch-updates。
  • 配置文件名: synchronous-batch-updates

同步处理批次更新。 如果为 true，则所有 submit! 调用将立即处理。 默认为 false。

MB_UNAGGREGATED_QUERY_ROW_LIMIT

  • 类型：整数
  • 默认值: 2000
  • 导出为: unaggregated-query-row-limit。
  • 配置文件名: unaggregated-query-row-limit

通过 API 专门在 :rows 类型查询上返回的最大行数。

必须小于 1048575，且小于 MB_AGGREGATED_QUERY_ROW_LIMIT 中配置的数字。 另请参阅 MB_AGGREGATED_QUERY_ROW_LIMIT。

MB_UPDATE_CHANNEL

当有此类型的发布新版本时，我们将在此处通知您。

MB_UPLOADS_SETTINGS

上传设置。

MB_USER_VISIBILITY

仅在 Metabase Pro 和 Enterprise 计划中可用。

注意：沙盒用户永远不会看到建议。

其他环境变量

以下环境变量只能通过环境设置。 它们不能通过配置文件设置。

MAX_SESSION_AGE

类型：整数
默认值: 20160

会话过期时间，以分钟为单位定义（默认为 2 周），这将在定义的时间段后注销用户并需要重新身份验证。

注意：此设置不是空闲/不活动超时。 如果您将其设置为 15 分钟，则您的用户必须每 15 分钟再次登录（或重新身份验证）。 使用 MB_SESSION_TIMEOUT 来控制基于不活动的超时。

使用 MB_SESSION_COOKIES 也可以在浏览器关闭时使会话过期。

另请参阅 更改会话过期时间 文档页面。

MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE

类型：整数
默认值: 15
自从: v35.0

到 Metabase 应用程序数据库的最大连接数。

如果您注意到常规使用消耗了全部或接近全部连接，请将此值更改为更高的值。 当所有连接都在使用中时，在界面中点击时，Metabase 可能会感觉缓慢或无响应。

要查看正在使用多少连接，请检查 Metabase 日志并查找包含以下内容的行： … App DB connections: 12/15 …。 在此示例中，正在使用 15 个可用连接中的 12 个。

有关设置到 Metabase 连接的数据库的最大连接数，请参阅 MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE。

MB_ASYNC_QUERY_THREAD_POOL_SIZE

类型：整数
默认值: 50
自从: v35.0

最大异步 Jetty 线程数。 如果未设置，则将使用 MB_JETTY_MAXTHREADS，否则将使用默认值。

MB_ATTACHMENT_TABLE_ROW_LIMIT

类型：整数
默认值：20

限制 Metabase 将在仪表板订阅和警报中发送的表格中显示的行数。 范围：1-100。 要限制电子邮件仪表板订阅的文件附件中包含的总行数，请使用 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

MB_AUDIT_MAX_RETENTION_DAYS

仅在 Metabase Pro 和 Enterprise 计划中可用。
类型：整数
默认值: 720 (Metabase 保留所有行)

设置 Metabase 为以下应用程序数据库表保留行的最大天数

  • query_execution
  • audit_log
  • view_log

Metabase 每天两次删除早于此阈值的行。

最小值为 30 天（Metabase 将输入值 1 到 29 视为与 30 相同）。 如果设置为 0，Metabase 将保留所有行。

MB_COLORIZE_LOGS

类型：布尔值
默认值：true

彩色日志行。 当设置为 false 时，它将禁用日志行颜色。 这在 Windows 上被禁用。 与 MB_EMOJI_IN_LOGS 相关。

MB_CONFIG_FILE_PATH

类型：字符串
默认值: config.yml

此功能需要您的令牌上的 config-text-file 功能标志。

MB_CUSTOM_GEOJSON_ENABLED

类型：布尔值
默认值：true

是否启用自定义 GeoJSON 的使用。

MB_DB_AUTOMIGRATE

类型：布尔值
默认值：true

当设置为 false 时，Metabase 将打印需要在应用程序数据库中完成的迁移并退出。 这些迁移需要手动应用。 当 true 时，Metabase 将自动更改应用程序数据库。 这与从 H2 迁移无关。

MB_DB_CONNECTION_URI

类型：字符串
默认值：null

JDBC 样式连接 URI，可以代替大多数 MB_DB_*，如 MB_DB_HOST。 当连接需要某些连接字符串参数时也使用。 连接类型要求与 MB_DB_TYPE 相同。

示例

jdbc:postgresql://db.example.com:5432/mydb?user=dbuser&password=dbpassword

jdbc:postgresql://db.example.com:5432/mydb?user=dbuser&password=dbpassword&ssl=true&sslfactory=org.postgresql.ssl.NonValidatingFactory

jdbc:mysql://db.example.com:3306/mydb?user=dbuser&password=dbpassword

MB_DB_DBNAME

类型：字符串
默认值：null

与 MB_DB_HOST 一起使用的应用程序数据库的数据库名称。

MB_DB_FILE

类型：字符串
默认值: "metabase.db"

H2 数据库文件的位置。 不应包含 .mv.db (或 .h2.db) 文件扩展名。 当 MB_DB_TYPE 设置为 "h2" 时使用。

在从 H2 迁移时也可以使用，以指定应从何处读取现有数据。

MB_DB_HOST

类型：字符串
默认值：null

应用程序数据库的主机名或 IP 地址。 当 MB_DB_TYPE 与 "h2" 不同时使用。

MB_DB_IN_MEMORY

类型：布尔值
默认值：null

用于使用 MB_DB_FILE 进行测试。

MB_DB_PASS

类型：字符串
默认值：null

MB_DB_HOST 的密码。

MB_DB_PORT

类型：整数
默认值：null

MB_DB_HOST 的端口。

MB_DB_TYPE

类型: 字符串 ("h2", "postgres", "mysql")
默认值: "h2"

当 "h2" 时，应用程序数据库从 MB_DB_FILE 加载，否则将使用 MB_DB_HOST 定义应用程序数据库。

MB_DB_USER

类型：字符串
默认值：null

MB_DB_HOST 的用户名。

MB_DEV_ADDITIONAL_DRIVER_MANIFEST_PATHS

类型：字符串
默认值：null

在第三方驱动程序开发期间使用。 设置该值以使该插件清单在启动期间加载。 通过逗号分隔指定多个插件清单。

MB_DISABLE_SCHEDULER

类型：布尔值
默认值：false

当 true 时，Metabase 将关闭 Metabase 的计划作业，其中包括同步、指纹识别和扫描，以及仪表板订阅、警报和模型缓存。

对于测试或设置 基于 Git 的工作流程 可能很有用。

MB_DISABLE_SESSION_THROTTLE

类型：布尔值
默认值：false

当 true 时，这将禁用会话限制。 警告： 不建议禁用限制，因为它是一种防止暴力攻击的保护措施。

使用 MB_SOURCE_ADDRESS_HEADER 从例如反向代理设置远程客户端的 IP 地址。

MB_EMOJI_IN_LOGS

类型：布尔值
默认值：true

日志行上的表情符号。 当设置为 false 时，它将禁用日志行表情符号。 这在 Windows 上被禁用。 与 MB_COLORIZE_LOGS 相关。

MB_ENABLE_TEST_ENDPOINTS

类型：布尔值
默认值：null

当 true 时，这将启用 /api/testing 端点。 警告： 永远不应在生产系统中启用此功能。

MB_ENABLE_XRAYS

类型：布尔值
默认值：true

允许用户使用 X 射线探索数据。

MB_ENCRYPTION_SECRET_KEY

类型：字符串
默认值：null

设置后，这将加密存储在应用程序数据库中的数据库凭据。 要求：至少 16 个字符的 base64 编码字符串。

另请参阅文档页面 静态加密数据库详细信息。

MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS

类型：整数
默认值: 1200
自从: v47.4

Metabase 的查询处理器通常会在查询超时时终止连接，但实际上，某些连接可能会断开，并且 Metabase 无法检测到，即使在查询返回或超时后仍然保持活动状态。 此环境变量告诉 Metabase 在连接没有收到响应时，等待多长时间再终止连接。

此变量会影响 Metabase 未检测到断开的连接（即，在 Metabase 从未收到连接关闭信号并将非活动连接视为活动连接的情况下）。 如果您的连接不可靠或是在 SSH 隧道后面的动态连接，其中从 SSH 隧道主机到数据库的连接可能会在从 SSH 隧道主机到您的数据库的连接断开后仍然保持活动状态，您可能需要调整此变量的值。

除非另行设置，否则使用 metabase.query-processor.query-timeout-ms 的默认生产值，即 1,200,000 毫秒（即 1,200 秒或 20 分钟）。

MB_JDBC_DATA_WAREHOUSE_DEBUG_UNRETURNED_CONNECTION_STACK_TRACES

类型：布尔值
默认值：false
自从: v51.3

如果 true，则记录由于超过 MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS 中指定的超时而终止的任何连接的堆栈跟踪。

为了在日志中查看堆栈跟踪，您还需要通过自定义 log4j 配置将 com.mchange 日志级别更新为 “INFO” 或更高。 有关配置日志级别，请参阅 Metabase 日志配置。

要设置 Metabase 在终止未返回的连接之前应等待多长时间的超时时间，请参阅 MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS。

MB_JETTY_ASYNC_RESPONSE_TIMEOUT

类型：整数
默认值: 600000
自从: v35.0

Jetty 异步线程的超时时间，以毫秒为单位定义。 默认值为 10 分钟。 很少有事情可能会达到该超时时间，因为它们会在之前返回某种类型的数据，但 CSV 下载等可能会达到。

MB_JETTY_DAEMON

类型：布尔值
默认值：false

使用守护程序线程。

MB_JETTY_HOST

类型：字符串
默认值: JAR 为 localhost，Docker 为 0.0.0.0

将主机配置为主机名或 IP 地址，以标识要侦听的特定网络接口。 如果设置为 "0.0.0.0"，Metabase 将侦听所有网络接口。 它将侦听 MB_JETTY_PORT 中指定的端口。

MB_JETTY_JOIN

类型：布尔值
默认值：true

阻止线程直到服务器结束。

MB_JETTY_MAXIDLETIME

类型：整数
默认值: 200000

连接的最大空闲时间，以毫秒为单位。

MB_JETTY_MAXTHREADS

类型：整数
默认值: 50

最大线程数。

如果您注意到常规使用消耗了全部或接近全部线程，请将此值更改为更高的值。 当所有线程都在使用中时，在界面中点击时，Metabase 可能会感觉缓慢或无响应。

要查看正在使用多少线程，请检查 Metabase 日志并查找包含以下内容的行： … Jetty threads: 45/50 …，在这种情况下，这将指示正在使用 50 个可用线程中的 45 个。

相关 MB_ASYNC_QUERY_THREAD_POOL_SIZE。

MB_JETTY_MINTHREADS

类型：整数
默认值：8

最小线程数。

MB_JETTY_PORT

类型：整数
默认值: 3000

配置要用于 HTTP 的端口。 它将侦听 MB_JETTY_HOST 中指定的接口。

MB_JETTY_REQUEST_HEADER_SIZE

类型：整数
默认值: 8192
自从: v36.0

请求标头的最大大小，以字节为单位。 如果您遇到类似 “Request Header Fields Too Large” 的错误，请增加此值。

MB_JETTY_SSL

类型：布尔值
默认值：null

当设置为 true 时，将使用 MB_JETTY_SSL_* 变量中配置的选项启用 HTTPS。

另请参阅 自定义 Jetty Web 服务器 文档页面。

MB_JETTY_SSL_CLIENT_AUTH

类型：布尔值
默认值：null

配置 Java SSL 客户端身份验证。 当设置为 true 时，需要客户端证书，并由 TrustStore 中的证书颁发机构验证。

MB_JETTY_SSL_KEYSTORE

类型：字符串
默认值：null

Java KeyStore 文件的路径。

MB_JETTY_SSL_KEYSTORE_PASSWORD

类型：字符串
默认值：null

Java KeyStore 文件的密码。

MB_JETTY_SSL_PORT

类型：整数
默认值：null

配置要用于 HTTPS 的端口。 它将侦听 MB_JETTY_HOST 中指定的接口。

MB_JETTY_SSL_TRUSTSTORE

类型：字符串
默认值：null

Java TrustStore 文件的路径。

MB_JETTY_SSL_TRUSTSTORE_PASSWORD

类型：字符串
默认值：null

Java TrustStore 文件的密码。

MB_LANDING_PAGE

仅在 Metabase Pro 和 Enterprise 计划中可用。
类型：字符串
默认值: ""

人们登录时显示的默认页面。

MB_LOAD_ANALYTICS_CONTENT

类型: 布尔值
默认值: True

如果您想排除 Metabase 分析 收集，您可以设置 MB_LOAD_ANALYTICS_CONTENT=false。 将此环境变量设置为 false 在迁移环境时也可能派上用场，因为它可以简化迁移过程。

MB_LOAD_SAMPLE_CONTENT

类型: 布尔值
默认值: True

是否在 Metabase 中包含示例数据库。 要排除示例数据库，请设置 MB_LOAD_SAMPLE_CONTENT=false。

MB_NO_SURVEYS

类型：布尔值
默认值：false

Metabase 将向创建了许多问题和仪表板的人发送情绪调查，以衡量该产品在使创建者更容易方面做得如何。

Metabase 仅向过去 2 个月内满足以下条件的人发送这些电子邮件

  • 总共创建了至少 10 个问题
  • 创建了至少 2 个 SQL 问题
  • 创建了至少 1 个仪表板

如果您正在对 Metabase 进行白标化，则这些调查电子邮件将仅发送给符合该条件的实例的管理员。

如果您不希望 Metabase 发送这些电子邮件，请设置 MB_NO_SURVEYS=true。

MB_NS_TRACE

类型：字符串
默认值: ""

要跟踪的逗号分隔的命名空间。 警告： 可能会记录敏感信息，例如数据库密码。

MB_PASSWORD_COMPLEXITY

类型: 字符串 ("weak", "normal", "strong")
默认值: "normal"

强制执行密码复杂性规则，以提高常规登录的安全性。 这仅适用于新用户或正在更改密码的用户。 相关 MB_PASSWORD_LENGTH

  • weak 无字符约束
  • normal 至少 1 个数字
  • strong 最少 8 个字符，包括 2 个小写字母、2 个大写字母、1 个数字和 1 个特殊字符

MB_PASSWORD_LENGTH

类型：整数
默认值: 6

设置最小密码长度以提高常规登录的安全性。 这仅适用于新用户或正在更改密码的用户。 如果未设置，则使用 MB_PASSWORD_COMPLEXITY 的长度。

MB_PLUGINS_DIR

类型：字符串
默认值: "plugins"

“plugins” 目录的路径，该目录用于存储 Metabase 数据库驱动程序。 运行 Metabase 的用户应具有写入该目录的权限。 运行 JAR 时，默认目录为 plugins，在与 JAR 文件相同的位置创建。 运行 Docker 时，默认目录为 /plugins。

该位置是应添加自定义第三方驱动程序的位置。 然后 Metabase 将在启动时加载驱动程序，这可以在日志中验证。

MB_PREMIUM_EMBEDDING_TOKEN

类型：字符串
默认值：null

用于 Pro 和 Enterprise 以在 Enterprise 版本上启用高级功能的许可证令牌。 它也用于 OSS 版本上已弃用的 “高级嵌入” 功能。

MB_QP_CACHE_BACKEND

类型：字符串
默认值: "db"

当前缓存后端。 主要用于测试目的的动态可重新绑定。

MB_SEARCH_TYPEAHEAD_ENABLED

类型：布尔值
默认值：true
自从: v39.0

在使用顶部导航栏中的全局搜索时显示自动建议。

MB_SEND_EMAIL_ON_FIRST_LOGIN_FROM_NEW_DEVICE

类型：布尔值
默认值：true
自从: v39.0

当用户从新设备登录时，向用户发送电子邮件通知。 设置为 false 以停止为所有用户发送 “我们注意到您的 Metabase 帐户上有一个新登录” 电子邮件。

此外，此变量控制 Metabase 用于了解用户登录位置的地理编码服务。 将此变量设置为 false 也会禁用此反向地理编码功能。

MB_SEND_NEW_SSO_USER_ADMIN_EMAIL

仅在 Metabase Pro 和 Enterprise 计划中可用。
类型：布尔值
默认值：true

当在 Metabase 上创建新 SSO 用户时，向 Admin 组中的用户发送电子邮件通知。

MB_SETUP_TOKEN

类型：字符串
默认值：null

一个 UUID 令牌，用于表示实例具有创建初始用户的权限。 这是在 Metabase 首次启动时由第一个实例创建的； 一旦使用，它就会被清除，永远不会再次使用。

MB_SHOW_LIGHTHOUSE_ILLUSTRATION

仅在 Metabase Pro 和 Enterprise 计划中可用。
类型：布尔值
默认值：true
自从: v44.0

在主页和登录页面上显示灯塔插图。

MB_JETTY_SKIP_SNI

类型：字符串
默认值: "true"
自从: v48.4

设置 MB_JETTY_SKIP_SNI=true（默认设置）将关闭 Jetty Web 服务器中的服务器名称指示 (SNI) 检查。 通常，您应该保持启用状态。 但是，如果您在 Metabase 本身终止传输层安全 (TLS) 连接，并且您收到类似 HTTP ERROR 400 Invalid SNI 的错误，请考虑设置 MB_JETTY_SKIP_SNI=false，或使用另一个与服务器域名完全匹配的 SSL 证书。

MB_SOURCE_ADDRESS_HEADER

类型：字符串
默认值: X-Forwarded-For

通过此标头的值（而不是其远程地址）识别 HTTP 请求的来源。 与 MB_DISABLE_SESSION_THROTTLE 相关。

MB_SSL_CERTIFICATE_PUBLIC_KEY

类型：字符串
默认值：null

此站点 SSL 证书的 Base-64 编码公钥。 指定此项以启用 HTTP 公钥固定。 不再建议使用 HPKP。 有关更多信息，请参阅 http://mzl.la/1EnfqBf。

阅读其他 版本的 Metabase 文档。