Silo 服务端（minio）

• 1: 设置概览
  • 1.1: 核心设置
  • 1.2: Root 访问设置
  • 1.3: 纠删码设置
  • 1.4: Silo Console 设置
  • 1.5: 指标与日志设置
  • 1.6: 存储桶通知设置
    • 1.6.1: AMQP 通知设置
    • 1.6.2: Elasticsearch 通知设置
    • 1.6.3: Kafka 通知设置
    • 1.6.4: MQTT 通知设置
    • 1.6.5: MySQL 通知设置
    • 1.6.6: NATS 通知设置
    • 1.6.7: NSQ 通知设置
    • 1.6.8: PostgreSQL 通知设置
    • 1.6.9: Redis 通知设置
    • 1.6.10: Webhook 服务通知设置
  • 1.7: 身份与访问管理设置
    • 1.7.1: Active Directory / LDAP 设置
    • 1.7.2: OpenID 身份管理设置
    • 1.7.3: Silo 身份管理插件设置
    • 1.7.4: Silo 访问管理插件设置
  • 1.8: ILM 设置
  • 1.9: 密钥加密服务设置
  • 1.10: Object Lambda 函数设置
  • 1.11: 已弃用设置

minio server /mnt/disk{1...4}

minio server [FLAGS] HOSTNAME/DIRECTORIES [HOSTNAME/DIRECTORIES..]

127.0.1.1       minioip
127.0.1.2       minioip

minio server --address "minioip:9000" ~/miniodirectory

minio server http://server{1...4}/disk{1...4} \
--ftp="address=:8021"                         \
--ftp="passive-port-range=30000-40000"        \
--ftp="tls-private-key=path/to/private.key"   \
--ftp="tls-public-cert=path/to/public.crt"    \
...

ssh-ed25519
[email protected]
[email protected]
ecdsa-sha2-nistp256
ecdsa-sha2-nistp384
ecdsa-sha2-nistp521
rsa-sha2-256
rsa-sha2-512
ssh-rsa
ssh-dss

curve25519-sha256
[email protected]
ecdh-sha2-nistp256
ecdh-sha2-nistp384
ecdh-sha2-nistp521
diffie-hellman-group14-sha256
diffie-hellman-group16-sha512
diffie-hellman-group14-sha1
diffie-hellman-group1-sha1

aes128-ctr
aes192-ctr
aes256-ctr
[email protected]
[email protected]
[email protected]
arcfour256
arcfour128
arcfour
aes128-cbc
3des-cbc

[email protected]
[email protected]
hmac-sha2-256
hmac-sha2-512
hmac-sha1
hmac-sha1-96

minio server http://server{1...4}/disk{1...4}                                 \
--sftp="address=:8022" --sftp="ssh-private-key=/home/miniouser/.ssh/id_rsa"   \
--sftp="kex-algos=diffie-hellman-group14-sha256,[email protected]" \
...

/etc/minio
  private.key
  public.crt
  domain.tld/
    private.key
    public.crt
  CAs/
    full-chain-ca.crt

1 - 设置概览

minio server 进程将其配置存储在存储后端 directory 中。

MinIO 设置

MinIO 设置定义 MinIO server 进程的运行时行为。

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

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

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

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

其他可用于自定义的设置包括：

• 核心设置
• Root 凭证
• 存储类
• MinIO Console
• 指标与日志
• 用于 MinIO 存储桶通知 的 通知目标
• 身份与访问管理方案
• Key Encryption Service (KES)
• Object Lambda 函数

1.1 - 核心设置

本页介绍用于控制 MinIO 进程核心行为的设置。

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

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

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

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

MinIO Server CLI 选项

可选

设置一个 参数 字符串，在启动 MinIO Server 时使用。

对于采用推荐 MinIO systemd 服务的类 Unix 系统，请使用 /etc/default/minio 文件并创建环境变量 MINIO_OPTS，用于指定要附加到 minio systemd 进程的参数：

# Editing /etc/default/minio

MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

对于在命令行运行 minio 的系统，MINIO_OPTS 是可选项。 如需使用，请按标准 shell 语义声明该环境变量，然后在启动 MinIO Server 时引用该环境变量：

export MINIO_OPTS=' --console-address=":9001" --ftp="address=:8021" --ftp="passive-port-range=30000-40000" '

minio server $MINIO_OPTS ...

# The above is equivalent to running the following:
# minio server --console-address=":9001" \
#              --ftp="address=:8021"     \
#              --ftp="passive-port-range=30000-40000"

存储卷

环境变量文件路径

过期处理工作线程

域名

扫描器速度

用于在平衡 MinIO 读写性能与扫描进程时，管理 scanner 的最大等待周期。

MinIO 使用 scanner 执行 存储桶复制、 站点复制、 生命周期管理 和 自愈 任务。

有效值包括：

批量复制

数据压缩

以下部分记录用于为对象启用数据压缩的设置。 有关如何使用这些配置设置的教程，请参见 数据压缩。

本节中的所有设置都归属于以下顶层键：

compression

mc-conf

启用压缩

可选

设置为 on 以对新对象启用数据压缩。 默认为 off。

启用或禁用数据压缩不会更改现有对象。

允许加密

可选

设置为 on 以在压缩后对对象进行加密。 默认为 off。

压缩扩展名

可选

要压缩的文件扩展名列表，以逗号分隔。 设置新的扩展名列表会替换先前已配置的列表。 默认为 ".txt, .log, .csv, .json, .tar, .xml, .bin"。

即使在此参数中显式指定，MinIO 也不支持压缩 Excluded File Types 列表中的文件类型。

压缩 MIME 类型

可选

要压缩的 MIME 类型列表，以逗号分隔。 设置新的类型列表会替换先前已配置的列表。 默认为 "text/*, application/json, application/xml, binary/octet-stream"。

注释

可选

指定一个与数据压缩配置关联的注释。

纠删码条带大小

可选

应用于指定 服务器池 中所有驱动器的 erasure set size。

如果设置此值，你 必须 在初始化集群 之前 完成设置。 集群初始化后，所选条带大小为 不可变，并会影响后续添加到集群中的所有 服务器池。

