# PGSTY SILO 文档

> SILO 20261109、Console 2.7.0、mcli 20261109、silo-pkg 3.16.0 与 KES 20261026 双语文档总入口。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

通过左侧导航浏览[部署运维](/zh/operations/)、[日常管理](/zh/administration/)、[应用开发](/zh/developers/)、[命令与配置参考](/zh/reference/)、[兼容性审计](/zh/compatibility/)与[发布说明](/zh/blog/release/)，或前往[下载与安装](/zh/download/)获取各平台制品。

<p>本站面向 <strong><a href="/zh/blog/release/silo-20261109/">SILO 20261109</a></strong>、内嵌与独立版 <strong><a href="/zh/blog/release/console-2.7.0/">Console 2.7.0</a></strong>、<strong><a href="/zh/blog/release/mcli-20261109/">mcli 20261109</a></strong>、<strong><a href="/zh/blog/release/pkg-3.16.0/">silo-pkg 3.16.0</a></strong>，以及可选外部密钥服务 <strong><a href="/zh/blog/release/silo-20261026/#kes">KES 20261026</a></strong>，统一使用 Go 1.27.3 构建。升级前请核对<a href="/zh/compatibility/versions/">组件版本矩阵</a>与 <a href="/zh/compatibility/server/#maintenance-20261109">20261109 升级检查</a>（单独升级独立版 <code>mcli</code> 或 Console 不会替换旧版 Server 内嵌的组件）。</p>
<div class="td-callout td-callout--warning" role="note">
  <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden="true"></i><span class="td-callout__label">警告</span></div>
  <div class="td-callout__body">
<p><strong>SILO 是由 Pigsty 社区维护的 MinIO 分支。</strong> 本项目并非 MinIO, Inc. 的关联项目，也未获得其认可、赞助或背书。“MinIO” 是 MinIO, Inc. 的商标，此处仅用于标识上游项目。源码与许可信息详见<a href="/zh/about/attribution/">归属与署名</a>。</p>
  </div>
</div><p>SILO 在保留 S3 API、配置与磁盘存储契约的同时，为现有 MinIO 部署提供开放的发行与安全维护路径。本站覆盖安装、迁移、管理、开发、版本发布与兼容边界。</p>
<h2 id="quickstart">快速开始<a class="td-heading-self-link" href="#quickstart" aria-label="标题锚点"></a>
</h2>
**Docker**

以下命令固定使用已公开发布的 [Server 20261109](/zh/blog/release/silo-20261109/#delivery)。示例凭据仅用于本地评估。

<h3 id="quickstart-start">启动 SILO<a class="td-heading-self-link" href="#quickstart-start" aria-label="标题锚点"></a>
</h3>
<div class="td-code td-code--untitled" id="td-code-3aa61e38-fence-0" data-td-code data-td-code-auto-id
     data-td-language="shell" data-td-line-count="7">
  <div class="td-code__viewport" id="td-code-3aa61e38-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">docker run -d --name silo <span class="se">\
</span></span></span><span class="line"><span class="cl">  -p 9000:9000 -p 9001:9001 <span class="se">\
</span></span></span><span class="line"><span class="cl">  -e <span class="nv">MINIO_ROOT_USER</span><span class="o">=</span>silo-admin <span class="se">\
</span></span></span><span class="line"><span class="cl">  -e <span class="nv">MINIO_ROOT_PASSWORD</span><span class="o">=</span>replace-with-a-strong-secret <span class="se">\
</span></span></span><span class="line"><span class="cl">  -v silo-data:/data <span class="se">\
</span></span></span><span class="line"><span class="cl">  docker.io/pgsty/silo:RELEASE.2026-11-09T00-00-00Z <span class="se">\
</span></span></span><span class="line"><span class="cl">  server /data --console-address :9001</span></span></code></pre></div></div>
</div>
<h3 id="quickstart-check">检查就绪状态<a class="td-heading-self-link" href="#quickstart-check" aria-label="标题锚点"></a>
</h3>
<div class="td-code td-code--untitled" id="td-code-3aa61e38-fence-1" data-td-code data-td-code-auto-id
     data-td-language="shell" data-td-line-count="3">
  <div class="td-code__viewport" id="td-code-3aa61e38-fence-1-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">docker <span class="nb">exec</span> silo silo healthcheck ready
</span></span><span class="line"><span class="cl">docker <span class="nb">exec</span> silo mcli <span class="nb">alias</span> <span class="nb">set</span> <span class="nb">local</span> http://127.0.0.1:9000 silo-admin replace-with-a-strong-secret
</span></span><span class="line"><span class="cl">docker <span class="nb">exec</span> silo mcli mb local/demo</span></span></code></pre></div></div>
</div>
<p><code>silo healthcheck ready</code> 检查本地 HTTP 监听与已配置的 KMS / etcd 状态，可能在存储或 IAM 完成加载前返回 <code>0</code>，详见<a href="/zh/operations/monitoring/healthcheck-probe/#native-probe">健康检查探针</a>。通过内置 <code>mcli</code> 创建或读取存储桶可进一步确认 S3 数据路径已就绪。</p>
<h3 id="quickstart-console">打开管理控制台<a class="td-heading-self-link" href="#quickstart-console" aria-label="标题锚点"></a>
</h3>
<p>访问 <a href="http://127.0.0.1:9001">http://127.0.0.1:9001</a>，使用上面的 root 凭据登录。投入生产前，请启用 TLS、配置独立强凭据、固定经过验证的镜像标签或摘要，并测试备份恢复。</p>


持久化宿主机路径、Distroless 镜像变体、服务管理与生产注意事项见[容器部署指南](/zh/operations/deployments/baremetal-deploy-minio-as-a-container/)。

**Linux 软件包**

在[下载与安装](/zh/download/#server)页面选择对应架构的 RPM、DEB、APK 或独立归档。正式发布制品附带 SHA-256 校验和、SPDX SBOM、Sigstore 签名包与构建溯源证明。

原生软件包将服务端安装为 `/usr/bin/silo`，并沿用 `MINIO_*` 环境变量契约。替换现有 `minio` 软件包前，请阅读[二进制与软件包兼容说明](/zh/compatibility/binary/)。

**现有 MinIO**

替换镜像或二进制前，请先阅读[迁移指南](/zh/compatibility/migration/)与 [20261109 升级检查](/zh/compatibility/server/#maintenance-20261109)。保留数据卷与配置，排空未完成的批处理任务，停止所有运行旧二进制的节点，再统一启动同一固定版本的 SILO。切勿对需要保留的数据卷执行 `docker compose down -v`。

**Kubernetes**

可使用仓库维护的独立 [`helm/silo` Chart（`7.0.4`）](https://github.com/pgsty/silo/tree/RELEASE.2026-11-09T00-00-00Z/helm/silo)直接部署，默认拉取 `pgsty/silo:RELEASE.2026-11-09T00-00-00Z` 与 `pgsty/mc:RELEASE.2026-11-09T00-00-00Z`（执行 `helm upgrade --reuse-values` 时请显式传入 `--set image.tag=RELEASE.2026-11-09T00-00-00Z`）。若使用已归档的 MinIO Operator `v7.1.1`，请遵循 [Tenant Helm 指南](/zh/operations/deployments/k8s-deploy-minio-tenant-helm-on-kubernetes/)覆盖租户镜像，并将该 Operator 版本视为冻结的兼容基线。