# 部署说明

本文档描述 `opsx-loki` 的两种部署方式，域名与 IP 均为脱敏示例：

- `opsx-loki.xxx.io` —— 平台 UI 域名
- `log.xxx.io` —— Loki 查询域名（Ingress）
- `192.168.x.x` —— 内网地址占位

## 架构

```
浏览器
  │  HTTPS（WAF / SLB 终止）
  ▼
边缘 WAF ──► 主机 nginx（192.168.x.x）
                │
                ├─ 主机部署：proxy_pass http://127.0.0.1:8081
                └─ K8s 部署：proxy_pass http://<NodeIP>:30080
                                     │
                                     ▼
                          Service opsx-loki:8080
                                     │
                                     ▼
                          Deployment opsx-loki（1 副本）
                                     │
                    ┌────────────────┴────────────────┐
                    ▼                                 ▼
              PVC /app/data                  Loki Service log/loki:3100
              （JSON DB、kubeconfig 加密）      （日志存储：S3/OSS/COS/OBS）
```

## 两种方式的取舍

| | 主机 Docker | Kubernetes |
|---|---|---|
| 适用 | 单机、快速验证 | 多环境、统一调度 |
| 数据 | 本地卷 `/app/data` | PVC（默认 StorageClass） |
| 域名 | 主机 nginx 反代 `127.0.0.1:8081` | NodePort + nginx，或 ALB Ingress |
| 约束 | 单实例 | **1 副本 + Recreate**（JSON DB 单写者） |

## 文档索引

| 文档 | 内容 |
|---|---|
| [host-nginx.md](host-nginx.md) | 主机部署的 nginx 反代配置（含 WAF 真实 IP、白名单） |
| [kubernetes.md](kubernetes.md) | K8s 清单、Ingress（ALB）、PVC、Secret、升级 |