LokiStack/homepage/dist/docs/wizard/index.html

<!doctype html>
<html lang="zh-CN"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>部署向导 · LokiStack 文档</title>
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Crect width='64' height='64' rx='14' fill='%23059669'/%3E%3Ctext x='32' y='44' font-size='34' font-weight='800' fill='%23fff' text-anchor='middle' font-family='sans-serif'%3EL%3C/text%3E%3C/svg%3E">
<link rel="stylesheet" href="/docs/assets/loki-docs.css">
<style id="h5-fix">@media (max-width:820px){body{-webkit-text-size-adjust:100%}nav a,nav button,.nav-links a,.nav-menu a,.nav-item,.topnav a,.menu a,.side a,.sidebar a,.docs-side a,.toc a,footer a,a.btn,.plan .btn,button.btn{display:inline-flex;align-items:center;min-height:44px}.side a,.sidebar a,.docs-side a{padding:10px 12px;border-radius:8px}.toc a{padding:8px 0}pre{max-width:100%;overflow-x:auto}.plans,.grid,.grid-2,.grid-3{grid-template-columns:1fr!important}.hero h1,.hero-title{font-size:clamp(24px,7vw,34px)!important}.tbl-scroll{max-width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}}</style>
<script id="h5-fix-js">(function(){var f=function(){document.querySelectorAll("table").forEach(function(t){var p=t.parentElement;if(p&&p.classList&&p.classList.contains("tbl-scroll"))return;var w=document.createElement("div");w.className="tbl-scroll";p.insertBefore(w,t);w.appendChild(t);});};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",f);else f();})();</script>
</head><body>
<div class="topbar">
  <a class="brand" href="/"><i>L</i>LokiStack</a>
  <span style="color:#98a2b3;font-size:13px">文档</span>
  <nav class="topnav"><a href="/">官网</a><a href="/docs/" class="on">文档</a></nav>
</div>
<div class="layout">
  <aside class="side"><h4>开始使用</h4><a data-slug="readme" href="/docs/readme/">产品介绍</a><a data-slug="install" href="/docs/install/">快速安装</a><a data-slug="wizard" href="/docs/wizard/" class="on">部署向导</a><h4>采集与查询</h4><a data-slug="collectors" href="/docs/collectors/">日志采集</a><a data-slug="query" href="/docs/query/">日志查询</a><a data-slug="analysis" href="/docs/analysis/">日志分析</a><a data-slug="access" href="/docs/access/">查询授权</a><h4>告警与运维</h4><a data-slug="alerts" href="/docs/alerts/">告警通知</a><a data-slug="faq" href="/docs/faq/">常见问题</a></aside>
  <article>
    <h1>部署向导</h1>
    <div class="meta">开始使用 · 更新于 2026-10-28</div>
    <p>部署向导(<code>/wizard</code>)三步完成 Loki 上线:环境与目标 → 存储 → 部署 Loki 与采集。</p>
<p><img alt="部署向导" src="/docs/assets/screenshots/wizard.png" /></p>
<h2 id="_1">第一步:环境与目标</h2>
<ul>
<li><strong>Kubernetes 集群</strong>:粘贴 kubeconfig,或按页面给出的 RBAC 脚本在集群执行一次后粘贴 ServiceAccount 长期 Token。平台经 API Server 操作集群,无需安装 kubectl/Helm。</li>
<li><strong>裸金属主机</strong>:填写 SSH 地址与凭证(密码或私钥,AES-GCM 加密存储)。适合二进制或 Docker 模式。</li>
</ul>
<p>创建后平台自动验证连通性;Kubernetes 资源默认落在 <code>log</code> 命名空间(可改)。</p>
<h2 id="_2">第二步:准备存储</h2>
<p>推荐对象存储(MinIO / RustFS / S3 / OSS):多副本与数据保留更可靠,创建时可用「测试连接」验证凭证并自动建桶;跳过则使用本地磁盘。</p>
<h2 id="_3">第三步:部署与采集</h2>
<ul>
<li>选择目标、Loki 版本(支持 2.8+ / 3.x)、保留天数与资源规格,点击部署。</li>
<li>部署成功后平台自动注册同名数据源,日志查询页立即可用;按提示添加采集策略(见<a href="collectors.md">日志采集</a>)。</li>
</ul>
<h2 id="_4">三种部署模式</h2>
<table>
<thead>
<tr>
<th>模式</th>
<th>适用</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>k8s-yaml</td>
<td>Kubernetes</td>
<td>StatefulSet + SSA 直发,平台全托管</td>
</tr>
<tr>
<td>host-binary</td>
<td>裸金属</td>
<td>SSH 安装二进制 + systemd 托管</td>
</tr>
<tr>
<td>host-docker</td>
<td>裸金属</td>
<td>Docker 容器运行,自动目录迁移</td>
</tr>
</tbody>
</table>
    <div class="pager"><a href="/docs/install/">← 快速安装</a><a href="/docs/collectors/">日志采集 →</a></div>
  </article>
  <nav class="toc"><b>本页目录</b><a href="#_1">第一步:环境与目标</a><a href="#_2">第二步:准备存储</a><a href="#_3">第三步:部署与采集</a><a href="#_4">三种部署模式</a></nav>
</div>
<footer>LokiStack · <a href="/">返回官网</a> · © 日理万机</footer>
</body></html>