Plausible 隐私友好型网站统计部署教程

Plausible Analytics 是一款轻量级、开源且注重隐私的网站统计工具。整个追踪脚本不到 1KB，不使用 Cookie，不收集任何个人数据，完全符合 GDPR、CCPA 等隐私法规。Plausible 提供了直观的单页统计面板，让你一目了然地了解网站的访问情况。本文将介绍如何在搬瓦工 VPS 上自托管 Plausible。部署前请确保已安装好 Docker 和 Docker Compose。

一、系统要求

操作系统：Ubuntu 20.04+ 或 Debian 11+。
内存：至少 1GB，建议 2GB（ClickHouse 需要一定内存）。
磁盘：至少 10GB 可用空间。
域名：必须绑定域名并配置 SSL。

二、获取配置文件

git clone --depth 1 https://github.com/plausible/community-edition /opt/plausible
cd /opt/plausible

三、配置环境变量

编辑 plausible-conf.env 文件：

cat > /opt/plausible/plausible-conf.env <<'EOF'
BASE_URL=https://stats.yourdomain.com
SECRET_KEY_BASE=your_secret_key_base_at_least_64_chars
TOTP_VAULT_KEY=your_totp_vault_key
DISABLE_REGISTRATION=invite_only

# SMTP 配置（用于邮件验证和报告）
MAILER_EMAIL=noreply@yourdomain.com
SMTP_HOST_ADDR=smtp.example.com
SMTP_HOST_PORT=587
SMTP_USER_NAME=your-email@example.com
SMTP_USER_PWD=your-smtp-password
SMTP_HOST_SSL_ENABLED=false
EOF

生成必要的密钥：

# 生成 SECRET_KEY_BASE（至少 64 字符）
openssl rand -base64 48

# 生成 TOTP_VAULT_KEY
openssl rand -base64 32

四、启动 Plausible

cd /opt/plausible
docker compose up -d

Plausible 会启动以下服务：

Plausible：主应用（Elixir/Phoenix）。
ClickHouse：高性能分析数据库，存储统计事件。
PostgreSQL：存储用户、网站配置等数据。

docker compose ps
docker compose logs -f plausible

五、配置 Nginx 反向代理

apt install nginx certbot python3-certbot-nginx -y

cat > /etc/nginx/sites-available/plausible <<'EOF'
server {
    listen 80;
    server_name stats.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF

ln -s /etc/nginx/sites-available/plausible /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d stats.yourdomain.com

六、注册与初始化

访问 https://stats.yourdomain.com，注册管理员账户。注册完成后建议将 DISABLE_REGISTRATION 设置为 invite_only 或 true 以禁止公开注册。

七、添加网站和追踪脚本

登录后在控制面板中添加网站，然后将生成的追踪脚本添加到你的网站：

<script defer data-domain="yourdomain.com" src="https://stats.yourdomain.com/js/script.js"></script>

Plausible 提供了多种追踪脚本变体来满足不同需求：

script.js：基础版本，仅追踪页面浏览。
script.tagged-events.js：支持自定义事件追踪。
script.outbound-links.js：追踪外链点击。
script.file-downloads.js：追踪文件下载。
script.hash.js：支持单页应用的 Hash 路由。

可以组合使用：

<script defer data-domain="yourdomain.com" src="https://stats.yourdomain.com/js/script.tagged-events.outbound-links.js"></script>

八、目标转化追踪

在网站设置中可以配置目标（Goals），追踪特定的用户行为：

页面访问目标：当用户访问特定页面时触发，例如 /thank-you。
自定义事件目标：通过 JavaScript 触发自定义事件。

// 在按钮上添加自定义事件追踪
<button onclick="plausible('Signup')">注册</button>

// 或使用 CSS 类名方式
<button class="plausible-event-name=Signup">注册</button>

九、邮件报告

配置好 SMTP 后，Plausible 可以定期发送统计报告邮件。在网站设置中可以配置每周或每月的邮件报告，自动发送到指定邮箱。

十、数据备份

# 备份 PostgreSQL
docker exec plausible-plausible_db-1 pg_dump -U postgres plausible_db > /opt/plausible/backup_pg_$(date +%Y%m%d).sql

# 备份 ClickHouse 数据目录
tar -czf /opt/plausible/backup_ch_$(date +%Y%m%d).tar.gz /opt/plausible/clickhouse/

十一、常见问题

追踪脚本被广告拦截器屏蔽

可以通过 Nginx 代理追踪脚本来规避广告拦截器：

# 在你网站的 Nginx 配置中添加
location = /js/script.js {
    proxy_pass https://stats.yourdomain.com/js/script.js;
    proxy_set_header Host stats.yourdomain.com;
}
location = /api/event {
    proxy_pass https://stats.yourdomain.com/api/event;
    proxy_set_header Host stats.yourdomain.com;
    proxy_buffering off;
}

ClickHouse 内存占用高

对于小型网站，可以限制 ClickHouse 的内存使用。在 clickhouse/config.xml 中设置：

<max_server_memory_usage_to_ram_ratio>0.5</max_server_memory_usage_to_ram_ratio>

总结

Plausible 是一款出色的隐私友好型网站统计工具，追踪脚本极其轻量，不会影响网站加载速度。在搬瓦工 VPS 上自托管 Plausible 后，你可以完全掌控统计数据，无需依赖第三方服务。更多教程请参考：Umami 统计部署、Dashy 仪表板部署、Docker 安装教程。选购搬瓦工 VPS 请参考全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。