opsx
3ea7f2dcc6
- homepage/:品牌落地页(Hero/特性/快速开始),参考 opsxapi 站点风格,绿色品牌系 - docs/:docsify 文档站 + user-guide 十篇手册(安装/向导/采集/查询/分析/告警/授权/备份/FAQ) - 后端 serveStaticDir 挂载 /docs 与 /homepage(可执行文件相对定位,独立于前端 dist)
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# 安装与启动
|
|
|
|
## 环境要求
|
|
|
|
- 平台自身:任意 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)会在启动时自动迁移
|