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

最新推荐文章于 2025-05-22 16:00:00 发布

运维之美

最新推荐文章于 2025-05-22 16:00:00 发布

阅读量1.2k

点赞数

文章标签：服务器 linux 运维

原文链接：https://mp.weixin.qq.com/s?__biz=MzI3MTI2NzkxMA==&mid=2247524802&idx=1&sn=0fa1a63cffea59ca775d5a17cc75434f&chksm=eac640ebddb1c9fdd614ab69765f52da1631f8bbb3f29f5deb11db6a0002fc1da2a2dbf2d611&scene=126&sessionid=0

版权

公众号关注「奇妙的 Linux 世界」

设为「星标」，每天带你玩转 Linux ！

前言

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

Umami

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

Umami.js

介绍

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

Plausible.js

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

先决条件

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

准备

❝
plausible/hosting^[4] 的有些服务我们用不上，我删除了。

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

mkdir plausible && cd plausible \
&& wget https://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^[5] 的 GeoIP 数据库，也可以使用 MaxMind 提供的 GeoLite2 数据库，步骤如下：

关闭代理，点击注册 GeoLite2^[6] 链接，填写必要的信息，提交。

Signup

收到有设置密码的邮件：

Signin

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

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^[7]，并安装，更多帮助^[8]。下面是一个示例 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:8088;
        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

添加发信邮箱【可选】

使用外部 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

重写路径【建议】

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

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

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

Cloudflare Workers^[10]
Akamai^[11]
Netlify^[12]
Vercel^[13]
CloudFront^[14]
Nginx^[15]
Caddy^[16]

我的服务依赖 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

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

Rewrite Script Rule

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

Rewrite API Rule

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

<script
  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 的其他统计脚本拓展^[17] 也按照上面修改就可以。

统计关键词【可选】

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

在 Google Cloud Console^[20] 创建一个新项目；
配置 OAuth 同意屏幕；
创建一个 OAuth 客户端，获取 Client ID 和 CLIENT SECRET；
启用 Google Search Console API^[21]。

将 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

城市精细度【可选】

Plausible 的 v1.5.1^[22] 版本新增一条可选配置项，完成这步可获得精细度达到省（州）到具体城市的统计效果，但会额外消耗 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

参考信息

Getting started | Plausible docs^[23]

引用链接

[1]

Plausible: https://plausible.io/

[2]

演示地址: https://plausible.io/plausible.io

[3]

plausible/hosting: https://github.com/plausible/hosting

[4]

plausible/hosting: https://github.com/plausible/hosting

[5]

dbip: https://db-ip.com/

[6]

[7]

2: https://dejavu.moe/posts/plausible-selfhosted-with-docker-complete-guide/#fn:2

[8]

更多帮助: https://dejavu.moe/posts/best-server-security-practices-with-cloudflare/#源服务器证书

[9]

仍然: https://plausible.io/docs/proxy/introduction

[10]

Cloudflare Workers: https://plausible.io/docs/proxy/guides/cloudflare

[11]

Akamai: https://plausible.io/docs/proxy/guides/akamai

[12]

Netlify: https://plausible.io/docs/proxy/guides/netlify

[13]

Vercel: https://plausible.io/docs/proxy/guides/vercel

[14]

CloudFront: https://plausible.io/docs/proxy/guides/cloudfront

[15]

Nginx: https://plausible.io/docs/proxy/guides/nginx

[16]

Caddy: https://plausible.io/docs/proxy/guides/caddy

[17]

统计脚本拓展: https://plausible.io/docs/script-extensions

[18]

Google Search Console: https://search.google.com/search-console/

[19]

Plausible 文档: https://plausible.io/docs/google-search-console-integration

[20]

Google Cloud Console: https://console.developers.google.com/

[21]

Google Search Console API: https://console.developers.google.com/apis/api/searchconsole.googleapis.com

[22]

v1.5.1: https://github.com/plausible/analytics/releases/tag/v1.5.1

[23]

Getting started | Plausible docs: https://plausible.io/docs/self-hosting

复制搜一搜转发收藏赞

本文转载自：「Déjà Vu 的博客」，原文：https://tinyurl.com/mwxttat5，版权归原作者所有。欢迎投稿，投稿邮箱: editor@hi-linux.com。

最近，我们建立了一个技术交流微信群。目前群里已加入了不少行业内的大神，有兴趣的同学可以加入和我们一起交流技术，在 「奇妙的 Linux 世界」 公众号直接回复 「加群」 邀请你入群。

你可能还喜欢

点击下方图片即可阅读

eTempMail: 一款免费的临时教育邮箱

点击上方图片，『美团|饿了么』外卖红包天天免费领

更多有趣的互联网新鲜事，关注「奇妙的互联网」视频号全了解！