用途:把 PostHog 分析部署到生产环境,覆盖 Next.js + Vercel、Docker 自托管和 Google Cloud Run 三种平台。
主要能力:Vercel 上通过 next.config.js 的 rewrites 配置反向代理以绕过广告拦截器;在客户端用 posthog-js 初始化并指向 /ingest;在 Vercel Edge Functions 中用 posthog-node 做服务端事件采集;用 Docker 自托管 PostHog(hobby 配置);用 Cloud Run 部署并注入密钥;通过 Annotations API 在每次部署时打注解,便于关联指标变化与发布。
必要用法:需准备 PostHog 项目 API key(phc_...)、服务端功能所需的个人 API key(phx_...)以及平台 CLI(vercel、docker 或 gcloud)。Vercel 侧用 vercel env add 设置 NEXT_PUBLIC_POSTHOG_KEY、NEXT_PUBLIC_POSTHOG_HOST、POSTHOG_PERSONAL_API_KEY、POSTHOG_PROJECT_ID。自托管执行 git clone https://github.com/PostHog/posthog.git 后配置 .env(SECRET_KEY、SITE_URL、IS_BEHIND_PROXY),再运行 docker compose -f docker-compose.hobby.yml up -d,健康检查 curl -s http://localhost:8000/_health | jq .。Cloud Run 用 gcloud secrets create 存密钥,再用 gcloud run deploy 配合 --set-secrets 注入。
限制与注意:api_host 应使用 us.i.posthog.com 而非 app.posthog.com;服务端无服务器函数必须 await posthog.shutdown() 以刷新事件;自托管内存至少 4GB,否则可能 502;Cloud Run 冷启动时把初始化移到模块作用域。
适用场景:需要生产级 PostHog 部署、绕过广告拦截、服务端采集或自托管分析的团队。
暂未提供:具体收费、价格与效果数据。