Files
LokiStack/docs/deployment
opsx 3c9388658b refactor: 资源名 opsx-loki/opsxloki → lokistack(线上已迁移完成)
【已在线完成,零数据丢失】
K8s ns=log 资源全部改名:
  Deployment  opsx-loki          → lokistack
  Service     opsx-loki          → lokistack
  Service     opsx-loki-nodeport → lokistack-nodeport
  PVC         opsxloki-data      → lokistack-data
  Secret      opsxloki-secrets   → lokistack-secrets
  Label       app: opsx-loki     → app: lokistack
  Ingress     log.astx.club 后端  → lokistack-nodeport:8080
  镜像        lghost/opsxloki     → lghost/lokistack
  docker-compose 卷/容器名同步更名

【保留不变(改了会出事)】
  namespace: log
  数据文件名 opsxloki.json(代码硬编码)
  容器内路径 /app/data

【迁移过程】
  1. 备份 PVC 数据(32KB) + Secret 原值 + 旧 yaml → /root/lokistack-migration-backup-20261026-171141
  2. scale 旧 Deployment → 0,等 Pod 消失
  3. 复制 Secret(JWT sha256 校验一致)
  4. 新建 PVC lokistack-data(Bound 30Gi cbs)
  5. 临时 Pod 恢复数据(chown 1000:1000,opsxloki.json 保留 0600)
  6. apply 新 Deployment → 1/1 Running
  7. 修复 Ingress 后端(TKE qcloud 要求 NodePort)→ CLB 恢复 200
  8. 删除旧 Deployment / 失效 Service

【验证】
  lokistack 1/1,0 重启,镜像 lghost/lokistack:latest(statically linked)
  /api/v1/health → {"status":"ok","version":"2.0.0"}
  /app/data/opsxloki.json 610B 完整(admin 用户 + 配置)
  http://log.astx.club/ → HTTP 200
  镜像加固:admin123=0、/app/backend/=0、initial-admin-password.txt 存在

【回滚兜底(建议 7 天后删)】
  pvc/opsxloki-data、secret/opsxloki-secrets

【文档】
  README 新增「从 opsx-loki 升级」章节:
  K8s 七步迁移脚本 + docker-compose 卷迁移命令
2026-10-26 17:16:15 +00:00
..

部署说明

本文档描述 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 主机部署的 nginx 反代配置(含 WAF 真实 IP、白名单)
kubernetes.md K8s 清单、Ingress(ALB)、PVC、Secret、升级