MinIO SUBNET 用户应先登录并提交 issue，讨论条带大小设置后再在任何环境中实施。

最大对象版本数

可选

定义每个对象允许的默认最大版本数。

默认情况下，MinIO 允许每个对象的版本数最高达到 Int64 的最大值，即超过 9.2 quintillion。

为对象设置任意高的版本数可能导致某些操作（如 LIST）性能下降。 在使用低成本硬件或机械硬盘（HDD）的系统上，这一点尤为明显。 对于每个对象会生成数千个或更多版本的应用或工作负载，可能需要进行设计或架构评审，以缓解潜在的性能下降。

将上限设置为不超过 100，通常可满足大多数常见使用场景。

客户端源地址信任

旧版存储桶资源匹配

1.2 - Root 访问设置

本页介绍用于控制 MinIO 进程 root（超级用户）访问权限的设置。 root 用户具有完整访问权限，可在 MinIO 部署上执行操作。

即使使用 MinIO Key Encryption Service 或其他密钥管理工具，也必须配置 Root User 和 Root Password。

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

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

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

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

Root User

Root Password

Root 访问

设置为 on 可启用 root 用户账号，设置为 off 可禁用该账号。 禁用 root 服务账户时，也会禁用所有与 root 关联的服务账户，但用于站点复制的账号除外。 默认值为 on。

在禁用 root 账号之前，请确保至少存在一个其他管理员用户，例如具备 consoleAdmin 策略的用户。 如果没有其他管理员用户，禁用 root 账号会导致该部署的管理访问被锁定。

你可以使用此变量临时覆盖配置项，重新启用对部署的 root 访问。

如果发生意外锁定，要进行重置，请将 MINIO_API_ROOT_ACCESS 设为 on 以覆盖此设置，并临时重新启用 root 账号。 随后你可以将此设置改为 on，或 完成必要的用户/策略调整，以确保可通过其他非 root 账号进行正常管理访问。

唯一 Root 凭证

1.3 - 纠删码设置

本页介绍用于配置写入 MinIO 集群对象时所使用 纠删码 校验 的相关设置。 这会影响 MinIO 如何使用驱动器空间，以及 MinIO 如何在驱动器丢失或类似问题发生时恢复已存储对象。

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

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

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

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

标准存储类

该部署的 parity level。 MinIO 会使用该校验值对采用默认 STANDARD 存储类写入的对象进行分片。

MinIO 会参考请求元数据中的 x-amz-storage-class 头，以确定应为对象分配哪个存储类。 设置该头的具体语法或方式取决于与 MinIO 服务器交互时所使用的方法。

请使用 EC:M 记法指定该值，其中 M 表示要为对象创建的校验块数量。

下表列出了基于部署中初始服务器池 erasure set size 的默认值：

支持的最小值是 0，表示不提供纠删码保护。 此类部署的可用性/韧性完全依赖底层存储控制器或存储资源。

最大值取决于部署中初始服务器池的纠删集合大小，其上限为 $\frac{\text{ERASURE\_SET\_SIZE}}{2}$。 例如，纠删集合条带大小为 16 的部署，其标准校验最大值为 8。

可在启动后将该值更改为 0 与该纠删集合大小上限之间的任意值。 MinIO 只会将变更后的校验值应用于新写入对象。 现有对象会保留其创建时的校验值。

降低冗余存储类

用于以 REDUCED 存储类写入对象的 parity level。

MinIO 会参考请求元数据中的 x-amz-storage-class 头，以确定应为对象分配哪个存储类。 设置该头的具体语法或方式取决于与 MinIO 服务器交互时所使用的方法。

请使用 EC:M 记法指定该值，其中 M 表示要为对象创建的校验块数量。

该值 必须 小于或等于 MINIO_STORAGE_CLASS_STANDARD。

对于纠删集合大小小于 2 的部署，不能设置此值。 纠删集合大小大于 1 的部署默认值为 EC:1。 纠删集合大小为 1 的部署默认值为 EC:0。

校验保留优化

默认情况下，如果目标纠删集合维持写入法定人数（write quorum）但 有一个或多个驱动器离线，MinIO 会自动“升级”对象的校验。 该行为有助于确保给定对象与写入健康纠删集合的对象保持相同可用性。

将该设置指定为 capacity，可指示 MinIO 不为对象创建任何额外校验。 这会优先保障集群总体容量，但代价是当该纠删集合中更多驱动器故障时，对象可用性可能降低。

注释

为存储类设置添加注释。

1.4 - Silo Console 设置

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

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

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

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

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

浏览器设置

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

MinIO Console

可选

动画

可选

浏览器重定向

可选

浏览器重定向 URL

可选

会话时长

可选

日志查询 URL

可选

内容安全策略

可选

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

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

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 设置是可选的。

export MINIO_BROWSER_HSTS_SECONDS=31536000

export MINIO_BROWSER_HSTS_INCLUDE_SUB_DOMAINS="on"

export MINIO_BROWSER_HSTS_PRELOAD="on"

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

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

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。

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

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

Prometheus 设置

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

Prometheus URL

可选

Prometheus Job ID

可选

Prometheus Auth Token

可选

eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJwcm9tZXRoZXVzIiwic3ViIjoibWluaW8iLCJleHAiOjQ4NTAwMzg0MDJ9.GZCKR3d0FH2TCvNHSd39HaVfSuQVVV0s8glICBDmhT51V6CQ_hw8gTYlKHJmcpR8aHkqiJwCqcYJhaMmqwe00XY

1.5 - 指标与日志设置

本页面介绍用于控制 MinIO 指标与日志相关行为的设置。 更多信息请参见 指标与告警。

这些设置用于将常规 minio server 日志和审计日志发布到 HTTP webhook。 更完整的文档请参见 将服务日志或审计日志发布到外部服务。

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

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

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

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

• 服务器日志
• Webhook 审计日志
• Kafka 审计日志

Prometheus 认证

此设置控制 MinIO 如何向 Prometheus 进行认证。

指定 Prometheus 抓取端点 的认证模式。

• jwt - 默认 MinIO 要求抓取客户端提供 JWT token 以认证请求。

  使用 mc admin prometheus generate 生成所需的 JWT bearer token。

