跳转至

Plausible网站分析 — Plausible开源分析

一句话概述:Plausible 是开源、隐私优先的网站分析工具,不用 Cookie、不追踪用户、天然符合 GDPR,一个页面看完所有数据,是 Google Analytics 的轻量替代品。

核心知识点速查表

概念白话解释
Plausible隐私优先的网站流量分析工具
无 Cookie不用 Cookie 就能统计访客,不需要弹同意框
GDPR 合规天然符合欧盟隐私法规,数据存在欧洲
事件追踪追踪按钮点击、表单提交等用户行为
目标转化设定目标(如注册),看多少访客完成了

当前版本信息(2026年)

信息详情
版本Plausible 2.0
云服务€9/月起(10K 页面浏览/月)
自托管免费(Community Edition,AGPL-3.0)
后端Elixir + ClickHouse
官网https://plausible.io
GitHub Stars22,000+

安装配置

云服务(最简单)

1. 访问 https://plausible.io/register 注册
2. 添加网站域名
3. 获取追踪代码,粘贴到网页 <head> 中:
<!-- 在网页 <head> 中添加(仅1KB大小) -->
<script defer data-domain="yourdomain.com"
  src="https://plausible.io/js/script.js">
</script>

自托管部署(Docker Compose)

# 克隆托管仓库
git clone https://github.com/plausible/community-edition.git
cd community-edition

# 配置环境变量
cp .env.example .env
# 编辑 .env:
# BASE_URL=https://analytics.yourdomain.com
# SECRET_KEY_BASE=$(openssl rand -base64 48)

# 启动
docker compose up -d

# 访问 http://localhost:8000
# 首次使用需要注册管理员账号

# 最低要求:2GB RAM + Docker

事件追踪配置

<!-- 启用自定义事件追踪 -->
<script defer data-domain="yourdomain.com"
  src="https://plausible.io/js/script.tagged-events.js">
</script>

<!-- 追踪按钮点击 -->
<button class="plausible-event-name=Signup+Click">
  注册
</button>

<!-- 追踪链接点击 -->
<a href="/download"
   class="plausible-event-name=Download+Click">
  下载
</a>
// JavaScript API 追踪自定义事件
plausible('Signup', {props: {plan: 'premium'}})   // 注册事件
plausible('Download', {props: {file: 'report.pdf'}}) // 下载事件

基本使用

仪表板功能

# Plausible 仪表板一个页面显示所有关键指标:
# - 独立访客数(Unique Visitors)
# - 页面浏览量(Pageviews)
# - 跳出率(Bounce Rate)
# - 访问时长(Visit Duration)
# - 流量来源(Top Sources)
# - 热门页面(Top Pages)
# - 访客地区(Countries)
# - 设备类型(Devices)
# - 操作系统/浏览器

# 时间范围选择:
# 今天、昨天、7天、30天、12个月、自定义

目标转化设置

# 在 Plausible 设置中添加目标:
# 1. Pageview Goal — 访问特定页面算转化
#    例:/thank-you 页面 → 订单完成
# 2. Custom Event Goal — 自定义事件算转化
#    例:Signup 事件 → 用户注册
# 3. Revenue Goal — 带金额的转化

API 使用

# Plausible 提供 REST API 访问数据
# 获取实时访客数
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://plausible.io/api/v1/stats/realtime/visitors?site_id=yourdomain.com"

# 获取聚合数据
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://plausible.io/api/v1/stats/aggregate?site_id=yourdomain.com&period=30d&metrics=visitors,pageviews,bounce_rate"

高级用法

UTM 参数追踪

# Plausible 自动识别 UTM 参数:
# https://yourdomain.com/?utm_source=twitter&utm_medium=social&utm_campaign=launch

# 在仪表板的 Sources 中可以看到:
# Source: twitter
# Medium: social
# Campaign: launch

排除自己的访问

<!-- 方法1:在浏览器控制台设置 localStorage -->
<script>localStorage.plausible_ignore = true;</script>

<!-- 方法2:用 script.exclusions.js 排除特定页面 -->
<script defer data-domain="yourdomain.com"
  data-exclude="/admin/**"
  src="https://plausible.io/js/script.exclusions.js">
</script>

自定义域名(防广告拦截)

# 广告拦截器可能拦截 plausible.io 的脚本
# 解决方案:用自己的域名代理
# 1. 设置反向代理:analytics.yourdomain.com → plausible.io
# 2. 修改脚本地址:
# <script src="https://analytics.yourdomain.com/js/script.js"
#   data-api="https://analytics.yourdomain.com/api/event">
# </script>

常见报错与解决

问题原因解决方案
数据不显示脚本没加载检查 F12 Network 中脚本是否加载
被广告拦截AdBlock 拦截使用自定义域名代理
数据偏低DNT 设置Plausible 尊重 Do Not Track
自托管无数据ClickHouse 没启动检查 docker compose logs
API 401Token 错误在 Settings → API 中重新生成

速查表

<!-- ===== 基本追踪 ===== -->
<script defer data-domain="site.com" src="https://plausible.io/js/script.js"></script>

<!-- ===== 扩展脚本 ===== -->
script.js                    -- 基本追踪
script.tagged-events.js      -- 自定义事件
script.exclusions.js          -- 页面排除
script.outbound-links.js      -- 外链点击追踪
script.file-downloads.js      -- 文件下载追踪
script.hash.js               -- SPA hash 路由

<!-- 组合多个功能 -->
script.tagged-events.outbound-links.file-downloads.js

同类工具对比

特性PlausibleUmamiGoogle AnalyticsMatomo
隐私保护✅ 极强✅ 强❌ 追踪用户✅ 中
无 Cookie可选
脚本大小<1KB<2KB~45KB~22KB
自托管✅ 免费✅ 免费✅ 免费
云服务价格€9/月起免费额度免费$19/月
功能复杂度简单简单复杂复杂
适用场景博客/小站博客/小站企业企业

总结:Plausible 是隐私优先的简洁分析工具,不需要 Cookie 同意横幅,一个页面看完所有数据。适合个人博客、开源项目、小型网站。如果需要复杂的用户行为分析,还是要用 Matomo 或 PostHog。