↓跳到主要内容
  1. 所有文章/

简单、隐私友好的谷歌分析替代品，Plausible 自托管部署指南

·1874 字·约 4 分钟
程序部署 Linux Docker Cloudflare SEO Blog
本文目录

前言 #

Umami 是一个很棒的自托管网站统计服务，我使用它快一年了。目前为止它仍然无法在 ARM 架构的服务器上部署，此前我一直使用 Vercel + Supabase 托管它。

Umami
Umami

Umami 用于统计的 JavaScript 脚本体积接近 3KB

Umami.js
Umami.js

介绍 #

最近我瞄上了易于使用和隐私友好的谷歌分析替代品──Plausible｜演示地址，他们提供付费托管服务，但也开放源码让用户可以自行托管。Plausible 比 Umami 还要轻量很多，用于统计的脚本体积只有 1KB 左右。

Plausible.js
Plausible.js

为了方便用户自部署，他们甚至专门开了个编排容器及相关配置的仓库 plausible/hosting，此前有用户要求的 ARM64 架构的也早就上线了，非常 Nice 有没有 🤗！

先决条件

  • 已安装 Docker
  • 已安装 Docker Compose
  • 已安装 Nginx

准备 #

plausible/hosting 的有些服务我们用不上，我删除了

SSH 登录服务器，下载所需文件

mkdir plausible && cd plausible \
&& wget https://blog.dejavu.moe/posts/plausible-selfhosted-with-docker-complete-guide/plausible.tar.gz

解压文件

tar -xzvf plausible.tar.gz \
&& rm plausible.tar.gz

现在这个文件目录应该是这样的

.
├── README.md	# 备注
├── clickhouse  # Clickhouse
│   ├── clickhouse-config.xml
│   └── clickhouse-user-config.xml
├── docker-compose.yml
├── geoip	# GeoIP 相关配置
│   └── geoip.conf
└── plausible-conf.env	# Plausible 环境变量

使用 GeoLite2

Plausible 默认使用 dbip 的 GeoIP 数据库，也可以使用 MaxMind 提供的 GeoLite2 数据库，步骤如下：

关闭代理，点击 注册 GeoLite2 链接，填写必要的信息，提交 1

Signup
Signup

收到有设置密码的邮件

Signin
Signin

登录后就可以创建 GeoLite2 API Key 了

GeoLite2
GeoLite2

提交后，复制 Account ID 和 License key 写到 geoip/geoip.conf 里保存。

GEOIPUPDATE_ACCOUNT_ID=123456
GEOIPUPDATE_LICENSE_KEY=abcdEFCDhijklmop

编辑 Plausible 的环境变量文件 plausible-conf.env

DISABLE_REGISTRATION=true  # 禁止用户注册
BASE_URL=https://stats.dejavu.moe  # 部署 Plausible 的 BaseURL
SECRET_KEY_BASE=FhNHzoWJyoQgT21RsFQG+KUzJ/o5YbKsszc6CMOArA0OXxjZ763oCGiItOPlKJAfIQO0uov8xt8p5k+MqtmtOQ==

生成一串随机字符，写到上面的 SECRET_KEY_BASE 里

openssl rand -base64 64 | tr -d '\n' ; echo

// 示例输出
FhNHzoWJyoQgT21RsFQG+KUzJ/o5YbKsszc6CMOArA0OXxjZ763oCGiItOPlKJAfIQO0uov8xt8p5k+MqtmtOQ==

部署 #

现在可以开始部署了

sudo docker compose up -d

在 Cloudflare 生成一个源服务器证书 2，并安装，更多帮助。下面是一个示例 Nginx 配置文件

server {
    listen 80;
    listen [::]:80;
    # 替换为您的域名
    server_name plausible.your.domain;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    # 替换为您的域名
    server_name plausible.your.domain;

    access_log /var/log/nginx/plausible.access.log;
    error_log /var/log/nginx/plausible.error.log;
		
    # 替换为您的实际（源服务器）SSL 证书路径
    ssl_certificate /etc/nginx/cert/xxx.your.domain.pem;
    ssl_certificate_key /etc/nginx/cert/xxx.your.domain.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 5m;
    ssl_ciphers 'TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256:TLS13-AES-128-CCM-8-SHA256:TLS13-AES-128-CCM-SHA256:EECDH+AESGCM:EDH+AESGCM:EECDH+CHACHA20:EDH+CHACHA20:EECDH+AES128:EDH+AES128:EECDH+AES256:EDH+AES256:EECDH+3DES:EDH+3DES:RSA+AESGCM:RSA+AES:RSA+3DES:!aNULL:!MD5:!DSS';

    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-Proto https;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_redirect off;
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
    }
}

检查 Nginx 配置文件

sudo nginx -t

重载配置文件

sudo systemctl reload nginx

现在在 Cloudflare 控制台将 DNS 解析到服务器 IP 即可访问啦，第一次访问创建的用户即是管理员，登录后，就可以添加网站了。

Setup
Setup

添加发信邮箱【可选】 #

使用外部 SMTP 发信邮箱，编辑 Plausible 环境变量文件

vim plausible-conf.env

添加下面内容