• public MinIO 不要求抓取客户端对其请求进行认证。

服务器日志

以下部分介绍将 minio server 日志发布到 HTTP webhook 端点的 MinIO 配置设置。 有关这些设置的更完整文档和使用教程，请参见 将服务日志发布到 HTTP Webhook。

定义多个端点

你可以通过为每组相关日志环境变量追加唯一标识符 _ID，将多个 webhook 端点指定为日志目标。 例如，以下设置定义了两个不同的服务器日志 webhook 端点：

export MINIO_LOGGER_WEBHOOK_ENABLE_PRIMARY="on"
export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_PRIMARY="TOKEN"
export MINIO_LOGGER_WEBHOOK_ENDPOINT_PRIMARY="http://webhook-1.example.net"

export MINIO_LOGGER_WEBHOOK_ENABLE_SECONDARY="on"
export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_SECONDARY="TOKEN"
export MINIO_LOGGER_WEBHOOK_ENDPOINT_SECONDARY="http://webhook-2.example.net"

mc admin config set logger_webhook:primary \
   endpoint="http://webhook-01.example.net" [ARGUMENTS=VALUE ...]

mc admin config set logger_webhook:secondary \
   endpoint="http://webhook-02.example.net" [ARGUMENTS=VALUE ...]

设置

Enable

端点

必填

webhook 的 HTTP 端点。

认证 Token

可选

export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"

export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"

   mc admin config set myminio logger_webhook   \
      endpoint="https://webhook-1.example.net"  \
      auth_token="Bearer 1a2b3c4f5e"

   mc admin config set myminio logger_webhook   \
      endpoint="https://webhook-1.example.net"  \
      auth_token="ServiceXYZ 1a2b3c4f5e"

批大小

可选

按批次收集并发送指定数量的事件到 webhook。 如果未设置，MinIO 每个请求发送一个事件。

客户端证书

可选

还需要同时设置 Client Key。

用于向 webhook logger 认证的 mTLS 证书路径。

客户端密钥

可选

如果定义了 Client Certificate，则为必填。

用于向 webhook logger 服务认证的 mTLS 证书密钥路径。

代理

可选

定义在 MinIO 与外部 webhook 通信时供 webhook logger 使用的代理。

队列目录

可选

指定目录路径（例如 /opt/minio/events）以启用 MinIO 对未投递消息的持久事件存储。 MinIO 进程必须对指定目录具有读取、写入和列举权限。

当 webhook 服务离线时，MinIO 会将未投递事件存储到指定存储中，并在连接恢复后回放这些事件。

队列大小

可选

用于 logger webhook 目标队列大小的整数值。

Webhook 审计日志

以下部分介绍用于将审计日志发布到 HTTP webhook 端点的 MinIO 环境变量。 有关这些环境变量的更完整文档和使用教程，请参见 将审计日志发布到 HTTP Webhook。

多个目标

你可以通过为每组相关日志设置追加唯一标识符 _ID，将多个 webhook 端点指定为审计日志目标。

例如，以下命令设置了两个不同的审计日志 webhook 端点：

export MINIO_AUDIT_WEBHOOK_ENABLE_PRIMARY="on"
export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_PRIMARY="TOKEN"
export MINIO_AUDIT_WEBHOOK_ENDPOINT_PRIMARY="http://webhook-1.example.net"
export MINIO_AUDIT_WEBHOOK_CLIENT_CERT_SECONDARY="/tmp/cert.pem"
export MINIO_AUDIT_WEBHOOK_CLIENT_KEY_SECONDARY="/tmp/key.pem"

export MINIO_AUDIT_WEBHOOK_ENABLE_SECONDARY="on"
export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_SECONDARY="TOKEN"
export MINIO_AUDIT_WEBHOOK_ENDPOINT_SECONDARY="http://webhook-1.example.net"
export MINIO_AUDIT_WEBHOOK_CLIENT_CERT_SECONDARY="/tmp/cert.pem"
export MINIO_AUDIT_WEBHOOK_CLIENT_KEY_SECONDARY="/tmp/key.pem"

mc admin config set audit_webhook \
   endpoint="http://webhook.example.net" [ARGUMENTS=VALUE ...]

mc admin config set audit_webhook:primary \
   endpoint="http://webhook-01.example.net" [ARGUMENTS=VALUE ...]


mc admin config set audit_webhook:secondary \
   endpoint="http://webhook-02.example.net" [ARGUMENTS=VALUE ...]

设置

Enable

端点

必填

webhook 的 HTTP 端点。

认证 Token

可选

端点所需类型的认证 token。 对于不需要认证的端点可省略。

为支持多种 token 类型，MinIO 会使用 完全按原样指定 的值构造请求认证头。 具体端点可能要求你附加额外信息。

export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"

export MINIO_AUDIT_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"

mc admin config set myminio audit_webhook       \
         endpoint="http://webhook.example.net"  \
         auth_token="Bearer 1a2b3c4f5e"

mc admin config set myminio audit_webhook       \
         endpoint="http://webhook.example.net"  \
         auth_token="ServiceXYZ 1a2b3c4f5e"

详情请参阅目标服务的文档。

批大小

可选

按批次收集并发送指定数量的事件到 webhook。 如果未设置，MinIO 每个请求发送一个事件。

客户端证书

可选

提交给 HTTP webhook 的 x.509 客户端证书。 对于不要求客户端提供已知 TLS 证书的 webhook 可省略。

客户端密钥

可选

提交给 HTTP webhook 的 x.509 私钥。 对于不要求客户端提供已知 TLS 证书的 webhook 可省略。

队列目录

可选

指定目录路径（例如 /opt/minio/events）以启用 MinIO 对未投递消息的持久事件存储。 MinIO 进程必须对指定目录具有读取、写入和列举权限。

当 webhook 服务离线时，MinIO 会将未投递事件存储到指定存储中，并在连接恢复后回放这些事件。

队列大小

可选

用于 audit webhook 目标队列大小的整数值。 默认值为 100000 个事件。

Kafka 审计日志

以下部分介绍用于将审计日志发布到 Kafka broker 的 MinIO 环境变量。

audit_kafka

mc-conf

