跳到主要内容

离线部署指南（Docker）

部署说明​

本文档介绍如何在离线环境中使用 Docker 部署 Lighthouse 可观测平台。离线安装包（lighthouse_offline_x.x.x_amd64.tar.gz ）包含了所有必需的组件和依赖，无需访问外网即可完成部署。

部署准备​

环境要求​

硬件配置
  • CPU：8 核心及以上
  • 内存：16 GB 及以上
  • 硬盘：100 GB 及以上
  • 网络带宽：1000 Mbps
软件环境
  • 操作系统：支持以下主流 Linux 发行版
    • RedHat 7.6+
    • CentOS 7.6+
    • RockyLinux 8.x+
    • Ubuntu LTS 版本
    • Debian 稳定版
  • Docker Engine 20.10.0+
  • Docker Compose v2.0.0+

部署步骤​

1. 安装包准备​

1.1 下载安装包​

ARM 架构

目前安装包支持 ARM 架构，下载脚本会根据当前机器架构而下载对应的包.

执行以下命令下载最新版本的安装包：

curl https://static.lighthouse.cyritex.com/install.sh | bash
版本选择

建议在生产环境中使用指定版本的安装命令，以确保环境的稳定性和可控性。

如需安装特定版本(仅限于 1.22.0 及以上版本，其他的版本请联系技术人员)，请在命令中指定版本号，例如安装 1.22.0 版本：

curl https://static.lighthouse.cyritex.com/install.sh | bash -s -- -v 1.22.0
安装包校验

1.22.0 是对应的版本号，需要进行对应的修改。

（1）查看安装包的原始的 md5 值

curl https://static.lighthouse.cyritex.com/packages/lighthouse_offline_1.22.0_amd64_checksum.txt

（2）查看下载的安装包 md5 值进行对比

md5sum lighthouse_offline_1.22.0_amd64.tar.gz

1.2 解压安装包​

tar zxvf lighthouse_offline_1.22.0_amd64.tar.gz

2. 部署平台​

cd lighthouse
./lighthouse.sh install
部署过程

安装脚本会自动完成以下操作：

  1. 检查系统环境
  2. 加载 Docker 镜像
  3. 初始化数据库
  4. 启动所有必需服务

3. 验证部署​

执行以下命令查看服务状态：

./lighthouse.sh ls

正常情况下，您将看到类似下图的输出：

服务状态

服务状态说明
  • 所有服务应显示为 running 状态
  • light-schema-migrator 服务显示为 exited 是正常的，这是一个一次性的数据库迁移服务

访问平台​

  1. 打开浏览器，访问 http://{部署服务器IP}
  2. 首次访问时，系统会引导您创建管理员账号
  3. 完成账号创建后，将自动登录到 Lighthouse 平台。
申请 License

成功登陆 Lighthouse 平台后，需要进入「系统管理 - License 管理」模块，向我方技术人员提供您专属的LHID，为您生成合适的 License 文件。

导入可用的 License 文件后，即可开始探索平台。

-->查看详细说明

平台运维​

常用命令​

运维命令
# 查看服务状态
./lighthouse.sh ls

# 停止所有服务
./lighthouse.sh stop

# 停止指定服务
./lighthouse.sh stop <服务名>

# 重启所有服务
./lighthouse.sh restart

# 重启指定服务
./lighthouse.sh restart <服务名>

# 卸载平台
./lighthouse.sh uninstall

# 查看版本信息
./lighthouse.sh -v

示例数据（可选）​

如需体验平台功能，可以部署示例应用生成测试数据：

cd /opt/lighthouse/deploy/docker-compose/
PROFILER_EXPORTER_ENDPOINT={部署服务器IP}:8085 OPTIONAL_SERVICE_REPLICAS=1 docker compose --env-file /opt/lighthouse/.env up -d light-demo
RUM 数据采集
  1. 部署完成后，访问 http://{部署服务器IP}:8082
  2. 在示例网站上进行页面交互
  3. 打开 Lighthouse 平台的「用户体验监控」模块查看采集到的 RUM 数据

故障处理​

如果部署过程中遇到问题，请检查：

  1. 系统资源是否满足最低要求
  2. Docker 服务是否正常运行
  3. 查看服务日志：docker logs <容器名>

如需更多帮助，请联系技术支持。