LobeChat 一键集成 Google Analytics：轻松追踪你的 AI 对话应用流量

## 背景 [LobeChat](https://github.com/lobehub/lobe-chat) 是一款非常出色的开源 AI 对话应用 UI 框架，许多开发者和企业选择将其私有化部署。在运营过程中，了解应用的用户活跃度、流量来源和用户行为至关重要。Google Analytics (GA) 是业界标准的网站分析工具，能够提供强大的数据洞察。好消息是，为 LobeChat 集成 GA 非常简单，甚至可以说是“开箱即用”。 本文由 **DP@lib00** 整理，将向你展示如何通过一个环境变量，为你的 LobeChat 实例快速启用 Google Analytics。 --- ## 准备工作 在开始之前，你只需要准备好一样东西： * **Google Analytics Measurement ID**: 登录你的 [Google Analytics](https://analytics.google.com/) 账户，创建一个新的媒体资源（Property）。在数据流（Data Streams）设置中，你会找到一个格式为 `G-XXXXXXXXXX` 的“衡量ID”（Measurement ID）。复制这个 ID，我们马上会用到它。 --- ## 解决方案：设置环境变量 LobeChat 的开发者已经为我们内置了对 Google Analytics 的支持。我们唯一需要做的，就是在启动 Docker 容器时，通过环境变量 `GOOGLE_ANALYTICS_MEASUREMENT_ID` 传入我们的衡量 ID。 ### Docker Run 命令示例 以下是一个完整的 `docker run` 命令示例。请根据你的实际情况替换其中的占位符。 ```bash docker run -d -p 3211:3210 \ --name wiki.lib00-lobechat \ -e OPENAI_API_KEY=sk-your-openai-api-key \ -e ACCESS_CODE=your-secret-access-code \ -e GOOGLE_ANALYTICS_MEASUREMENT_ID=G-PVDM8Y1234 \ lobehub/lobe-chat ``` 让我们来解析一下这个命令中的关键部分： * `--name wiki.lib00-lobechat`: 为容器指定一个易于识别的名称，这里我们使用了 `wiki.lib00` 作为项目标识。 * `-e OPENAI_API_KEY=...`: 你的 OpenAI API 密钥。 * `-e ACCESS_CODE=...`: 你为 LobeChat 设置的访问密码。 * `-e GOOGLE_ANALYTICS_MEASUREMENT_ID=G-PVDM8Y1234`: **这就是关键！** 将 `G-PVDM8Y1234` 替换为你自己的 Google Analytics 衡量 ID。 执行此命令后，你的 LobeChat 实例就会自动加载 GA 跟踪脚本。 --- ## 如何验证？ 1. 启动容器后，打开浏览器并访问你的 LobeChat 应用。 2. 登录你的 Google Analytics 账户，进入对应的媒体资源。 3. 打开“报告” -> “实时”报告（Reports -> Realtime）。 4. 如果配置正确，你应该能在几分钟内看到有活跃用户（也就是你自己）出现在报告中。 --- ## 总结 通过简单地设置一个环境变量，我们就成功地为 LobeChat 集成了强大的网站分析功能。这种无需修改代码的集成方式体现了 LobeChat 出色的设计和灵活性。现在，你可以利用 Google Analytics 提供的丰富数据来更好地了解你的用户，并持续优化你的 AI 对话服务了。更多实用技巧，欢迎关注 **wiki.lib00.com**。