用于定义 Kafka broker 目标并发布 MinIO audit logs 的顶层配置键。

使用 mc admin config set 设置或更新 Kafka 审计目标。 以空格（" "）分隔列表的形式指定其他可选参数。

mc admin config set audit_kafka \
   brokers="https://kafka-endpoint.example.net:9092" [ARGUMENTS=VALUE ...]

设置

Enable

必填

Brokers

必填

Kafka broker 地址的逗号分隔列表：

brokers="https://kafka-1.example.net:9092,https://kafka-2.example.net:9092"

至少必须有一个 broker 在线且 MinIO server 可达，才能初始化并发送审计日志事件。 MinIO 会按指定顺序检查每个 broker。

Topic

必填

与 MinIO 审计日志事件关联的 Kafka topic 名称。

TLS

可选

设置为 "on" 以启用到指定 Kafka brokers 的 TLS 连接。

默认值为 "off"。

TLS Skip Verify

可选

设置为 "on" 以指示 MinIO 跳过对 Kafka broker TLS 证书的校验。

你可以使用该选项连接使用未知签发方 TLS 证书的 Kafka brokers，例如自签名证书或企业内部 CA（Certificate Authorities）签发的证书。

默认情况下，MinIO 会同时使用系统信任库 以及 MinIO CA directory 中的内容来校验远端客户端 TLS 证书。

默认值为 "off"，即严格校验 TLS 证书。

SASL

可选

设置为 "on" 以指示 MinIO 使用 SASL 对 Kafka brokers 进行认证。

SASL Username

可选

MinIO 用于对 Kafka brokers 进行认证的 SASL 用户名。

SASL Password

可选

MinIO 用于对 Kafka brokers 进行认证的 SASL 密码。

SASL Mechanism

可选

MinIO 用于对 Kafka brokers 进行认证的 SASL 机制。

默认值为 plain。

TLS Client Auth

可选

设置为 "on" 以指示 MinIO 使用 mTLS 对 Kafka brokers 进行认证。

Client TLS Certificate

可选

用于 mTLS 认证的 TLS 客户端证书路径。

Client TLS Key

可选

用于 mTLS 认证的 TLS 客户端私钥路径。

Version

可选

MinIO 在指定端点期望的 Kafka broker 版本。

如果 Kafka broker 版本与此设置指定的不匹配，MinIO 会返回错误。

Comment

可选

与该配置关联的注释。

队列目录

可选

指定目录路径（例如 /opt/minio/events）以启用 MinIO 对未投递消息的持久事件存储。

当 Kafka 服务离线时，MinIO 会将未投递事件存储到指定存储中，并在连接恢复后回放这些事件。

队列大小

可选

指定未投递消息的最大上限。 默认值为 100000。

1.6 - 存储桶通知设置

本页介绍用于控制 MinIO bucket notifications 相关行为的设置。

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

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

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

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

同步事件

可选

启用同步 存储桶通知。

指定 on 可让 MinIO 在远端目标收到事件并返回成功之后，再继续处理后续事件。

默认值为 off，即异步存储桶通知。在这种模式下，MinIO 不会等待远端目标在收到 事件后返回成功。

支持的通知目标

通知需要一个用于接收事件的目标。 MinIO 支持多种通知目标。 每种目标类型的设置位于各自独立的页面。 请根据实际使用的目标类型，选择下方对应链接。

• AMQP 通知设置
• Elasticsearch 通知设置
• Kafka 通知设置
• MQTT 通知设置
• MySQL 通知设置
• NATS 通知设置
• NSQ 通知设置
• PostgreSQL 通知设置
• Redis 通知设置
• Webhook 服务通知设置

1.6.1 - AMQP 通知设置

本文档说明了将 AMQP 服务配置为 存储桶通知 目标的相关设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 AMQP (RabbitMQ)。

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

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

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

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

多个 AMQP 目标

可以通过在顶层键后为每组相关 AMQP 设置追加唯一标识符 _ID，来指定多个 AMQP 服务端点。

示例

例如，以下命令分别将两个不同的 AMQP 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_AMQP_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_AMQP_URL_PRIMARY="amqp://user:[email protected]:5672"

export MINIO_NOTIFY_AMQP_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_AMQP_URL_SECONDARY="amqp://user:[email protected]:5672"

mc admin config set notify_amqp:primary \
   url="user:password@amqp://amqp-endpoint.example.net:5672" [ARGUMENT=VALUE ...]

mc admin config set notify_amqp:secondary \
   url="user:password@amqp://amqp-endpoint.example.net:5672" [ARGUMENT=VALUE ...]

设置

启用

mc admin config set notify_amqp \
  url="amqp://user:password@endpoint:port" \
  [ARGUMENT="VALUE"] ...

URL

必需

指定 MinIO 发布存储桶事件的 AMQP 服务器端点。 例如，amqp://myuser:mypassword@localhost:5672。

Exchange（交换机）

可选

指定要使用的 AMQP exchange 名称。

Exchange 类型

可选

指定 AMQP exchange 的类型。

路由键

可选

指定用于发布事件的 routing key。

Mandatory（强制）

可选

指定 off 以忽略消息未送达错误。 默认值为 on。

持久化

可选

指定 on 以在 broker 重启后保留消息队列。 默认值为 off。

No Wait（不等待）

可选

指定 on 以启用非阻塞消息投递。 默认值为 off。

Internal（内部）

可选

指定 on 以仅在 exchange 绑定到其他 exchanges 时使用该 exchange。 有关 AMQP exchange 绑定的更多信息，请参阅 RabbitMQ 文档中的 Exchange to Exchange Bindings。

自动删除

可选

指定 on 以在没有消费者时自动删除消息队列。 默认值为 off。

投递模式

可选

指定 1 以将投递模式设置为非持久化队列。

指定 2 以将投递模式设置为持久化队列。

队列目录

可选

指定目录路径以启用 MinIO 对未送达消息的持久化事件存储，例如 /opt/minio/events。

当 AMQP 服务离线时，MinIO 会将未送达事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

队列限制

可选

指定未送达消息的最大数量限制。 默认值为 100000。

注释

可选

为 AMQP 配置指定注释。

1.6.2 - Elasticsearch 通知设置

