MinIO

基本信息

属性	值
版本	2024.8.17 / 2025.7.23
Helm 目录	k8s-apps/04-helm/06-minio/
Namespace	yidun-infra
Release 名称	minio-yidun
节点标签	minio: "true"
NodePort	31311
默认账号	admin / Minio@2020

用途

MinIO 在易盾私有化平台中主要用于：

• 存储音视频原始文件（待审核内容）
• 存储审核结果截图、缩略图
• 提供对象存储 API 接口（兼容 AWS S3）

部署模式

默认使用 standalone（单节点）模式：

mode: standalone

高可用模式需切换为 distributed：

mode: distributed
statefulset:
  replicaCount: 4   # 至少 4 个节点
  zones: 1
  drivesPerNode: 1

访问

API 访问

NodePort: http://<节点IP>:31311
集群内:   http://minio-yidun.yidun-infra.svc:9000

控制台访问（Console）

# 获取控制台 NodePort（通常是 API NodePort + 1）
kubectl get svc minio-yidun -n yidun-infra

S3 兼容 API 示例

# 使用 mc（MinIO Client）
mc alias set yidun http://<节点IP>:31311 admin Minio@2020

# 列出 bucket
mc ls yidun

# 上传文件
mc cp local-file.mp4 yidun/video-bucket/

# 下载文件
mc cp yidun/video-bucket/file.mp4 ./

常用运维

# 查看 Pod 状态
kubectl get pod -n yidun-infra -l app.kubernetes.io/name=minio

# 查看存储使用
kubectl exec -it minio-yidun-0 -n yidun-infra -- \
  mc du --versions local/

# 进入 Pod
kubectl exec -it minio-yidun-0 -n yidun-infra -- bash

故障排查

磁盘空间不足

# 查看 PVC 使用情况
kubectl get pvc -n yidun-infra

# 查看节点磁盘
kubectl exec -it minio-yidun-0 -n yidun-infra -- df -h

权限问题

# 重置 admin 密码
kubectl exec -it minio-yidun-0 -n yidun-infra -- \
  mc admin user info local admin