# 部署向导

部署向导(`/wizard`)三步完成 Loki 上线:环境与目标 → 存储 → 部署 Loki 与采集。

![部署向导](/docs/assets/screenshots/wizard.png)

## 第一步:环境与目标

- **Kubernetes 集群**:粘贴 kubeconfig,或按页面给出的 RBAC 脚本在集群执行一次后粘贴 ServiceAccount 长期 Token。平台经 API Server 操作集群,无需安装 kubectl/Helm。
- **裸金属主机**:填写 SSH 地址与凭证(密码或私钥,AES-GCM 加密存储)。适合二进制或 Docker 模式。

创建后平台自动验证连通性;Kubernetes 资源默认落在 `log` 命名空间(可改)。

## 第二步:准备存储

推荐对象存储(MinIO / RustFS / S3 / OSS):多副本与数据保留更可靠,创建时可用「测试连接」验证凭证并自动建桶;跳过则使用本地磁盘。

## 第三步:部署与采集

- 选择目标、Loki 版本(支持 2.8+ / 3.x)、保留天数与资源规格,点击部署。
- 部署成功后平台自动注册同名数据源,日志查询页立即可用;按提示添加采集策略(见[日志采集](collectors.md))。

## 三种部署模式

| 模式 | 适用 | 说明 |
| --- | --- | --- |
| k8s-yaml | Kubernetes | StatefulSet + SSA 直发,平台全托管 |
| host-binary | 裸金属 | SSH 安装二进制 + systemd 托管 |
| host-docker | 裸金属 | Docker 容器运行,自动目录迁移 |