本文档介绍如何配置 Elasticsearch 服务作为 存储桶通知 的目标。 有关如何使用这些设置的教程，请参阅 将事件发布到 Elasticsearch。

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

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

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

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

多个 Elasticsearch 目标

可通过为每组相关设置追加唯一标识符 _ID 来指定多个 Elasticsearch 服务端点。 例如，以下命令分别将两个不同的 Elasticsearch 服务端点设置为 PRIMARY 和 SECONDARY：

示例

export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_PRIMARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_PRIMARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_PRIMARY="namespace"

export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_SECONDARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_SECONDARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_SECONDARY="namespace"

mc admin config set notify_elasticsearch:primary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_elasticsearch:secondary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

设置

启用

必需

mc admin config set notify_elasticsearch \
  url="https://user:[email protected]:9200" \
  [ARGUMENT="VALUE"] ... \

URL

必需

指定 MinIO 将存储桶事件发布到的 Elasticsearch 服务端点。 例如：https://elasticsearch.example.com:9200。

MinIO 支持通过 URL 参数传递认证信息，格式为 PROTOCOL://USERNAME:PASSWORD@HOSTNAME:PORT。

Index

必需

指定用于存储或更新 MinIO 存储桶事件的 Elasticsearch index 名称。 如果 index 不存在，Elasticsearch 会自动创建。

Format

必需

指定写入 Elasticsearch index 的事件数据格式。 MinIO 支持以下取值：

namespace

对于每个存储桶事件，MinIO 会创建一个 JSON 文档，以事件中的存储桶名和对象名作为文档 ID，并将实际事件作为文档正文的一部分。 对该对象的后续更新会修改该对象在 index 中的现有条目。 同样，删除该对象也会删除对应的 index 条目。

access

对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并以 Elasticsearch 生成的随机 ID 将其追加到 index。 对对象的后续更新会产生新的 index 条目，而现有条目保持不变。

Username

可选

用于连接启用了认证的 Elasticsearch 服务端点的用户名。

Password

可选

用于连接启用了认证的 Elasticsearch 服务端点的密码。

队列目录

可选

指定目录路径以启用 MinIO 针对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 Elasticsearch 服务离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

队列上限

可选

指定未投递消息的最大上限。 默认为 100000。

注释

可选

指定与 Elasticsearch 配置关联的注释。

1.6.3 - Kafka 通知设置

本页面记录了将 Kafka 服务配置为 存储桶通知 目标的相关设置。 有关如何使用这些设置的教程，请参见 将事件发布到 Kafka。

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

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

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

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

多个 Kafka 目标

你可以在顶层键后附加唯一标识符 _ID，为每组相关的 Kafka 设置指定多个 Kafka 服务端点。

示例

例如，以下命令分别将两个不同的 Kafka 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_KAFKA_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_KAFKA_BROKERS_PRIMARY="https://kafka1.example.net:9200, https://kafka2.example.net:9200"

export MINIO_NOTIFY_KAFKA_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_KAFKA_BROKERS_SECONDARY="https://kafka1.example.net:9200, https://kafka2.example.net:9200"

mc admin config set notify_kafka:primary \
   brokers="https://kafka1.example.net:9200, https://kafka2.example.net:9200"
   [ARGUMENT=VALUE ...]

mc admin config set notify_kafka:secondary \
   brokers="https://kafka1.example.net:9200, https://kafka2.example.net:9200"
   [ARGUMENT=VALUE ...]

设置

启用

必需

mc admin config set notify_kafka \
  brokers="https://kafka1.example.net:9200, https://kafka2.example.net:9200"
  [ARGUMENT="VALUE"] ... \

Brokers

必需

指定以逗号分隔的 Kafka broker 地址列表。 例如：

"kafka1.example.com:2021,kafka2.example.com:2021"

Topic

可选

指定 MinIO 发布存储桶事件的 Kafka topic 名称。

SASL

可选

指定 on 以启用 SASL 身份验证。

SASL Username

可选

指定用于对 Kafka broker 执行 SASL/PLAIN 或 SASL/SCRAM 身份验证的用户名。

SASL Password

可选

指定用于对 Kafka broker 执行 SASL/PLAIN 或 SASL/SCRAM 身份验证的密码。

SASL Mechanism

可选

指定用于对 Kafka broker 进行身份验证的 SASL 机制。 MinIO 支持以下机制：

• PLAIN（默认）
• SHA256
• SHA512

TLS Client Auth

可选

指定 Kafka broker 的客户端身份验证类型。 下表列出了支持的取值及其映射关系

有关各客户端身份验证类型的更多信息，请参见 ClientAuthType。

TLS

可选

指定 on 以启用与 Kafka broker 的 TLS 连接。

TLS Skip Verify

可选

启用或禁用对 NATS 服务端点 TLS 证书的 TLS 验证。

• 指定 on 以禁用 TLS 验证（默认）。
• 指定 off 以启用 TLS 验证。

Client TLS Cert

可选

指定客户端证书路径，用于对 Kafka broker 执行 mTLS 身份验证。

Client TLS Key

可选

指定客户端私钥路径，用于对 Kafka broker 执行 mTLS 身份验证。

Version

可选

指定在对 Kafka 集群执行操作时假定的 Kafka 集群版本。 有关此字段行为的更多信息，请参见 sarama reference documentation。

Batch Size

可选

指定整数值，作为向 Kafka 发送记录时的 batch size。

Queue Directory

可选

指定目录路径以启用 MinIO 对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 Kafka server/broker 离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

Queue Limit

可选

指定未投递消息的最大限制。 默认为 100000。

Comment

可选

指定与 Kafka 配置关联的注释。

Compression Codec

可选

指定向 Kafka 发送记录时使用的压缩编解码器。

支持以下取值：

• none
• snappy
• gzip
• lz4
• zstd

Compression Level

可选

根据已配置的压缩编解码器控制应用的压缩级别。

指定大于或等于 0 的整数值。 该值的效果取决于所选编解码器。

1.6.4 - MQTT 通知设置

本页面记录了将 MQTT 服务配置为 存储桶通知 目标的相关设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 MQTT。

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

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

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

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

多个 MQTT 目标

