plausible/analytics

Plausible Analytics

镜像概述和主要用途

Plausible Analytics是一款简单、轻量级（<1KB）、开源且隐私友好的网站分析工具，作为Google Analytics的替代方案，它不使用Cookie，完全符合GDPR、CCPA和PECR等隐私***。用户可选择自托管或使用官方云服务，核心使命是通过提供非广告技术背景的分析工具减少企业监控，让网站所有者100%拥有和控制数据。

!Plausible Analytics界面

核心功能和特性

核心优势

• 简洁无冗余：提供简单的网站分析，无需多层菜单和自定义报告，所有关键数据集中在单页展示，无需培训即可使用。
• 隐私合规：仅衡量流量而非个人，不存储个人数据或IP地址，不使用Cookie或持久标识符，完全符合GDPR/CCPA/PECR。
• 轻量级脚本：分析脚本大小仅为Google Analytics的1/45，显著提升网站加载速度。
• 多渠道报告：支持每周/每月电子邮件或Slack报告，可接收流量峰值通知。
• 开放统计选项：默认私有统计数据，可选择公开，允许任何人通过自定义链接查看网站数据。
• 目标与转化追踪：支持将自定义事件或页面URL设为目标，追踪转化趋势，包括出站链接点击和404错误页面。
• 搜索关键词集成：与Google Search Console集成，获取准确的搜索关键词报告。
• SPA支持：自动适配基于pushState的前端路由，也支持哈希路由框架（详见哈希路由文档）。

使用场景和适用范围

适用用户

• 注重用户隐私保护的网站所有者
• 需要合规分析工具以满足GDPR等***要求的企业
• 希望简化数据分析流程、避免复杂配置的个人开发者
• 追求网站性能优化，需要轻量级脚本的站点管理者

部署方式对比

使用方法和配置说明

自托管部署（Docker方式）

前提条件

• Docker和Docker Compose
• 至少1GB RAM的服务器

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: "3.8"

services:
  plausible_db:
    image: docker.xuanyuan.run/postgres:14-alpine
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_DB=plausible
    restart: always

  plausible_events_db:
    image: docker.xuanyuan.run/clickhouse/clickhouse-server:23.3-alpine
    volumes:
      - event-data:/var/lib/clickhouse
      - ./clickhouse/clickhouse-config.xml:/etc/clickhouse-server/config.d/logging.xml:ro
      - ./clickhouse/clickhouse-user-config.xml:/etc/clickhouse-server/users.d/logging.xml:ro
    environment:
      - CLICKHOUSE_PASSWORD=clickhouse
    restart: always

  plausible:
    image: docker.xuanyuan.run/plausible/analytics:latest
    command: sh -c "sleep 10 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run"
    depends_on:
      - plausible_db
      - plausible_events_db
    environment:
      - DATABASE_URL=postgres://postgres:postgres@plausible_db:5432/plausible
      - CLICKHOUSE_DATABASE_URL=http://plausible_events_db:8123/plausible_events_db?password=clickhouse
      - SECRET_KEY_BASE=your-secret-key-here
      - BASE_URL=https://your-plausible-domain.com
      - PORT=8000
    ports:
      - "8000:8000"
    restart: always

volumes:
  db-data:
  event-data:

环境变量说明

• SECRET_KEY_BASE：随机生成的安全密钥（建议使用openssl rand -base64 64生成）
• BASE_URL：Plausible实例的访问URL（需包含http/https）
• DATABASE_URL：PostgreSQL数据库连接地址
• CLICKHOUSE_DATABASE_URL：ClickHouse数据库连接地址
• PORT：服务监听端口

启动服务

bash
docker-compose up -d

访问与配置

1. 访问http://your-server-ip:8000
2. 注册管理员账户并添加网站
3. 根据指引将分析脚本嵌入目标网站

技术架构

• 后端：Elixir/Phoenix应用
• 数据库：PostgreSQL（通用数据）、ClickHouse（统计数据）
• 前端：TailwindCSS（样式）、React（交互仪表盘）

许可证信息

• 主应用：GNU Affero General Public License Version 3 (AGPLv3) 或更高版本，详见https://github.com/plausible/analytics/blob/master/LICENSE.md
• JavaScript跟踪器：MIT许可证，避免AGPL传染性问题，详见https://github.com/plausible/analytics/blob/master/tracker/LICENSE.md

反馈与支持

• 社区反馈：通过反馈看板提交功能建议
• 自托管支持：https://github.com/plausible/analytics/discussions/categories/self-hosted-support%EF%BC%88%E9%9D%9E%E5%AE%98%E6%96%B9%E6%94%AF%E6%8C%81%EF%BC%89
• 赞助支持：通过https://github.com/***/plausible%E8%8E%B7%E5%BE%97%E4%BC%98%E5%85%88%E6%8A%80%E6%9C%AF%E6%94%AF%E6%8C%81