跳转到主要内容

这是本节的多页打印视图。 .

返回本页常规视图.

故障排查

概述

MinIO 用户有两种支持渠道可选。

  1. 通过 公开 Slack 频道 获取社区支持。

    社区支持仅为尽力而为，不提供 SLA 或 SLO。

  2. 付费订阅用户可访问 MinIO Subscription Network，即 SUBNET，可获得健康检查、直接面向工程团队的支持以及许可证管理。

    当前许可级别和定价请参见 MinIO SUBNET 页面。

工具

MinIO Client 提供了多项功能，用于显示 MinIO 部署信息或监控其活动。

  • 如需查看 MinIO 部署的基础信息，请使用 mc admin info。
  • 如需进一步排查 S3 调用与响应，请使用 mc admin trace。
  • 使用 mc admin logs 从命令行显示日志。 该命令支持类型和数量过滤器，可进一步限制日志输出。

升级与版本支持

MinIO 会定期发布更新，以引入新功能、提升性能、解决安全问题或修复缺陷。 这些发布可能非常频繁，并且会因产品不同而有所差异。

在生产部署升级之前，务必先在开发环境中测试软件版本。

建议的升级周期

MinIO 建议始终安装最新版本，以获得安全增强和其他改进。 我们理解，如此频繁的发布节奏对某些组织而言可能并不现实。 在这种情况下，我们建议使用发布不超过六个月的 MinIO 及相关产品版本。

版本对齐

由于 MinIO 各产品会按照各自的节奏分别发布，我们建议采用以下版本对齐实践：

MinIO

更新到最新版本，或更新到不超过六个月的版本。

MinIO 客户端

更新到在 MinIO 发布后紧接着发布的 mc 版本，时间间隔控制在一到两周内。

MinIO Operator

使用不早于 Operator 发布时最新版本的 MinIO 版本。 该发布时间点的最新 MinIO 版本，可在对应 Operator 版本示例租户 kustomization YAML 文件中的 quay.io 链接中找到。

  • 4.5.5: MinIO RELEASE.2022-12-07T00-56-37Z or later
  • 4.5.6: MinIO RELEASE.2023-01-02T09-40-09Z or later
  • 4.5.7: MinIO RELEASE.2023-01-12T02-06-16Z or later
  • 4.5.8: MinIO RELEASE.2023-01-12T02-06-16Z or later

创建新租户时，Operator 会使用最新可用的 MinIO 发布镜像，或使用你在创建租户时指定的镜像。

Upgrading the Operator 不会自动升级现有租户。 需要单独执行 Upgrade existing tenant 以升级 MinIO 版本。

1 - 加密文件

说明

mcli support inspect 用于从服务端底层磁盘采集原始对象数据与元数据。PGSTY mcli 将采集到的诊断包直接保存在本地，无需注册 SUBNET，也不会自动向外部上传。诊断归档与解密密钥包含底层存储数据，请按敏感资料妥善保管。

加密

当前版本的 SILO 与 mcli 默认对 inspect 输出进行加密（support inspect 命令不再设 --encrypt 开关）：

mcli support inspect 'mysilo/mybucket/myobject/xl.meta'

如果客户端配置目录中未放置自定义的 support_public.pem 公钥，SILO 会自动生成一次性随机密钥，并由 mcli 在完成下载时随文件名一并打印。请立即保存该密钥（丢失后无法找回，PGSTY 也不内置任何厂商后门密钥）。

如果配置了 support_public.pem，请妥善保管与之配对的私钥。路径中包含通配符时请加上引号，防止被本地 shell 提前展开。由于递归采集可能拉取多块磁盘上的完整对象分片，建议仅采集排查所需的目标文件。

解密

从维护中的 SILO 源码仓库构建 inspect 解密工具（需使用该版本要求的 Go 工具链）：

git clone --branch RELEASE.2026-10-26T00-00-00Z --depth 1 https://github.com/pgsty/silo.git
cd silo/docs/debugging/inspect
go build -o inspect .

对于下载时打印了对称密钥的归档，传入 -key 解密：

./inspect -key=DECRYPTION_KEY /path/to/inspect.enc

若省略 -key 且未指定私钥文件，工具会交互式提示输入解密密钥。

对于使用 support_public.pem 公钥加密的归档，传入对应的私钥文件解密：

./inspect -private-key=/secure/path/support_private.pem /path/to/inspect.enc

使用 -key 时，工具会在输入文件同级目录下生成解密后的 ZIP 归档；使用 -private-key 时，则会将包含 inspect.zip 在内的解密数据流解压到输出目录。向他人发送前请先核查解压内容；注意解开 inspect.enc 的外层诊断包装并不会替开启了服务端加密（SSE）的对象本身执行解密。