你可以在顶层键后为每组相关 MQTT 设置追加一个唯一标识符 _ID，以指定多个 MQTT 服务端点。 例如，以下命令分别将两个不同的 MQTT 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_MQTT_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_MQTT_BROKER_PRIMARY="tcp://user:[email protected]:1883"

export MINIO_NOTIFY_MQTT_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_MQTT_BROKER_SECONDARY="tcp://user:[email protected]:1883"

mc admin config set notify_mqtt:primary \
   broker="tcp://endpoint:port" \
   topic="minio/bucket-name/events/" \
   username="username" \
   password="password" \
   [ARGUMENT="VALUE"] ... \

mc admin config set notify_mqtt:secondary \
   broker="tcp://endpoint:port" \
   topic="minio/bucket-name/events/" \
   username="username" \
   password="password" \
   [ARGUMENT="VALUE"] ... \

在这些设置中，MINIO_NOTIFY_MQTT_ENABLE_PRIMARY 表示该环境变量与 ID 为 PRIMARY 的 MQTT 服务端点关联。

设置

启用

必填

mc admin config set notify_mqtt \
   broker="tcp://endpoint:port" \
   topic="minio/bucket-name/events/" \
   username="username" \
   password="password" \
   [ARGUMENT="VALUE"] ... \

Broker

必填

指定 MQTT server/broker 端点。 MinIO 支持通过 TCP、TLS 或 Websocket 连接到 server/broker URL。 例如：

• tcp://mqtt.example.net:1883
• tls://mqtt.example.net:1883
• ws://mqtt.example.net:1883

Topic

必填

指定 MQTT topic 名称，用于关联 MinIO 发布到 MQTT 端点的事件。

Username

如果 MQTT server/broker 强制认证/授权，则必填

指定 MinIO 用于向 MQTT server/broker 进行身份认证的 MQTT 用户名。

Password

如果 MQTT server/broker 强制认证/授权，则必填

指定 MinIO 用于向 MQTT server/broker 进行身份认证的 MQTT 用户名对应的密码。

服务质量（QoS）

可选

指定已发布事件的 Quality of Service 优先级。

默认为 0。

Keep Alive 间隔

可选

指定 MQTT 连接的 keep-alive 间隔。MinIO 支持以下时间单位：

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

重连间隔

可选

指定 MQTT 连接的重连间隔。MinIO 支持以下时间单位：

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

队列目录

可选

指定目录路径以启用 MinIO 的持久化事件存储，用于保存未投递消息，例如 /opt/minio/events。

当 MQTT server/broker 离线时，MinIO 会将未投递事件存储在指定位置；连接恢复后会重放这些已存储事件。

队列上限

可选

指定未投递消息的最大上限。 默认为 100000。

注释

可选

指定与 MQTT 配置关联的注释。

1.6.5 - MySQL 通知设置

本页记录了将 MySQL 服务配置为 存储桶通知 目标的相关设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 MySQL。

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

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

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

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

多个 MySQL 目标

你可以在顶层键后追加唯一标识符 _ID，为每组相关的 MySQL 设置指定多个 MySQL 服务端点。

示例

以下命令分别将两个不同的 MySQL 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_MYSQL_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_MYSQL_DSN_STRING_PRIMARY="username:password@tcp(mysql.example.com:3306)/miniodb"
export MINIO_NOTIFY_MYSQL_TABLE_PRIMARY="minioevents"
export MINIO_NOTIFY_MYSQL_FORMAT_PRIMARY="namespace"

export MINIO_NOTIFY_MYSQL_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_MYSQL_DSN_STRING_SECONDARY="username:password@tcp(mysql.example.com:3306)/miniodb"
export MINIO_NOTIFY_MYSQL_TABLE_SECONDARY="minioevents"
export MINIO_NOTIFY_MYSQL_FORMAT_SECONDARY="namespace"

mc admin config set notify_mysql:primary \
   dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
   table="minioevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_mysql:secondary \
   dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
   table="minioevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

设置

启用

必需

mc admin config set notify_mysql \
  dsn_string="username:password@tcp(mysql.example.com:3306)/miniodb"
  table="minioevents" \
  format="namespace" \
  [ARGUMENT="VALUE"] ... \

数据源名称（DSN）字符串

必需

指定 MySQL 服务端点的数据源名称（DSN）。MinIO 期望使用以下格式：

<user>:<password>@tcp(<host>:<port>)/<database>

例如：

"username:password@tcp(mysql.example.com:3306)/miniodb"

表

必需

指定 MinIO 发布事件通知到的 MySQL 表名。

格式

必需

指定写入 MySQL 服务端点的事件数据格式。 MinIO 支持以下取值：

namespace

对于每个存储桶事件，MinIO 会创建一个 JSON 文档，将事件中的存储桶和对象名称作为文档 ID，并将实际事件作为文档体的一部分。 对该对象的后续更新会修改该对象在表中的现有条目。 同样，删除该对象也会删除对应的表条目。

access

对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并以 MySQL 生成的随机 ID 追加到表中。 对对象的后续更新会产生新的索引条目，且现有条目保持不变。

最大打开连接数

可选

指定与 MySQL 数据库建立的最大打开连接数。

默认为 2。

队列目录

可选

指定目录路径，以启用 MinIO 对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 MySQL 服务器/代理离线时，MinIO 会将未投递事件存储在指定位置；连接恢复后会重放这些已存储事件。

队列上限

可选

指定未投递消息的最大上限。默认为 100000。

注释

可选

指定与 MySQL 配置关联的注释。

1.6.6 - NATS 通知设置

本页面说明了将 NATS 服务配置为 存储桶通知 目标的设置。 有关如何使用这些设置的教程，请参见 将事件发布到 NATS。

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

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

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

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

多个 NATS 目标

你可以在顶层键后追加唯一标识符 _ID，为每组相关的 NATS 设置指定多个 NATS 服务端点。

示例

例如，以下命令分别将两个不同的 NATS 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_NATS_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_NATS_ADDRESS_PRIMARY="nats-endpoint.example.net:4222"

export MINIO_NOTIFY_NATS_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_NATS_ADDRESS_SECONDARY="nats-endpoint.example.net:4222"

