离线部署指南（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
部署过程
安装脚本会自动完成以下操作：
- 检查系统环境
- 加载 Docker 镜像
- 初始化数据库
- 启动所有必需服务
3. 验证部署
执行以下命令查看服务状态：
./lighthouse.sh ls
正常情况下，您将看到类似下图的输出：
服务状态说明
- 所有服务应显示为
running状态 light-schema-migrator服务显示为exited是正常的，这是一个一次性的数据库迁移服务
访问平台
打开浏览器，访问 http://{部署服务器IP}，即可进入平台登录页面。
注册并使用
后续操作详细 说明，请参考文档注册并使用
平台运维
常用命令
运维命令
# 查看服务状态
./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 数据采 集
- 部署完成后，访问
http://{部署服务器IP}:8082 - 在示例网站上进行页面交互
- 打开 Lighthouse 平台的「用户体验监控」模块查看采集到的 RUM 数据
故障处理
如果部署过程中遇到问题，请检查：
- 系统资源是否满足最低要求
- Docker 服务是否正常运行
- 查看服务日志：
docker logs <容器名>
如需更多帮助，请联系技术支持。