PostHog 自托管实战从一键脚本到三副本集群的完整路径【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog这篇文章写给正在评估 PostHog 部署的开发者与运维从理清单机要跑哪些组件、用 Docker Compose 跑通第一个实例到升级为生产集群最后收拢在监控、备份与排坑清单上。先看清组件全家福PostHog 背后到底在跑什么第一次在一台装完 PostHog 的机器上执行docker compose ps你大概率会被二十多个容器砸一脸——到底哪个才是PostHog 本 Hog先把心智模型搭起来网页和 API 只是冰山一角真正干活的是一条摄取链路Rust 采集边缘 → Kafka → Node.js 消费者 → ClickHouse外加元数据 Postgres、Redis、S3 兼容对象存储这一圈支撑件。组件技术栈职责关键端口Web / WorkerPythonDjango CeleryAPI、前端、定时任务8000事件摄取边缘Rustcapture 系列接 /e /s /i 上报转发进 Kafka3000、4318Flags 边缘Rust/flags 求值与热缓存3001摄取 WorkerNode.js消费 Kafka落 ClickHouse / PG6738元数据 DBPostgreSQL 15项目、用户、flags 定义5432分析 DBClickHouse 26.6事件宽表、会话录制数据8123 / 9000消息总线 缓存RedpandaKafka 协议/ Redis摄取缓冲 热缓存9092 / 6379会话录制这类大对象不塞进数据库而是丢给 S3 兼容的对象存储Compose 栈里默认 MinIO / SeaweedFS19000 起服务。仓库里的 docker-compose.hobby.yml 就是这份全家福的完整清单装完之后对一遍服务名会很踏实。30 分钟跑通第一个实例 Docker Compose 自托管之路径当你把安装脚本跑完、打开域名却看到浏览器转了 5 分钟圈——别慌这是正常的脚本会拉镜像、预建 Kafka topic、跑全量迁移、等 Caddy 签好 TLS 证书官方自己都说要等 5~10 分钟。它最后拿curl轮询/_health直到返回 200 才宣告结束所以转圈本身说明链路在正常推进。整个安装逻辑都在 bin/deploy-hobby 里确认内存 ≥ 8GB、拉取代码、生成三把密钥、写.env、装 Docker、起栈。非交互执行时传版本 tag 域名两个参数即可# 交互执行会逐项询问脚本化执行直接传参 # 参数顺序应用 tag如 latest 域名必须 A 记录 sudo bash deploy-hobby latest analytics.example.com真正需要你理解、而不是手抄的是.env里这几个必填项POSTHOG_SECRETxxxx # Django 会话与签名密钥 ENCRYPTION_SALT_KEYSxxxx # 字段加密盐事后换掉旧数据无法解密 BROWSERLESS_SECRETxxxx # 截图渲染容器的独立凭证 DOMAINanalytics.example.com # Caddy 自动签发 TLS 用的域名 POSTHOG_APP_TAGlatest # 镜像版本 tag可选项ANTHROPIC_API_KEY/OPENAI_API_KEY只在你想用内置 AI 功能时才填留空不影响核心链路。持久化与自检数据不丢、活着可查持久化只需要盯三个卷其余随栈自动挂上volumes: - postgres-data:/var/lib/postgresql/data # 5432 元数据 - clickhouse-data:/var/lib/clickhouse # 9000 分析宽表 - objectstorage:/data # S3 兼容存储自检方面不用自己写PG 用pg_isready、ClickHouse 探8123/ping、Flags 边缘探/_readiness日志默认走json-file驱动做 50MB×3 轮转防止日志反向吃光磁盘。第一次 200 之后登录域名你会看到这样的控制台——能进到这里说明网关、Django、迁移、对象存储这一串都通了上生产 把单机升级成多节点集群先说个背景官方对自托管 K8s 的 Helm 支持已经停更Compose 文件头部有明确注释所以上生产基本等于自己把单机架构搬上集群。别慌按四步走就行。把网关和后端服务隔离到不同网段单机里 Caddy 一个容器既做 TLS 又做路径分发/e 给摄取边缘、/flags 给 Flags 边缘、其余转 Django。生产环境换成专用 Ingress 或 LB 承担 TLS 与路由内部服务一律不发布端口到公网跨组件访问走集群内部 DNS。无状态服务直接加副本Django 的会话在 Redis 里、Celery worker 是纯队列消费者所以 web 和 worker 都是无状态的横向扩副本没有副作用spec: replicas: 3 template: spec: containers: - name: web image: posthog/posthog:tag ports: - containerPort: 8000 readinessProbe: httpGet: { path: /_health, port: 8000 } resources: requests: { memory: 2Gi, cpu: 1 } limits: { memory: 4Gi, cpu: 2 }Namespace、Service、ConfigMap、Secret 这些对象按常规流程建即可不再逐个贴。ClickHouse 集群怎么起三副本为什么 ClickHouse 必须用 StatefulSet 而不是 Deployment它的 part merge 依赖本地盘的顺序写Pod 漂移到新节点会触发整段数据重灌和 re-merge查询延迟会瞬间炸掉。绑定稳定 PVC 的 StatefulSet 才能保住这个前提spec: replicas: 3 serviceName: clickhouse template: spec: containers: - name: clickhouse image: clickhouse/clickhouse-server:26.6 ports: - containerPort: 8123 - containerPort: 9000 volumeClaimTemplates: - metadata: { name: ch-data } spec: accessModes: [ ReadWriteOnce ] resources: { requests: { storage: 500Gi } }Postgres 侧类似单副本 StatefulSet 或托管 RDS 都行查询压力大时挂一个只读副本分担报表查询。把密钥从镜像里挪出去DATABASE_URL、REDIS_URL、ClickHouse 账号密码全部进 Secret 对象SITE_URL、ALLOWED_HOSTS这类非敏感值放 ConfigMap。这里有个不太直观的坑POSTHOG_SECRET和ENCRYPTION_SALT_KEYS一旦生成就不该再换——安装脚本重跑时特意保留旧.env就是这个原因K8s 化时同样要保证这两个值跨升级不变。保活手册 四类生产场景怎么处理用户报页面打不开时先curl网关背后的/_health再用docker compose logs webK8s 里对应 Pod 日志看是不是卡在迁移——首启和每次升级后的迁移任务是启动慢的头号原因。事件延迟上涨时链路是采集边缘 → Kafka → 消费者 → ClickHouse查 Kafka 消费 lag 和 ClickHouse 的 part 合并进度瓶颈九成在最后一跳的落盘。ClickHouse 单节点磁盘快写满时提前设 80% 告警动作是配 TTL 让老分区自动过期 扩卷而不是手动删数据破坏表结构。监控失明时web 容器内置 OTEL 环境变量OTEL_EXPORTER_OTLP_ENDPOINT等hobby 栈默认是关掉的生产把它指向自家 collectorRust 服务再暴露 Prometheus 端口挂上 ServiceMonitor指标就补齐了。要恢复备份时日常节奏是每日pg_dump元数据库 对象存储桶同步 ClickHouse 数据目录快照恢复顺序反着来——先 PG、再对象存储、最后 CH别搞反依赖。流量翻倍时先横向扩无状态侧web / worker / 摄取 worker它们扩到顶了再动 ClickHouse动的是副本数而不是单机规格。常见踩坑与自检清单DOMAIN 填了 IPCaddy 自动签发 TLS 会直接失败域名必须是 A 记录指向的 FQDN。事后重跑了密钥生成ENCRYPTION_SALT_KEYS一变历史加密字段全部解不开复用旧.env是脚本的刻意行为不是 bug。内存卡在 4GB安装脚本开头就喊 8GB 红线低于它最先被 OOM 杀掉的通常是 ClickHouse。健康检查 200 但页面报错检查share/GeoLite2-City.mmdb是否下载成功缺了它地域解析会失败。跳过迁移直接换镜像升级必须走官方升级脚本它保证先跑bin/migrate再起进程手搓docker compose up跳过这步会在老 schema 上崩。把 19000/19001 对象存储端口发布到公网S3 端点和控制台都应只对内网开放。日志驱动改成了无轮转模式默认json-file50MB×3 是防日志吃盘的最后防线改之前先想清楚。跑完这份清单你的第一个实例应该已经稳到可以交给团队试用了。参数细节对照官方 self-hosting 文档核对版本升级和疑难杂症去社区论坛提问通常更快。【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
