PostHog/posthog
运维与部署可自托管的产品分析平台,集分析、会话回放、功能开关、实验、错误追踪和数据仓库于一体,适合产品、研发和增长团队。
项目介绍
PostHog 是一个产品分析与可观测平台:它把事件、错误、会话回放、日志和业务数据统一摄取存储,让团队和 AI Agent 都能查询并据此行动。产品覆盖产品分析、网页分析、会话回放、错误追踪、日志、链路追踪、功能开关、实验、问卷,以及带 120 多个数据源的托管数据仓库。对使用大模型的应用,AI 可观测可采集 trace、生成记录、延迟和成本。目标用户是需要一个共享上下文层、而不想维护多套工具的产品、研发和增长团队。
仓库是 PostHog 的主要 monorepo(Python 后端、TypeScript/React 前端),采用 MIT 许可证;ee 目录另有许可证,彻底 FOSS 的版本是 posthog-foss 许可说明。
快速使用
多数用户推荐直接用托管服务:注册 PostHog Cloud 美国区或欧盟区,创建项目后开始上报事件。每月免费额度包含 100 万事件、5k 录制、100 万次开关请求、10 万异常、10GB 日志和 1500 份问卷回复。
拥有实例后,用安装向导把 SDK 接入应用:
npx -y @posthog/wizard@latest
也可以改用 JavaScript 代码片段,或 JavaScript、React、Next.js、Vue、React Native、Android、iOS、Flutter、Python、Node、PHP、Ruby 等 SDK;各语言的安装说明见入门文档。
如果要在 AI 编辑器或 Agent 里使用 PostHog,远程 MCP 服务地址是 https://mcp.posthog.com/mcp,文档给出的安装命令为:
npx @posthog/wizard mcp add
登录后它会按账号路由到美国或欧盟数据区,支持 Claude Code、Cursor、Codex、VS Code、Zed 和 PostHog Desktop;各客户端的配置见 MCP 文档。
自托管
在 Linux 上用 Docker 可部署 hobby 实例(建议 4GB 内存):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/posthog/posthog/HEAD/bin/deploy-hobby)"
开源部署的规模预期约为每月 10 万事件,超过后文档建议迁移到 PostHog Cloud。维护者明确表示开源自托管部署不提供客户支持或保证,因此自托管应视为高级、尽力而为的选项,而不是默认路径自托管说明。
使用约束
- 自托管规模约每月 10 万事件为限,更大用量需使用云端。
- 云端超出免费额度后按用量计费,价格见定价页。
- 托管服务按美国区和欧盟区拆分,MCP 服务会根据用户登录状态解析数据区。
- 仓库是 monorepo,本地构建或参与贡献需要按本地开发指南准备环境。
HotRepo 点评
PostHog 多次出现在 HotRepo 的日榜快照中:2026 年 7 月 16 日至 24 日,Star 从 35,682 增至 37,077,期间多数单日新增数百;到 2026 年 11 月 19 日的 Python 周榜,Star 为 40,953,最好名次 13。这组数据更像持续稳定的采用,而不是某一天的爆发,与平台不断叠加相邻产品线的做法相符。站内讨论也围绕团队工程实践展开:.cursorrules 相关讨论关注 PostHog 如何编写 Agent 指令讨论,另有帖子记录了多个机器人参与评审 PostHog 的 PR 讨论。在这种体量下,采纳者真正要决定的是云端与自托管的能力边界,而不是项目是否还在维护。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。