- homepage/:品牌落地页(Hero/特性/快速开始),参考 opsxapi 站点风格,绿色品牌系 - docs/:docsify 文档站 + user-guide 十篇手册(安装/向导/采集/查询/分析/告警/授权/备份/FAQ) - 后端 serveStaticDir 挂载 /docs 与 /homepage(可执行文件相对定位,独立于前端 dist)
1.3 KiB
1.3 KiB
安装与启动
环境要求
- 平台自身:任意 Linux / macOS(Go 1.24 构建或直接使用发布二进制),内存 ≥ 256MB
- 目标 Kubernetes 集群:≥ 1.20;或裸金属 Linux 主机(SSH 可达)
- 端口:平台默认 8080;Loki 默认 3100
必备环境变量
平台启动强制要求两个密钥(长度均需 ≥ 32 字符):
export JWT_SECRET=$(openssl rand -hex 32)
export ENCRYPTION_KEY=$(openssl rand -hex 32) # 凭证加密密钥,丢失将无法解密已存凭证
方式一:开发模式
./run.sh # 同时拉起前端(:3000)与后端(:8080),自动注入开发密钥
方式二:生产 Docker
make secrets # 生成 ./secrets/*.txt
docker compose -f docker-compose.prod.yml up -d
方式三:单二进制
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)会在启动时自动迁移