目录

OpenReplay 项目分析

1、项目概览

2、关键特性

3、代码结构（Monorepo）

4、技术栈与语言占比

5、部署与交付

6、社区与支持

7、版本与活跃度（截至仓库页面所示）

8、适用场景

9、优势与注意事项

10、落地建议（示例）

11、参考链接

---

OpenReplay 项目分析

OpenReplay GitHub 仓库

1、项目概览

• 定位: 开源、自托管的前端会话回放与产品分析平台，帮助研发与产品重现问题、定位根因并优化体验。

• 核心价值: 将用户在 Web 应用中的真实操作回放，并关联网络请求、控制台日志、JS 异常、状态管理动作、性能与资源指标，形成端到端的可观测性视角。

• 部署形态: 支持在自有云/Kubernetes 部署，亦提供官方云服务（OpenReplay Cloud）。

• 许可: Monorepo 含多种 License，详见仓库 LICENSE 文件。

2、关键特性

• Session Replay 会话回放: 回放用户行为，并自动基于启发式规则做问题分级与归类。

• DevTools 级上下文: 可查看网络活动、JS 错误、状态管理动作与状态快照、40+ 性能与资源指标。

• Assist 实时协助: 支持与用户进行实时同屏（WebRTC）与通话，无需第三方屏幕共享软件。

• Spot 浏览器扩展: 一键录制缺陷并自动附带技术上下文，便于开发快速复现与修复。

• Omni-Search 检索: 按行为、属性或技术事件进行检索与筛选，无需额外埋点。

• Analytics 分析: 聚焦影响转化与营收的关键问题，辅助优先级决策。

• 隐私与合规: 细粒度敏感信息屏蔽/忽略策略；自托管确保数据不出域。

• 插件生态: Redux、Vuex、MobX、NgRx、Pinia、Zustand 等状态库，以及 GraphQL（Apollo、Relay）与 HTTP（Fetch/Axios）日志采集。

• 生态集成: 后端日志能与前端回放对齐，支持 Sentry、Datadog、CloudWatch、Stackdriver、Elastic 等。

3、代码结构（Monorepo）

仓库为多模块单体仓库，主要目录包括（摘录）：

• api、backend: 后端 API 与服务端组件。

• frontend: Web 前端管理界面。

• tracker: 浏览器端埋点/回放采集 SDK，压缩后仅约 26KB（.br）。

• assist、assist-server、assist-stats: 实时协助（协同/语音通话/统计）相关。

• networkProxy: 网络代理/重放相关能力。

• spot: 浏览器扩展相关模块。

• snippet: 便捷安装/注入片段。

• sourcemap-uploader、sourcemapreader: SourceMap 上报与解析工具。

• ee: 企业版相关目录（如有）。

• 其他: mobs、static、scripts 等辅助或资源目录。

注: 上述为从仓库目录名与官方说明归纳的高层视图，具体职责以子目录 README/源码为准。

4、技术栈与语言占比

• TypeScript: 约 49%

• Python: 约 18%

• JavaScript: 约 8.2%

• Go: 约 8%

• PLpgSQL: 约 3.6%

• HTML: 约 3.1%

• 其他: 约 10.1%

5、部署与交付

• 自托管: 支持 AWS、Google Cloud、Azure、DigitalOcean、Scaleway、OVHcloud 及 Kubernetes 等环境的部署指南。

• 云服务: 可直接使用官方的 OpenReplay Cloud（免自建）。

6、社区与支持

• 交流: Slack 社区。

• 问题反馈: GitHub Issues。

• 内容与动态: Twitter、YouTube、官网聊天。

7、版本与活跃度（截至仓库页面所示）

• 最新发布: v1.22.3（2025-09-09）。

• Star: ~11.1k；Fork: ~627；Watchers: ~77。

• 提交活跃，Monorepo 多模块协作。

8、适用场景

• 复杂前端应用的缺陷复现与回归验证。

• 转化/漏斗分析、性能劣化定位与用户行为洞察。

• 客服与支持团队的实时协助与问题排查。

• 合规/安全要求较高、需自托管的数据场景。

9、优势与注意事项

• 优势

  • 自托管、隐私可控，适合对数据主权有强要求的组织。

  • 低开销 Tracker 与丰富的技术上下文采集，提升排障效率。

  • 插件与集成生态完善，便于与现有监控、告警、日志系统打通。

• 注意事项

  • 自托管需评估资源与运维成本（存储、计算、网络代理等）。

  • 需制定敏感字段脱敏策略，避免 PII/敏感数据泄漏。

  • 插件/采集项过多可能引入额外开销，需按需启用与采样。

10、落地建议（示例）

1. 试点集成 tracker 于预发布环境，验证性能与数据体量（采样率/回放留存周期）。

2. 与现有日志/监控（如 Sentry/Datadog/Elastic）对齐事件与 Trace/Session ID，打通前后端链路。

3. 按业务与安全要求配置隐私规则（屏蔽/忽略/采集白名单）。

4. 评估 Assist 与 Spot 的团队协作价值，按需启用。

5. 制定存储与归档策略，控制成本并满足合规留存。

11、参考链接

• OpenReplay 仓库与文档入口: https://github.com/openreplay/openreplay