# PGSTY SILO 文档

> pgsty/silo 20261015 文档手册

---

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

---

> **当前控制台：** [Console v2.4.1](/zh/blog/release/console-2.4.1/)，配套 mcli 20260916 与 pkg v3.14.1。查看[组件版本矩阵](/zh/compatibility/versions/)与[密码权限迁移](/zh/compatibility/password-permissions/)。

<p>组件独立发布，已发布版本与开发分支的区别见<a href="/zh/compatibility/versions/">组件版本矩阵</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**

下面的命令固定到当前 SILO 服务端发行版。示例凭据仅适用于本地评估。

<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-09-16T00-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 版本视为冻结的兼容基线，而不是仍在维护的依赖。