Files
LokiStack/docs/user-guide/install.md
T
opsx 3ea7f2dcc6 feat(site): homepage 落地页 + docsify 用户手册文档站(/docs /homepage 随二进制发布)
- homepage/:品牌落地页(Hero/特性/快速开始),参考 opsxapi 站点风格,绿色品牌系
- docs/:docsify 文档站 + user-guide 十篇手册(安装/向导/采集/查询/分析/告警/授权/备份/FAQ)
- 后端 serveStaticDir 挂载 /docs 与 /homepage(可执行文件相对定位,独立于前端 dist)
2026-10-29 14:04:24 +08:00

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)会在启动时自动迁移