MAILER_EMAIL=plausible@your.domain	# 发信邮箱
SMTP_HOST_ADDR=smtp.your.domain	# SMTP 主机名
SMTP_HOST_PORT=625	# SMTP 端口
SMTP_USER_NAME=plausible@your.domain	# 发信邮箱用户名
SMTP_USER_PWD=admin1234567890	# 发信邮箱密码
SMTP_HOST_SSL_ENABLED=true	# 是否启用 SSL？
SMTP_RETRIES=2	# 发信重试次数

然后重启容器

sudo docker compose down --remove-orphans \
&& sudo docker compose up -d

没问题的话可以去 Plausible 后台开启每周／每月／异常流量邮件报告，当然这个邮箱也可以在你忘记密码的时候用来重置密码 🤤

SMTP
SMTP

重写路径【建议】 #

Plausible 是一个极其尊重隐私的网站统计服务，它：

  • 与广告技术和监视资本主义无关
  • 不收集任何个人数据，所有统计数据仅为汇总数据
  • 没有跨站点或跨设备跟踪
  • 您 100% 拥有您的网站数据，不会将其发送、共享或出售给任何第三方
  • 完全开源的网络分析软件，可以自行托管

即使如此，它 仍然 被一些广告过滤器规则所屏蔽，作为网站管理员，我们可以使用反向代理脚本和 API 路由来减少被广告过滤器误杀的风险，按照官网文档，至少可以使用的是：

我的服务依赖 Cloudflare，但 Cloudflare Workers 每日请求数有限制，因此在本文中，我会使用 Cloudflare 转换规则 下面的 重写 URL 规则 来完成这个过程，它实施起来非常容易。

在 Plausible 控制台获取到站点统计的脚本示例如下

<script defer
  data-domain="blog.your.domain"
  src="https://plausible.your.domain/js/script.js"
></script>

其中：

  • plausible.your.domain 是您部署 Plausible 的域名
  • blog.your.domain 是您安装 Plausible 统计脚本的域名

创建重写 URL 规则

Add Rewrite Rules
Add Rewrite Rules

规则名称随便填，传入请求匹配自定义筛选表达式

Rewrite Script Rule.webp
Rewrite Script Rule.webp

同理，再添加一条规则，重写 API 路由

Rewrite API Rule.webp
Rewrite API Rule.webp

接下来，修改安装到被统计站点的脚本如下：

<script defer
  src="https://plausible.your.domain/js/vue.min.js"
  data-api="https://plausible.your.domain/stats/car/benz"
  data-domain="blog.your.domain"
></script>

如果您的站点使用 Plausible 的其他 统计脚本拓展 也按照上面修改就可以。

统计关键词【可选】 #

Plausible 支持集成 Google Search Console，可以获得通过搜索引擎得到的关键词统计，详细配置流程可参阅 Plausible 文档，步骤如下：

将 Client ID 和 Client Secret 添加到 Plausible 环境变量文件里

GOOGLE_CLIENT_ID=xxxx
GOOGLE_CLIENT_SECRET=yyyy

重启容器即可

sudo docker compose down --remove-orphans \
&& sudo docker compose up -d

之后在 Plausible 配置下 Google 集成即可

Google Integration
Google Integration

城市精细度【可选】 #

Plausible 的 v1.5.1 版本新增一条可选配置项，完成这步可获得精细度达到省（州）到具体城市的统计效果，但会额外消耗 1GB 左右的 RAM，请酌情选择。

在前面部署好 Plausible 服务后，进入 geoip 文件夹，下载所需数据库

cd geoip
curl -O https://s3.eu-central-1.wasabisys.com/plausible-application/geonames.csv
# 将 LNpsJCCKPis6XvBP 替换为您的 GeoLite2 API Key
export MAXMIND_LICENSE_KEY=LNpsJCCKPis6XvBP
curl -L "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=${MAXMIND_LICENSE_KEY}&suffix=tar.gz" -o geolite2-city.mmdb.gz
gunzip geolite2-city.mmdb.gz

回到 Plausible 根目录

cd ..
# 编辑环境变量
vim plausible-conf.env
# 添加下面两行
GEONAMES_SOURCE_FILE=/etc/app/geonames.csv
IP_GEOLOCATION_DB=/etc/app/geolite2-city.mmdb

编辑 docker-compose.yml 文件

vim docker-compose.yml
# 添加两行（有 + 标记的两行）
 plausible:
    image: plausible/analytics:latest
    restart: always
    command: sh -c "sleep 10 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run"
    ...
    volumes:
       - ./geoip:/geoip:ro
+      - ./geoip/geonames.csv:/etc/app/geonames.csv:ro
+      - ./geoip/geolite2-city.mmdb:/etc/app/geolite2-city.mmdb:ro

重新创建容器即可

sudo docker compose down && sudo docker compose up -d

参考信息

  1. 尽量使用 Gmail、Outlook 等邮箱，我第一次用域名邮箱注册失败了 😂 ↩︎

  2. 非必需，您也可以使用其他方式部署 SSL 证书 ↩︎

Dejavu Moe
作者
Dejavu Moe
Not for success, just for growing.
←→ 服务器使用 Cloudflare CDN 的最佳实践 我是如何建立自己的个人博客的？ →←
↑