# PGSTY SILO 文档

> SILO 20261026 正式版文档

---

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

---

本手册以 **[SILO 20261026 正式版](/zh/blog/release/silo-20261026/)**（内嵌 Console 2.5.1）为基线，配套独立版 **[Console 2.6.0](/zh/blog/release/console-2.6.0/)**、**[mcli 20261109](/zh/blog/release/mcli-20261109/)**、**[silo-pkg 3.16.0](/zh/blog/release/pkg-3.16.0/)** 和可选 **[KES 20261026](/zh/blog/release/silo-20261026/#kes)**，统一使用 Go 1.27.3。

升级前请查阅[组件版本矩阵](/zh/compatibility/versions/)、[升级检查](/zh/compatibility/server/#maintenance-20261026)与[安装指南](/zh/download/)（注意单独升级独立客户端或独立 Console 不会替换旧版 Server 内嵌的控制台组件）。

<p>本站以 <strong><a href="/zh/blog/release/silo-20261026/">SILO 20261026</a></strong> 正式版（内嵌 Console 2.5.1）为基线，配套独立版 <strong><a href="/zh/blog/release/console-2.6.0/">Console 2.6.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/blog/release/console-2.7.0/">Console 2.7.0 发布说明</a>。</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 20261026，现已公开提供，见[交付状态](/zh/blog/release/silo-20261026/#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-10-26T00-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="1">
  <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></code></pre></div></div>
</div>
<p>退出码为 <code>0</code> 表示本地服务已就绪。该探针内置于每个 SILO 二进制，不依赖容器内的第二个客户端。</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>，使用上面的凭据登录。投入生产前，请启用 TLS、设置唯一强凭据、固定经过测试的镜像标签或摘要，并实际验证备份恢复。</p>


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

**Linux 软件包**

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

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

**现有 MinIO**

替换镜像或二进制前，请先阅读[迁移指南](/zh/compatibility/migration/)。保留数据卷与配置，停止所有运行旧二进制的节点，再让所有节点统一启动同一个固定版本的 SILO。不要在两种二进制之间滚动迁移，也不要对需要保留的数据执行 `docker compose down -v`。

**Kubernetes**

已归档的 MinIO Operator `v7.1.1` 可以运行使用 SILO 镜像的 Tenant：将镜像覆盖为 `docker.io/pgsty/silo`，并固定经过测试的标签或摘要。请遵循 [Tenant Helm 指南](/zh/operations/deployments/k8s-deploy-minio-tenant-helm-on-kubernetes/)，并把该 Operator 版本视为冻结的兼容基线，而不是仍在维护的依赖。