# 安装与启动

## 环境要求

- 平台自身:任意 Linux / macOS(Go 1.24 构建或直接使用发布二进制),内存 ≥ 256MB
- 目标 Kubernetes 集群:≥ 1.20;或裸金属 Linux 主机(SSH 可达)
- 端口:平台默认 8080;Loki 默认 3100

## 必备环境变量

平台启动强制要求两个密钥(长度均需 ≥ 32 字符):

```bash
export JWT_SECRET=$(openssl rand -hex 32)
export ENCRYPTION_KEY=$(openssl rand -hex 32)   # 凭证加密密钥,丢失将无法解密已存凭证
```

## 方式一:开发模式

```bash
./run.sh        # 同时拉起前端(:3000)与后端(:8080),自动注入开发密钥
```

## 方式二:生产 Docker

```bash
make secrets    # 生成 ./secrets/*.txt
docker compose -f docker-compose.prod.yml up -d
```

## 方式三:单二进制

```bash
bash build.sh   # 产物 backend/bin/lokistack(前端已内嵌)
export JWT_SECRET=... ENCRYPTION_KEY=... DATA_DIR=/data
./lokistack
```

首次启动会自动创建管理员账号,初始密码写入 `$DATA_DIR/initial-admin-password.txt`,请立即修改。

## 数据与升级

- 全部状态存储在 `$DATA_DIR/lokistack.json`(JSON 文件,无外部数据库依赖,单实例运行)
- 升级:替换二进制后重启即可;历史命名数据文件(opsxloki.json / lokideploy.json)会在启动时自动迁移