Silo Console 设置

说明

变更: RELEASE.2025-05-24T17-08-30Z

Console 现在仅提供对象浏览能力，类似于通过 mc 工具可用的能力。对于用户管理等管理类交互，请使用 mc admin 命令。

本页中的部分设置可能已不再适用于较新的部署。

本页介绍用于管理 MinIO Console 访问与行为的设置。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

有些设置只有环境变量或配置项中的一种，而不是两者同时存在。

警告

重要

每个配置项都会控制 MinIO 的基础行为和功能。 MinIO 强烈建议 先在 DEV 或 QA 等较低级别环境中测试配置变更，再应用到生产环境。

浏览器设置

以下设置用于控制内嵌 MinIO Console 的行为。

MinIO Console

可选

`MINIO_BROWSER`

envvar

指定 off 以禁用内嵌 MinIO Console。

此设置没有对应的配置变量。请改用环境变量。

动画

可选

`MINIO_BROWSER_LOGIN_ANIMATION`

envvar

说明

新增: MinIO

Server RELEASE.2023-05-04T21-44-30Z

指定 off 以禁用 MinIO Console 的动画登录界面。默认为 on。

此设置没有对应的配置变量。请改用环境变量。

浏览器重定向

可选

`MINIO_BROWSER_REDIRECT`

envvar

说明

新增: MinIO

Server RELEASE.2023-09-16T01-01-47Z

指定是否将来自 Web 浏览器的请求自动重定向到 Console 地址。默认为 true。

此设置没有对应的配置变量。请改用环境变量。

浏览器重定向 URL

可选

`MINIO_BROWSER_REDIRECT_URL`

envvar

指定 MinIO Console 监听传入连接的 Fully Qualified Domain Name (FQDN)。

如果你希望 MinIO Console 仅通过反向代理服务对外提供，必须指定由该服务管理的主机名。

例如，假设某个反向代理被配置为将 https://example.net/minio/ 路由到 MinIO Console。你必须将此环境变量设置为与该主机名一致，这样 Console 才会使用该主机名进行监听并响应请求。

如果省略此变量，Console 会在运行 MinIO Server 的主机所关联的所有 IP 地址或主机名上监听并响应。

此设置没有对应的配置变量。请改用环境变量。

会话时长

可选

`MINIO_BROWSER_SESSION_DURATION`

envvar

说明

新增: MinIO

Server RELEASE.2023-08-23T10-07-06Z

指定使用 MinIO Console 时浏览器会话的持续时间。

MinIO 支持以下时间单位：

s - 秒，”60s”
m - 分钟，”60m”
h - 小时，”24h”
d - 天，”7d”

默认为 12h。

此设置没有对应的配置变量。请改用环境变量。

日志查询 URL

可选

`MINIO_LOG_QUERY_URL`

envvar

指定 PostgreSQL 服务的 URL，MinIO 会将 Audit logs 写入该服务。内嵌 MinIO Console 提供日志搜索工具，可查询 PostgreSQL 服务中收集的日志。

此设置没有对应的配置变量。请改用环境变量。

内容安全策略

可选

将 MinIO Console 配置为在 HTTP 响应中生成 Content-Security-Policy 头。默认为 default-src 'self' 'unsafe-eval' 'unsafe-inline';

`MINIO_BROWSER_CONTENT_SECURITY_POLICY`

envvar

export MINIO_BROWSER_CONTENT_SECURITY_POLICY="default-src 'self' 'unsafe-eval' 'unsafe-inline';"

`browser csp_policy`

mc-conf

mc admin config set browser \
   csp_policy="default-src 'self' 'unsafe-eval' 'unsafe-inline';" \
   [ARGUMENT=VALUE ...]

严格传输安全

可选

将 MinIO Console 配置为在 HTTP 响应中生成 Strict-Transport-Security 头。

要生成该头，你必须使用 MINIO_BROWSER_HSTS_SECONDS 或 hsts_seconds 设置持续时间。其他 HSTS 设置是可选的。

`MINIO_BROWSER_HSTS_SECONDS`

envvar

已配置策略生效的 max_age（秒）。默认为 0，即禁用。你必须配置非零时长，才能启用 Strict-Transport-Security 头。

export MINIO_BROWSER_HSTS_SECONDS=31536000

`MINIO_BROWSER_HSTS_INCLUDE_SUB_DOMAINS`

envvar

设置为 on 可将已配置的 HSTS 策略同时应用到所有 MinIO Console 子域名。默认为 off。

