个人Plausible搭建记录

Plausible Analytics是一个开源、轻量级且注重隐私的网站分析工具，与谷歌分析相比有以下优势：

  • 轻量级：仅2KB大小，比谷歌分析小45倍
  • 无cookie：默认不使用cookie，无需烦人的cookie通知横幅
  • 尊重隐私：不收集个人数据，完全符合GDPR、CCPA等法规
  • 开源透明：代码完全开源，可自行审查
  • 简洁界面：一页式仪表板，关键指标一目了然
  • 自托管选项：完全控制自己的数据
plausible

一、准备工作

  • 一台云服务器（我使用的是腾讯云服务器，目前有活动(截止2025-04-30)，境外服务器99/年，系统镜像选Ubuntu Server 22.04 LTS）
  • 一个域名（我是Spaceship上买的，随便挑了个，十几块钱一年）
  • 基本的命令行操作知识
plausible

二、服务器部署Plausible

Plausible提供了Docker部署方式，非常便捷。下面是核心步骤：

  1. 安装Docker和Docker Compose

    sudo apt update
sudo apt install docker.io docker-compose

  2. 创建Plausible配置目录

    mkdir -p plausible
cd plausible

  3. 下载Docker配置文件

    wget https://raw.githubusercontent.com/plausible/hosting/master/docker-compose.yml
wget https://raw.githubusercontent.com/plausible/hosting/master/plausible-conf.env

  4. 修改配置文件 在plausible-conf.env中设置基本参数，包括管理员邮箱、网站域名等。

  5. 启动Plausible服务

    docker-compose up -d

这样，Plausible服务就会在服务器的8000端口上运行。


三、解决HTTPS访问问题

为了保证分析脚本能在HTTPS网站上正常加载，我们需要为Plausible配置安全访问，推荐Cloudflare：

  1. 注册Cloudflare账户，如果没有Cloudflare账号，需要先注册一个，然后添加域名
plausible
  1. 设置DNS记录
    • 添加A记录，将 你的域名 指向服务器IP
    • 确保代理状态是"已代理"（橙色云图标）
plausible
  1. 配置SSL/TLS
    • 在Cloudflare控制面板中设置SSL/TLS为"灵活"模式
    • 这样，用户到Cloudflare是HTTPS，Cloudflare到服务器是HTTP
plausible
  1. 更改域名服务器
    • 在域名注册商处，将DNS服务器指向Cloudflare提供的名称服务器(截图中的两个NS值)
    • 等待DNS生效（官方说需要24小时，但实测下来基本都很快，通常几秒到几分钟）
plausible

四、配置Nginx反向代理

为了将域名请求正确转发到Plausible服务，需要配置Nginx：

  1. 创建Nginx配置文件

    sudo nano /etc/nginx/sites-available/你的域名

  2. 添加以下配置

    server {
    listen 80;
    server_name 你的域名;
    
    location / {
        proxy_pass http://localhost: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;
        
        # WebSocket支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 86400;
    }
}

  3. 启用配置并重启Nginx

    sudo ln -s /etc/nginx/sites-available/你的域名 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

五、将Plausible集成到网站

最后一步是将分析脚本添加到您的网站。以Next.js为例：

  1. 创建Plausible.tsx组件

    // src/components/analytics/Plausible.tsx
'use client'

import Script from 'next/script'

export function Plausible() {
  return (
    <>
      <Script
        defer
        data-domain="当前网站域名"
        src="https://你部署的Plausible域名.com/js/script.js"
        strategy="afterInteractive"
      />
      <Script id="plausible-setup" strategy="afterInteractive">
        {`
          window.plausible = window.plausible || function() { 
            (window.plausible.q = window.plausible.q || []).push(arguments) 
          }
        `}
      </Script>
    </>
  )
}

export default Plausible

  2. 在应用中引入组件

    // src/app/layout.tsx
import { Plausible } from '@/components/analytics/Plausible'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Plausible />
      </body>
    </html>
  )
}

  3. 验证集成

    • 访问您的网站
    • 登录Plausible仪表板查看数据是否正常收集

常见问题排查

在部署过程中，您可能会遇到一些问题：

  1. HTTPS证书问题

    • 确保Cloudflare SSL/TLS设置正确
    • 或检查服务器证书是否正确安装

  2. WebSocket连接错误

    • 检查Nginx配置是否包含WebSocket支持代码
    • 确保Cloudflare设置允许WebSocket连接

  3. DNS解析问题

    • 使用nslookup命令验证域名是否正确解析到服务器IP
    • 耐心等待DNS生效（最多24小时）

效果图

plausible