posthog/posthog-node

PostHog Docker镜像文档

镜像概述

PostHog是一个开源的产品 analytics 平台，提供自托管部署选项，使团队能够完全控制产品数据。该镜像包含PostHog的核心服务，支持用户行为跟踪、事件分析、漏斗转化、用户留存等功能，适用于需要数据隐私保护和自主管理分析工具的组织。

核心功能与特性

• 用户行为跟踪：捕获页面浏览、按钮点击、表单提交等用户交互事件
• 多维度分析：支持事件分析、漏斗分析、留存分析、路径分析等多种分析模型
• 自定义仪表板：可创建个性化数据可视化面板，实时监控关键指标
• 数据隐私控制：自托管模式确保数据存储在用户自有基础设施中，符合数据合规要求
• API与集成：提供REST API和SDK，支持与前端、后端、移动应用等多平台集成
• 开源可扩展：基于开源代码构建，支持自定义插件和功能扩展

使用场景

• 产品团队：分析用户行为，优化产品体验和功能设计
• 创业公司：低成本部署专业分析工具，跟踪增长指标
• 数据敏感型组织：需满足GDPR、CCPA等合规要求的企业自托管部署
• 开发团队：通过API集成快速实现产品数据采集与分析

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name posthog \
  -p 8000:8000 \
  -e DATABASE_URL=postgresql://username:password@postgres-host:5432/posthog \
  -e REDIS_URL=redis://redis-host:6379/0 \
  -e SECRET_KEY=your-secure-secret-key \
  posthog/posthog:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'

services:
  posthog:
    image: posthog/posthog:latest
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/posthog
      - REDIS_URL=redis://redis:6379/0
      - SECRET_KEY=your-secure-secret-key
      - SITE_URL=http://localhost:8000
    depends_on:
      - db
      - redis
    volumes:
      - posthog_data:/var/lib/posthog

  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=posthog
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:6
    volumes:
      - redis_data:/data

volumes:
  posthog_data:
  postgres_data:
  redis_data:

启动服务：

bash
docker-compose up -d

核心配置参数

访问与初始化

1. 部署完成后，通过http://localhost:8000访问PostHog
2. 首次访问需创建管理员账户
3. 按照引导完成事件跟踪代码集成（支持JavaScript、Python、iOS、Android等平台）

数据持久化

PostHog依赖PostgreSQL存储分析数据，Redis存储缓存和队列。建议通过Docker卷（volumes）或外部数据库服务确保数据持久化，避免容器重启导致数据丢失。

升级说明

如需升级PostHog版本，建议先备份数据库，然后更新镜像版本并重启服务：

bash
docker-compose pull posthog
docker-compose up -d