文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

NSQ 通知设置

此页面记录了将 NSQ 服务配置为目标的设置存储桶通知.发布事件到 NSQ有关使用这些设置的教程。

您可以通过定义以下内容来建立或修改设置:

  • an 环境变量在启动或重启 MinIO 服务器之前,请在主机系统上设置此环境变量。 有关如何定义环境变量,请参阅操作系统的文档。

  • a 配置设置使用mc admin config set.

如果您同时定义了环境变量和类似的配置设置,MinIO 将使用环境变量的值。

某些设置只有环境变量或配置设置,但没有两者都提供。

重要

每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前,先在较低环境(如开发环境或测试环境)中测试配置变更。

多个 NSQ 目标

您可以通过附加唯一标识符来指定多个NSQ服务端点_ID到每个相关 NSQ 设置组的顶级键末尾。 例如,以下命令设置了两个不同的 NSQ 服务端点作为PRIMARYSECONDARY分别:

export MINIO_NOTIFY_NSQ_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_PRIMARY="https://user:password@nsq-endpoint.example.net:9200"
export MINIO_NOTIFY_NSQ_TOPIC_PRIMARY="bucketevents"

export MINIO_NOTIFY_NSQ_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_SECONDARY="https://user:password@nsq-endpoint.example.net: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"] ... \

设置

启用

必需

MINIO_NOTIFY_NSQ_ENABLE

指定on启用将存储桶通知发布到 NSQ 端点的功能。

notify_nsq

用于定义 NSQ 服务器/代理端点的顶级配置键MinIO 存储桶通知.

使用mc admin config set设置或更新 NSQ 服务器/代理端点。 以下参数是必需对于每个端点:

将其他可选参数指定为空格分隔的" ")-分隔的列表。

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

NSQ 守护进程服务器地址

必需

MINIO_NOTIFY_NSQ_NSQD_ADDRESS
notify_nsq nsqd_address

指定运行 NSQ 守护进程的 NSQ 服务器地址。 例如:

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

Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态(是否可解析和可达)。 即使现有通知目标处于离线状态,MinIO 也不再阻止添加新的通知目标。

主题

必需

MINIO_NOTIFY_NSQ_TOPIC
notify_nsq 主题

指定 MinIO 向代理发布事件时使用的 NSQ 主题名称。

TLS

可选

MINIO_NOTIFY_NSQ_TLS
notify_nsq tls

指定on以启用与 NSQ 服务代理的 TLS 连接。

TLS 跳过验证

可选

MINIO_NOTIFY_NSQ_TLS_SKIP_VERIFY
notify_nsq tls_skip_verify

启用或禁用对 NSQ 服务代理 TLS 证书的 TLS 验证。

  • 指定on禁用 TLS 验证(默认)。

  • 指定off启用 TLS 验证。

队列目录

可选

MINIO_NOTIFY_NSQ_QUEUE_DIR
notify_nsq queue_dir

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

MinIO 在 NSQ 服务器/代理离线时将未送达的事件存储在指定存储中,并在连接恢复时重放已存储的事件。

队列限制

可选

MINIO_NOTIFY_NSQ_QUEUE_LIMIT
notify_nsq queue_limit

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

评论

可选

MINIO_NOTIFY_NSQ_COMMENT
notify_nsq 评论

指定要与NSQ配置关联的注释。