环境变量
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 -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
环境变量列表
MAX_SESSION_AGE
MB_ADMIN_EMAIL
-
类型:string
-
默认值:null
如果用户遇到问题,可以向此邮件地址发送详细问题。
MB_ANON_TRACKING_ENABLED
-
类型:bool
-
默认值:true
启用匿名数据采集,帮助metabase完善产品
MB_API_KEY
MB_APPLICATION_COLORS (商业版支持)
MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE(从v0.35版本开始支持)
MB_APPLICATION_FAVICON_URL(商业版支持)
MB_APPLICATION_FONT(商业版支持)
-
类型:字符串
-
默认值:"Lato"
自定义metabase的字体
MB_APPLICATION_FONT_FILES(商业版支持)
[
{
"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(商业版支持)
MB_APPLICATION_NAME(商业版支持)
MB_ASYNC_QUERY_THREAD_POOL_SIZE(从v0.35开始支持)
MB_BREAKOUT_BIN_WIDTH
MB_BREAKOUT_BINS_NUM
MB_CHECK_FOR_UPDATES
-
类型:bool
-
默认值:true
检查metabase是否有新版发布。
MB_COLORIZE_LOGS
MB_CUSTOM_FORMATTING
-
类型:string
-
默认值:"{}"
值为json对象,它包含格式化的配置
MB_CUSTOM_GEOJSON
MB_CUSTOM_GEOJSON_ENABLED
-
类型:bool
-
默认值:true
是否启用了自定义 GeoJSON
MB_DB_AUTOMIGRATE
当设置为 false 时,Metabase 将打印需要在应用程序数据库中完成的迁移并退出,这些迁移需要手动应用。当为 true 时,Metabase 将自动对应用程序数据库进行更改。 这个配置与从 H2 迁移无关。
MB_DB_CONNECTION_TIMEOUT_MS
-
类型:int
-
默认值:5000
数据库连接超时时间,单位为ms
MB_DB_CONNECTION_URI
#eg:
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
MB_DB_FILE
-
类型:string
-
默认值:"metabase.db"
指定H2数据库的名称
MB_DB_HOST
MB_DB_IN_MEMORY
-
类型:bool
-
默认值:null
用于测试MB_DB_FILE.
MB_DB_PASS
MB_DB_PORT
-
类型:整数
-
默认值:null
metabase应用数据库的端口
MB_DB_TYPE
MB_DB_USER
-
类型:string
-
默认值:null
metabase应用数据库的用户名
MB_DEV_ADDITIONAL_DRIVER_MANIFEST_PATHS
MB_DISABLE_SESSION_THROTTLE
用MB_SOURCE_ADDRESS_HEADER从反向代理设置远程客户端的 IP 地址。
MB_EMAIL_FROM_ADDRESS
MB_EMAIL_FROM_NAME(从v0.44开始支持)
MB_EMAIL_REPLY_TO
MB_EMAIL_SMTP_HOST
-
类型:string
-
默认值:null
处理电子邮件的 SMTP 服务器的地址。
MB_EMAIL_SMTP_PASSWORD
-
类型:string
-
默认值:null
发件邮箱的密码。
MB_EMAIL_SMTP_PORT
-
类型:int
-
默认值:null
SMTP 服务器端口。
MB_EMAIL_SMTP_SECURITY
MB_EMAIL_SMTP_USERNAME
-
类型:string
-
默认值:null
发件邮箱用户名(国内一般为发件邮箱地址)。
MB_EMBEDDING_APP_ORIGIN(商业版支持)
-
类型:string
-
默认值:null
允许将metabase完整嵌入的页面地址
MB_EMBEDDING_SECRET_KEY(从v0.44开始支持)
MB_EMOJI_IN_LOGS
MB_ENABLE_EMBEDDING
MB_ENABLE_NESTED_QUERIES
-
类型:bool
-
默认值:true
允许使用保存的问题作为其他查询的来源。
MB_ENABLE_PASSWORD_LOGIN(商业版支持)
MB_ENABLE_PUBLIC_SHARING
MB_ENABLE_QUERY_CACHING
-
类型:bool
-
默认值:false
启用缓存将保存查询耗时比较长的查询的结果。
MB_ENABLE_TEST_ENDPOINTS
MB_ENABLE_XRAYS
-
类型:bool
-
默认值:true
允许用户使用 X 射线浏览数据。
MB_ENCRYPTION_SECRET_KEY
MB_GOOGLE_AUTH_AUTO_CREATE_ACCOUNTS_DOMAIN
MB_GOOGLE_AUTH_CLIENT_ID
MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE(自v0.35开始启用)
MB_JETTY_ASYNC_RESPONSE_TIMEOUT(自v0.35开始启用)
MB_JETTY_DAEMON
-
类型:bool
-
默认值:false
使用守护程序线程。
MB_JETTY_HOST
- 类型:string
- 默认:对于JAR为'localhost',对于Docker为'0.0.0.0'
配置Jetty的监听地址
MB_JETTY_JOIN
MB_JETTY_MAXIDLETIME
-
类型:int
-
默认值:200000
连接最长空闲时间(单位ms)。
MB_JETTY_MAXQUEUED
-
类型:int
-
默认值:"FIX ME"
所有线程都繁忙时要排队的最大请求数。
MB_JETTY_MAXTHREADS
MB_JETTY_MINTHREADS
MB_JETTY_PORT
MB_JETTY_REQUEST_HEADER_SIZE(从v0.36开始支持)
MB_JETTY_SSL
MB_JETTY_SSL_CLIENT_AUTH
MB_JETTY_SSL_KEYSTORE
-
类型:string
-
默认值:null
Java TrustStore 文件的路径。
MB_JETTY_SSL_KEYSTORE_PASSWORD
-
类型:string
-
默认值:null
Java TrustStore 文件的密码。
MB_JETTY_SSL_PORT
-
类型:int
-
默认值:null
配置用于 HTTPS 的端口。
MB_JETTY_SSL_TRUSTSTORE
-
类型:string
-
默认值:null
Java TrustStore 文件的路径。
MB_JETTY_SSL_TRUSTSTORE_PASSWORD
-
类型:string
-
默认值:null
Java TrustStore 文件的密码。
MB_JWT_ATTRIBUTE_EMAIL(商业版支持)
-
类型:string
-
默认值:"email"
JWT信息里电子邮件地址对应的key。
MB_JWT_ATTRIBUTE_FIRSTNAME(商业版支持)
MB_JWT_ATTRIBUTE_GROUPS(商业版支持)
-
类型:string
-
默认值:"groups"
JWT信息里 group 对应的key。
MB_JWT_ATTRIBUTE_LASTNAME(商业版支持)
-
类型:string
-
默认值:"last_name"
JWT信息里 group 对应的key。
MB_JWT_ENABLED(商业版支持)
MB_JWT_GROUP_MAPPINGS(商业版支持)
MB_JWT_GROUP_SYNC(商业版支持)
-
类型:bool
-
默认值:false
启用与 JWT 认证的gruop信息同步。
MB_JWT_IDENTITY_PROVIDER_URI(商业版支持)
-
类型:string
-
默认值:null
基于 JWT 的登录页面的 URL。
MB_JWT_SHARED_SECRET(商业版支持)
-
类型:string
-
默认值:null
为用于验证 JWT 消息的私钥设定种子的字符串。
MB_LANDING_PAGE(商业版支持)
MB_LDAP_ATTRIBUTE_EMAIL
-
类型:string
-
默认值:"mail"
用于用户电子邮件的属性。
MB_LDAP_ATTRIBUTE_FIRSTNAME
-
类型:string
-
默认值:"givenName"
用于用户名字的属性。
MB_LDAP_ATTRIBUTE_LASTNAME
-
类型:string
-
默认值:"sn"
用于用户姓氏的属性。
MB_LDAP_BIND_DN
-
类型:string
-
默认值:null
要绑定的LDAP DN。
MB_LDAP_ENABLED
-
类型:bool
-
默认值:false
是否开启LDAP认证
MB_LDAP_GROUP_BASE
MB_LDAP_GROUP_MAPPINGS
MB_LDAP_GROUP_MEMBERSHIP_FILTER(商业版支持)
MB_LDAP_GROUP_SYNC
-
类型:bool
-
默认值:false
启用与 LDAP 的group成员身份同步。
MB_LDAP_HOST
-
类型:string
-
默认值:null
LDAP服务器主机域名或ip。
MB_LDAP_PASSWORD
-
类型:string
-
默认值:null
查找用户要绑定的密码。
MB_LDAP_PORT
MB_LDAP_SECURITY
MB_LDAP_SYNC_USER_ATTRIBUTES(商业版支持)
-
类型:bool
-
默认值:true
当有人通过 LDAP 登录时同步用户属性。
MB_LDAP_SYNC_USER_ATTRIBUTES_BLACKLIST(商业版支持)
-
类型:string
-
默认值:"userPassword,dn,distinguishedName"
LDAP 用户的同步忽略的属性,以逗号分隔的用户属性列表。
MB_LDAP_USER_BASE
-
类型:string
-
默认值:null
用户的搜索库。(将以递归方式搜索。)
MB_LDAP_USER_FILTER
MB_LOADING_MESSAGE(商业版支持)
-
类型:string
-
默认值:''
在等待数据加载时更改加载消息。
MB_MAP_TILE_SERVER_URL
MB_NATIVE_QUERY_AUTOCOMPLETE_MATCH_STYLE
MB_NOTIFICATION_LINK_BASE_URL(商业版支持)
MB_NOTIFICATION_RETRY_INITIAL_INTERVAL
-
类型:int
-
默认值:500
发送通知时的初始重试间隔时间(以毫秒为单位)。
MB_NOTIFICATION_RETRY_MAX_ATTEMPTS
-
类型:int
-
默认值:7
发送单个通知的最大重试次数。
MB_NOTIFICATION_RETRY_MAX_INTERVAL_MILLIS
-
类型:int
-
默认值:30000
尝试发送单个通知之间的最大时间间隔。
MB_NOTIFICATION_RETRY_MULTIPLIER
- 类型:double
- 默认:2.0
尝试发送单个通知之间的间隔乘数。
MB_NOTIFICATION_RETRY_RANDOMIZATION_FACTOR
- 类型:double
- 默认:0.1
发送通知时重试间隔的随机化因子。
MB_NS_TRACE
MB_PASSWORD_COMPLEXITY
MB_PASSWORD_LENGTH
**MB_PERSISTED_MODEL_REFRESH_CRON_SCHEDULE
MB_PERSISTED_MODELS_ENABLED
-
类型:bool
-
默认值:false
允许将模型保存到源数据库中。
MB_PLUGINS_DIR
MB_PREMIUM_EMBEDDING_TOKEN
MB_QP_CACHE_BACKEND
-
类型:string
-
默认值:"db"
当前缓存后端。可动态重新绑定,主要用于测试目的。
MB_QUERY_CACHING_MAX_KB
-
类型:int
-
默认值:1000
每个查询缓存的最大大小(以 KB 为单位)。
MB_QUERY_CACHING_MAX_TTL
MB_QUERY_CACHING_MIN_TTL
MB_QUERY_CACHING_TTL_RATIO
MB_REDIRECT_ALL_REQUESTS_TO_HTTPS
MB_REPORT_TIMEZONE
-
类型:string
-
默认值:null
执行查询时要使用的时区。默认为系统时区。
MB_SAML_APPLICATION_NAME(商业版支持)
-
类型:string
-
默认值:"Metabase"
此应用名称将用于对身份认证程序的请求。
MB_SAML_ATTRIBUTE_EMAIL(商业版支持)
MB_SAML_ATTRIBUTE_FIRSTNAME(商业版支持)
MB_SAML_ATTRIBUTE_GROUP(商业版支持)
-
类型:string
-
默认值:"member_of"
用于同步group的 SAML 属性。
MB_SAML_ATTRIBUTE_LASTNAME(商业版支持)
MB_SAML_ENABLED(商业版支持)
-
类型:bool
-
默认值:false
是否开启SAML身份验证
MB_SAML_GROUP_MAPPINGS(商业版支持)
MB_SAML_GROUP_SYNC(商业版支持)
-
类型:bool
-
默认值:false
启用与 SAML 的 group 成员身份同步。
MB_SAML_IDENTITY_PROVIDER_CERTIFICATE(商业版支持)
-
类型:string
-
默认值:null
SAML认证证书,写证书内容,而不是证书路径
MB_SAML_IDENTITY_PROVIDER_ISSUER(商业版支持)
MB_SAML_IDENTITY_PROVIDER_URI (商业版支持)
MB_SAML_KEYSTORE_ALIAS(商业版支持)
MB_SAML_KEYSTORE_PASSWORD(商业版支持)
-
类型:string
-
默认值:"changeit"
用于打开keystore的密码。
MB_SAML_KEYSTORE_PATH(商业版支持)
MB_SEARCH_TYPEAHEAD_ENABLED
-
类型:bool
-
默认值:true
在顶部导航栏中使用全局搜索时显示自动建议。
MB_SEND_EMAIL_ON_FIRST_LOGIN_FROM_NEW_DEVICE
MB_SEND_NEW_SSO_USER_ADMIN_EMAIL(商业版支持)
MB_SESSION_COOKIE_SAMESITE(商业版支持)
当使用 FullApp 嵌入, 并且嵌入到的页面域名与metabase实例的域名不在同一个主域名下,你就需要调整这个配置。具体配置参考https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite
MB_SESSION_COOKIES
MB_SESSION_TIMEOUT(商业版支持)
MB_SHOW_DATABASE_SYNCING_MODAL
MB_SHOW_HOMEPAGE_DATA
MB_SHOW_HOMEPAGE_XRAYS
-
类型:bool
-
默认值:null
是否隐藏xray功能
MB_SHOW_LIGHTHOUSE_ILLUSTRATION(商业版支持)
-
类型:string
-
默认值:true
在主页和登录页面上是否显示灯塔插图。
MB_SHOW_METABOT(商业版支持)
-
类型:bool
-
默认值:true
在主页上显示 MetaBot 字符。
MB_SITE_LOCALE
-
类型:string
-
默认值:"en"
设置metabase的默认语言。
MB_SITE_NAME
-
类型:string
-
默认值:"Metabase"
设置 metabase 实例名称
MB_SITE_URL
MB_SOURCE_ADDRESS_HEADER
MB_SQL_JDBC_FETCH_SIZE
MB_SSH_HEARTBEAT_INTERVAL_SEC
MB_SSL_CERTIFICATE_PUBLIC_KEY
MB_START_OF_WEEK
MB_SUBSCRIPTION_ALLOWED_DOMAINS(商业版支持)