MinIO Webhook事件通知配置无法识别已设置的auth_token

1. 确认MinIO版本兼容性 #

auth_token是MinIO较新版本才支持的配置参数，先检查你的MinIO版本：

• 通过mc客户端查询：mc admin info dev-minio
• 或进入Docker容器内执行：docker exec <minio-container-name> minio --version
  如果版本早于RELEASE.2021-06-17T00-10-46Z，建议升级到最新稳定版，旧版本不支持该参数。

2. 正确配置并重启服务 #

mc客户端配置方式 #

执行完整配置命令，注意参数格式（引号不可省略，确保auth_token正确传入）：

mc admin config set dev-minio notify_webhook:primary endpoint="https://example.com/webhook/" auth_token="mytoken"

配置完成后必须重启MinIO服务，Docker环境下重启命令：

docker restart <minio-container-name>

Docker环境变量配置方式 #

如果用环境变量配置，启动容器时需指定以下变量，同时挂载配置目录保证持久化：

docker run -d \
  -p 9000:9000 \
  -e MINIO_NOTIFY_WEBHOOK_PRIMARY_ENDPOINT="https://example.com/webhook/" \
  -e MINIO_NOTIFY_WEBHOOK_PRIMARY_AUTH_TOKEN="mytoken" \
  -v /host/path/to/minio/config:/root/.minio \
  -v /host/path/to/minio/data:/data \
  minio/minio server /data

3. 验证配置有效性 #

查看完整配置 #

用JSON格式查询配置，确认auth_token是否存在（部分版本mc文本输出会隐藏敏感参数，JSON格式会完整显示）：

mc admin config get dev-minio notify_webhook:primary --json

触发事件验证 #

上传文件到bucket1/all/路径，查看Webhook端点的请求日志，检查请求头是否包含Authorization: Bearer mytoken，存在则说明配置生效。

4. 修复Docker配置持久化问题 #

如果重启容器后配置丢失，说明未正确挂载MinIO配置目录：

1. 停止并删除当前容器：

docker stop <minio-container-name> && docker rm <minio-container-name>

2. 重新启动容器，确保挂载配置和数据目录：

docker run -d \
  -p 9000:9000 \
  -v /host/path/to/minio/config:/root/.minio \
  -v /host/path/to/minio/data:/data \
  minio/minio server /data

挂载后，mc客户端修改的配置会保存到宿主机的/host/path/to/minio/config/config.json中，重启容器不会丢失。

内容的提问来源于stack exchange，提问作者Muhammad