export MINIO_BROWSER_HSTS_INCLUDE_SUB_DOMAINS="on"

`MINIO_BROWSER_HSTS_PRELOAD`

envvar

设置为 on 可指示客户端浏览器将 MinIO Console 域名加入其 HSTS 预加载列表。默认为 off。

export MINIO_BROWSER_HSTS_PRELOAD="on"

以下配置项需要重启服务后才会生效。要重启服务，请使用 mc admin service restart。

`browser hsts_seconds`

mc-conf

已配置策略生效的 max_age（秒）。默认为 0，即禁用。你必须配置非零时长，才能启用 Strict-Transport-Security 头。

mc admin config set browser \
   hsts_seconds="31536000" \
   [ARGUMENT=VALUE ...]

`browser hsts_include_subdomains`

mc-conf

设置为 on 可将已配置的 HSTS 策略同时应用到所有 MinIO Console 子域名。默认为 off。

mc admin config set browser \
   hsts_include_subdomains="on" \
   hsts_seconds="31536000" \
   [ARGUMENT=VALUE ...]

`browser hsts_preload`

mc-conf

设置为 on 可指示客户端浏览器将 MinIO Console 域名加入其 HSTS 预加载列表。默认为 off。

mc admin config set browser \
   hsts_preload="on" \
   hsts_seconds="31536000" \
   [ARGUMENT=VALUE ...]

示例

以下示例展示了给定配置项对应的渲染后响应头。等价的环境变量会生成相同结果。所有示例均使用 31536000，即一个自然年（365 天）的秒数。

hsts_seconds

mc admin config set ALIAS browser hsts_seconds=31536000

Strict-Transport-Security: max-age=31536000

hsts_include_subdomains

mc admin config set ALIAS browser hsts_seconds=31536000 hsts_include_subdomains=on

Strict-Transport-Security: max-age=31536000; includeSubDomains

hsts_preload

mc admin config set ALIAS browser hsts_seconds=31536000 hsts_include_subdomains=on hsts_preload=on

Strict-Transport-Security: max-age=31536000; includeSubDomains; preload

来源策略

可选

将 MinIO Console 配置为在 HTTP 响应中生成 Referrer-Policy 头。默认为 strict-origin-when-cross-origin。

`MINIO_BROWSER_REFERRER_POLICY`

envvar

export MINIO_BROWSER_REFERRER_POLICY="strict-origin-when-cross-origin"

`browser referrer_policy`

mc-conf

mc admin config set browser \
   referrer_policy="strict-origin-when-cross-origin" \
   [ARGUMENT=VALUE ...]

Prometheus 设置

以下设置用于管理 MinIO 与你的 Prometheus 服务之间的交互方式。

Prometheus URL

可选

`MINIO_PROMETHEUS_URL`

envvar

指定已配置为抓取 MinIO 指标的 Prometheus 服务 URL。

MinIO Console 使用 minio-job Prometheus 抓取作业，将集群指标填充到 Dashboard。

如果你使用独立的 MinIO Console 进程，则该变量对应 CONSOLE_PROMETHEUS_URL。

此设置没有对应的配置变量。请改用环境变量。

Prometheus Job ID

可选

`MINIO_PROMETHEUS_JOB_ID`

envvar

指定用于抓取 MinIO 指标的自定义 Prometheus job ID。

MinIO 默认为 minio-job。

如果你使用独立的 MinIO Console 进程，则该变量对应 CONSOLE_PROMETHEUS_JOB_ID。

此设置没有对应的配置变量。请改用环境变量。

Prometheus Auth Token

可选

`MINIO_PROMETHEUS_AUTH_TOKEN`

envvar

指定 Console 连接 Prometheus 服务时应使用的 basic auth token。

例如，你使用的 basic auth token 可能如下所示：

eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJwcm9tZXRoZXVzIiwic3ViIjoibWluaW8iLCJleHAiOjQ4NTAwMzg0MDJ9.GZCKR3d0FH2TCvNHSd39HaVfSuQVVV0s8glICBDmhT51V6CQ_hw8gTYlKHJmcpR8aHkqiJwCqcYJhaMmqwe00XY

如果你使用独立的 MinIO Console 进程，则该变量对应 CONSOLE_PROMETHEUS_AUTH_TOKEN。

此设置没有对应的配置变量。请改用环境变量。

加载评论需要启用 JavaScript。在 GitHub 上查看讨论。