存储桶通知设置

• 1: AMQP 通知设置
• 2: Elasticsearch 通知设置
• 3: Kafka 通知设置
• 4: MQTT 通知设置
• 5: MySQL 通知设置
• 6: NATS 通知设置
• 7: NSQ 通知设置
• 8: PostgreSQL 通知设置
• 9: Redis 通知设置
• 10: Webhook 服务通知设置

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 配置指定注释。

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 配置关联的注释。

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 的整数值。 该值的效果取决于所选编解码器。

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 配置关联的注释。

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 配置关联的注释。

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 配置关联的注释。

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 配置关联的备注。

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 配置关联的注释。

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 配置关联的注释。

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"

队列目录

可选

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

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

队列上限

可选

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

客户端证书

可选

指定用于向 Webhook 服务执行 mTLS 认证的客户端证书路径。

客户端密钥

可选

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