# PGSTY SILO 文档

> pgsty/silo 20260806 文档手册

---

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

---

<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>
<div class="td-tabs td-tabs--shortcode" id="td-tabs-7b11549f-0" data-td-tabs data-td-tabs-group="docker-linux-minio-kubernetes" data-td-tabs-default="docker">
  <div class="td-tabs__list" role="tablist" aria-label="选项卡">
    <button class="td-tabs__tab" type="button" role="tab" id="docker-linux-minio-kubernetes-docker-tab" aria-controls="docker-linux-minio-kubernetes-docker" aria-selected="true" tabindex="0" data-td-tabs-value="docker">Docker</button>
    <button class="td-tabs__tab" type="button" role="tab" id="docker-linux-minio-kubernetes-linux-tab" aria-controls="docker-linux-minio-kubernetes-linux" aria-selected="false" tabindex="-1" data-td-tabs-value="linux">Linux 软件包</button>
    <button class="td-tabs__tab" type="button" role="tab" id="docker-linux-minio-kubernetes-minio-tab" aria-controls="docker-linux-minio-kubernetes-minio" aria-selected="false" tabindex="-1" data-td-tabs-value="minio">现有 MinIO</button>
    <button class="td-tabs__tab" type="button" role="tab" id="docker-linux-minio-kubernetes-kubernetes-tab" aria-controls="docker-linux-minio-kubernetes-kubernetes" aria-selected="false" tabindex="-1" data-td-tabs-value="kubernetes">Kubernetes</button>
  </div>
  <div class="td-tabs__panel" id="docker-linux-minio-kubernetes-docker" role="tabpanel" aria-labelledby="docker-linux-minio-kubernetes-docker-tab" tabindex="0" data-td-tabs-value="docker" data-td-tabs-active>
    <div class="td-tabs__panel-title" aria-hidden="true">Docker</div>
    <div class="td-tabs__panel-body"><p>下面的命令固定到当前 SILO 服务端发行版。示例凭据仅适用于本地评估。</p>
<div class="td-steps td-max-width-on-larger-screens">
<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-7b11549f-tabs0-docker-fence-0" data-td-code data-td-code-auto-id
     data-td-language="shell" data-td-line-count="7"><div class="td-code__utilities td-code__utilities--compact">
  <button class="td-code__copy" type="button" hidden data-td-code-copy
          data-td-code-target="td-code-7b11549f-tabs0-docker-fence-0" data-td-copy-mode="all"
          data-td-label-copy="复制代码"
          data-td-label-copied="已复制"
          data-td-label-error="复制失败"
          aria-label="复制代码" title="复制代码">
    <i class="fa-regular fa-copy" aria-hidden="true"></i>
  </button>
</div>
  <div class="td-code__viewport" id="td-code-7b11549f-tabs0-docker-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">  pgsty/silo:RELEASE.2026-08-06T00-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>
  <span class="visually-hidden" role="status" aria-live="polite" data-td-code-status></span>
</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-7b11549f-tabs0-docker-fence-1" data-td-code data-td-code-auto-id
     data-td-language="shell" data-td-line-count="1"><div class="td-code__utilities td-code__utilities--compact">
  <button class="td-code__copy" type="button" hidden data-td-code-copy
          data-td-code-target="td-code-7b11549f-tabs0-docker-fence-1" data-td-copy-mode="all"
          data-td-label-copy="复制代码"
          data-td-label-copied="已复制"
          data-td-label-error="复制失败"
          aria-label="复制代码" title="复制代码">
    <i class="fa-regular fa-copy" aria-hidden="true"></i>
  </button>
</div>
  <div class="td-code__viewport" id="td-code-7b11549f-tabs0-docker-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>
  <span class="visually-hidden" role="status" aria-live="polite" data-td-code-status></span>
</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>
</div>
<p>持久化宿主机路径、服务管理与生产注意事项见<a href="/zh/operations/deployments/baremetal-deploy-minio-as-a-container/">容器部署指南</a>。</p>
</div>
  </div>
  <div class="td-tabs__panel" id="docker-linux-minio-kubernetes-linux" role="tabpanel" aria-labelledby="docker-linux-minio-kubernetes-linux-tab" tabindex="0" data-td-tabs-value="linux">
    <div class="td-tabs__panel-title" aria-hidden="true">Linux 软件包</div>
    <div class="td-tabs__panel-body"><p>在<a href="/zh/download/#server">下载与安装</a>页面选择对应架构的 RPM、DEB、APK 或独立归档。正式发布制品同时提供 SHA-256 校验和与构建溯源证明。</p>
<p>原生软件包将服务端安装为 <code>/usr/bin/silo</code>，并继续使用既有的 <code>MINIO_*</code> 环境变量契约。替换现有 <code>minio</code> 软件包前，请阅读<a href="/zh/compatibility/binary/">二进制与软件包兼容说明</a>。</p>
</div>
  </div>
  <div class="td-tabs__panel" id="docker-linux-minio-kubernetes-minio" role="tabpanel" aria-labelledby="docker-linux-minio-kubernetes-minio-tab" tabindex="0" data-td-tabs-value="minio">
    <div class="td-tabs__panel-title" aria-hidden="true">现有 MinIO</div>
    <div class="td-tabs__panel-body"><p>替换镜像或二进制前，请先阅读<a href="/zh/compatibility/migration/">迁移指南</a>。保留数据卷与配置，停止所有运行旧二进制的节点，再让所有节点统一启动同一个固定版本的 SILO。不要在两种二进制之间滚动迁移，也不要对需要保留的数据执行 <code>docker compose down -v</code>。</p>
</div>
  </div>
  <div class="td-tabs__panel" id="docker-linux-minio-kubernetes-kubernetes" role="tabpanel" aria-labelledby="docker-linux-minio-kubernetes-kubernetes-tab" tabindex="0" data-td-tabs-value="kubernetes">
    <div class="td-tabs__panel-title" aria-hidden="true">Kubernetes</div>
    <div class="td-tabs__panel-body"><p>已归档的 MinIO Operator <code>v7.1.1</code> 可以运行使用 SILO 镜像的 Tenant：将镜像覆盖为 <code>pgsty/silo</code>，并固定经过测试的标签或摘要。请遵循 <a href="/zh/operations/deployments/k8s-deploy-minio-tenant-helm-on-kubernetes/">Tenant Helm 指南</a>，并把该 Operator 版本视为冻结的兼容基线，而不是仍在维护的依赖。</p>
</div>
  </div>
</div>