mc admin config set notify_nats:primary \
   address="nats-endpoint.example.com:4222" \
   subject="minioevents" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_nats:secondary \
   address="nats-endpoint.example.com:4222" \
   subject="minioevents" \
   [ARGUMENT=VALUE ...]

设置

启用

必填

mc admin config set notify_nats \
  address="nats-endpoint.example.com:4222" \
  subject="minioevents" \
  [ARGUMENT="VALUE"] ... \

地址

必填

指定 MinIO 发布存储桶事件到的 NATS 服务端点。 例如：nats-endpoint.example.com:4222。

Subject

必填

指定 MinIO 在 NATS 端点上关联已发布事件的订阅。

用户名

可选

指定连接到 NATS 服务端点时使用的用户名。

密码

可选

指定连接到 NATS 服务端点时使用的密码。

Token

可选

指定连接到 NATS 服务端点时使用的 token。

用户凭证文件

可选

指定用于连接 NATS 服务端点的 user credentials file。

TLS

可选

指定 on 以启用到 NATS 服务端点的 TLS 连接。

TLS Skip Verify

可选

启用或禁用对 NATS 服务端点 TLS 证书的 TLS 校验。

• 指定 on 以禁用 TLS 校验（默认）。
• 指定 off 以启用 TLS 校验。

Ping Interval

可选

指定客户端向 NATS 服务器发送 ping 的时间间隔。 MinIO 支持以下时间单位：

• s - 秒，"60s"
• m - 分钟，"5m"
• h - 小时，"1h"
• d - 天，"1d"

Jetstream

可选

指定 on 以启用 JetStream 支持，将事件流式传输到 NATS JetStream 服务端点。

Streaming

已弃用

可选

指定 on 以启用向 NATS 服务端点异步发布事件。

Streaming Async

已弃用

可选

指定 on 以启用向 NATS 服务端点异步发布事件。

Max ACK Responses In Flight

已弃用

可选

指定在等待 NATS 服务端点 ACK 响应之前可发布的消息数量。

Streaming Cluster ID

已弃用

可选

指定 NATS Streaming 集群的唯一 ID。

Cert Authority

可选

指定用于签署 NATS 服务端点 TLS 证书的 Certificate Authority 证书链路径。

Client Cert

可选

指定用于执行到 NATS 服务端点 mTLS 认证的客户端证书路径。

Client Key

可选

指定用于执行到 NATS 服务端点 mTLS 认证的客户端私钥路径。

Queue Directory

可选

指定目录路径以启用 MinIO 对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 NATS server/broker 离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放已存储事件。

Queue Limit

可选

指定未投递消息的最大上限。 默认为 100000。

Comment

可选

指定与 NATS 配置关联的注释。

1.6.7 - NSQ 通知设置

本页面记录了将 NSQ 服务配置为 存储桶通知 目标时所使用的设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 NSQ。

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

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

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

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

多个 NSQ 目标

你可以通过在每组相关 NSQ 设置的顶层键末尾附加唯一标识符 _ID，指定多个 NSQ 服务端点。 例如，以下命令分别将两个不同的 NSQ 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_NSQ_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_PRIMARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_NSQ_TOPIC_PRIMARY="bucketevents"

export MINIO_NOTIFY_NSQ_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_SECONDARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_NSQ_TOPIC_SECONDARY="bucketevents"

mc admin config set notify_nsq:primary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

mc admin config set notify_nsq:secondary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

设置

启用

必填

mc admin config set notify_nsq                          \
   nsqd_address="https://nsq-endpoint.example.net:4150" \
   topic="<string>"                                     \
   [ARGUMENT="VALUE"] ...

NSQ Daemon 服务器地址

必填

指定 NSQ Daemon 运行所在的 NSQ 服务器地址。 例如：

https://nsq-endpoint.example.net:4150

主题

必填

指定 MinIO 向 broker 发布事件时使用的 NSQ topic 名称。

TLS

可选

指定 on 以启用到 NSQ service broker 的 TLS 连接。

TLS 跳过校验

可选

启用或禁用对 NSQ service broker TLS 证书的 TLS 校验。

• 指定 on 可禁用 TLS 校验（默认）。
• 指定 off 可启用 TLS 校验。

队列目录

可选

指定目录路径以启用 MinIO 对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 NSQ server/broker 离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

队列上限

可选

指定未投递消息的最大上限。 默认值为 100000。

备注

可选

指定与 NSQ 配置关联的备注。

1.6.8 - PostgreSQL 通知设置

本页记录了将 PostgreSQL 服务配置为 存储桶通知 目标的设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 PostgreSQL。

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

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

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

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

多个 PostgreSQL 目标

你可以通过在顶层键后追加唯一标识符 _ID，为每组相关 PostgreSQL 设置指定多个 PostgreSQL 服务端点。 例如，以下命令分别将两个不同的 PostgreSQL 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_POSTGRES_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_POSTGRES_CONNECTION_STRING_PRIMARY="host=postgresql-endpoint.example.net port=4222..."
export MINIO_NOTIFY_POSTGRES_TABLE_PRIMARY="minioevents"
export MINIO_NOTIFY_POSTGRES_FORMAT_PRIMARY="namespace"

export MINIO_NOTIFY_POSTGRES_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_POSTGRES_CONNECTION_STRING_SECONDARY="host=postgresql-endpoint.example.net port=4222..."
export MINIO_NOTIFY_POSTGRES_TABLE_SECONDARY="minioevents"
export MINIO_NOTIFY_POSTGRES_FORMAT_SECONDARY="namespace"

mc admin config set notify_postgres:primary \
   connection_string="host=postgresql.example.com port=5432..."
   table="minioevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_postgres:secondary \
   connection_string="host=postgresql.example.com port=5432..."
   table="minioevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

在这些设置中，MINIO_NOTIFY_POSTGRES_ENABLE_PRIMARY 表示该环境变量关联到 ID 为 PRIMARY 的 PostgreSQL 服务端点。

设置

启用

必填

mc admin config set notify_postgres                            \
  connection_string="host=postgresql.example.com port=5432..." \
  table="minioevents"                                          \
  format="namespace"                                           \
  [ARGUMENT="VALUE"] ...

连接字符串

必填

指定 PostgreSQL 服务端点的 URI connection string。 MinIO 支持 key=value 格式的 PostgreSQL 连接字符串。 例如：

"host=https://postgresql.example.com port=5432 ..."

有关受支持 PostgreSQL 连接字符串参数的完整文档，请参阅 PostgreSQL Connection Strings documentation。

表

必填

指定 MinIO 发布事件通知的 PostgreSQL 表名称。

格式

必填

指定写入 PostgreSQL 服务端点的事件数据格式。 MinIO 支持以下取值：

namespace

对于每个存储桶事件，MinIO 会创建一个 JSON 文档，使用事件中的存储桶和对象名称作为文档 ID，并将实际事件作为文档内容的一部分。 对该对象的后续更新会修改该对象在表中的现有条目。 同样，删除该对象也会删除对应的表条目。

access

对于每个存储桶事件，MinIO 会创建包含事件详情的 JSON 文档，并以 PostgreSQL 生成的随机 ID 将其追加到表中。 对对象的后续更新会产生新的索引条目，现有条目保持不变。

最大打开连接数

可选

指定与 PostgreSQL 数据库建立的最大打开连接数。

默认为 2。

队列目录

可选

指定目录路径以启用 MinIO 的持久化事件存储，用于保存未投递消息，例如 /opt/minio/events。

当 PostgreSQL server/broker 离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

队列上限

可选

指定未投递消息的数量上限。 默认为 100000。

注释

可选

指定与 PostgreSQL 配置关联的注释。

1.6.9 - Redis 通知设置

本页记录了将 Redis 服务配置为 存储桶通知 目标所需的设置。 有关如何使用这些设置的教程，请参阅 将事件发布到 Redis。

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

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

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

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

多个 Redis 目标

你可以通过在每组相关 Redis 设置的顶层键末尾追加唯一标识符 _ID 来指定多个 Redis 服务端点。 例如，以下命令分别将两个不同的 Redis 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_REDIS_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_REDIS_ADDRESS_PRIMARY="redis-endpoint.example.net:9200"
export MINIO_NOTIFY_REDIS_KEY_PRIMARY="bucketevents"
export MINIO_NOTIFY_REDIS_FORMAT_PRIMARY="namespace"


export MINIO_NOTIFY_REDIS_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_REDIS_REDIS_ADDRESS_SECONDARY="redis-endpoint2.example.net:9200"
export MINIO_NOTIFY_REDIS_KEY_SECONDARY="bucketevents"
export MINIO_NOTIFY_REDIS_FORMAT_SECONDARY="namespace"

mc admin config set notify_redis:primary              \
   address="redis-endpoint.example.net:9200"  \
   key="bucketevents"                                 \
   format="namespace"                                 \
   [ARGUMENT="VALUE"] ...                             \

mc admin config set notify_redis:secondary            \
   address="redis-endpoint2.example.net:9200" \
   key="bucketevents"                                 \
   format="namespace"                                 \
   [ARGUMENT="VALUE"] ...

设置

启用

必需

mc admin config set notify_redis \
   address="ENDPOINT" \
   key="<string>" \
   format="<string>" \
   [ARGUMENT="VALUE"] ... \

地址

必需

指定 MinIO 发布存储桶事件的 Redis 服务端点。 例如：redis.example.com:6369。

键

必需

指定用于存储和更新事件的 Redis 键。 如果该键不存在，Redis 会自动创建。

格式

必需

指定写入 Redis 服务端点的事件数据格式。 MinIO 支持以下取值：

namespace

对于每个存储桶事件，MinIO 会创建一个 JSON 文档，以事件中的存储桶名和对象名作为文档 ID，并将实际事件作为文档体的一部分。 对该对象的后续更新会修改该对象现有的索引条目。 同样，删除对象也会删除对应的索引条目。

access

对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并以 Redis 生成的随机 ID 将其追加到该键。 对对象的后续更新会产生新的索引条目，现有条目保持不变。

密码

可选

指定 Redis 服务器的密码。

用户

可选

指定 Redis 服务器的用户。

队列目录

可选

指定目录路径以启用 MinIO 的持久化事件存储，用于保存未投递消息，例如 /opt/minio/events。

当 Redis server/broker 离线时，MinIO 会将未投递事件存储到指定存储中；连接恢复后，会重放这些已存储事件。

队列上限

可选

指定未投递消息的最大上限。 默认为 100000。

注释

可选

指定与 Redis 配置关联的注释。

1.6.10 - Webhook 服务通知设置

本页记录了将 Webhook 服务配置为 存储桶通知 目标所需的设置。 有关如何使用这些设置的教程，请参见 将事件发布到 Webhook。

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

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

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

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

多个 Webhook 服务目标

可通过在顶层键后为每组相关 Webhook 设置追加唯一标识符 _ID 来指定多个 Webhook 服务端点。 例如，以下命令分别将两个不同的 Webhook 服务端点设置为 PRIMARY 和 SECONDARY：

export MINIO_NOTIFY_WEBHOOK_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_WEBHOOK_ENDPOINT_PRIMARY="https://webhook1.example.net"

export MINIO_NOTIFY_WEBHOOK_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_WEBHOOK_ENDPOINT_SECONDARY="https://webhook1.example.net"

mc admin config set notify_webhook:primary \
   endpoint="https://webhook1.example.net"
   [ARGUMENT=VALUE ...]

mc admin config set notify_webhook:secondary \
   endpoint="https://webhook2.example.net
   [ARGUMENT=VALUE ...]

设置

启用

必需

mc admin config set notify_webhook \
  endpoint="https://webhook.example.net"
  [ARGUMENT="VALUE"] ... \

端点

必需

指定 Webhook 服务的 URL。

认证令牌

必需

export MINIO_NOTIFY_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"

export MINIO_NOTIFY_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"

   mc admin config set myminio notify_webhook   \
   endpoint="https://webhook-1.example.net"  \
      auth_token="Bearer 1a2b3c4f5e"

   mc admin config set myminio notify_webhook   \
      endpoint="https://webhook-1.example.net"  \
      auth_token="ServiceXYZ 1a2b3c4f5e"

队列目录

可选