Plausible网站分析工具

配套个人网站构建,我们需要一个网站分析工具来了解自己和其他访问者的偏好,了解哪些文章是最受欢迎的等等。

Plausible 是一个开源、轻量级的网站分析工具,它尊重用户隐私并且提供实用的网站访问数据。与其他分析工具相比,Plausible 设计的目的是提供一个简洁、用户友好且不侵犯用户隐私的分析方案。

安装部署 Plausible

克隆官方Docker仓库

首先,打开你的终端,执行以下命令来克隆 Plausible 的官方 hosting 仓库,并切换到仓库目录中:

git clone https://github.com/plausible/hosting
cd hosting

生成秘钥

Plausible 需要一个秘钥来保障通信安全。运行下面的命令生成一个随机秘钥:

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

配置环境变量

使用你喜欢的文本编辑器打开 plausible-conf.env 文件,并填入刚才生成的秘钥以及你的域名:

BASE_URL=https://plausible.example.com # 更换为你的域名
SECRET_KEY_BASE=生成的秘钥

启动服务

:::caution 如果不使用官方提供的 Caddy 服务,你需要自行配置 Nginx 或者其他反向代理服务。并在 docker-compose.yml 文件中修改 plausible 服务的 ports 参数。

yaml
// docker-compose.yml

plausible:
    ports:
-   - "127.0.0.1:8000:8000" 
+   - "8000:8000"

:::

返回到终端,执行以下命令来启动 Plausible 服务:

docker-compose up -d

Astro 博客集成

为了在 Astro 博客中使用 Plausible 进行网站访问分析,需要对 astro.config.mjs 文件进行如下修改:

starlight({
    head: [
        {
            tag: 'script',
            attrs: {
                src: 'https://plausible.example.com/js/plausible.js',
                'data-domain': 'example.com',
                defer: true,
            },
        },
    ],
});

以上代码将 Plausible 的追踪脚本添加到 Astro 博客中。请确保替换 src 中的 URL 为你的 Plausible 实例 URL,同时将 'data-domain' 的值更改为你的域名。

效果演示

由于网站尚未开放到公网,截图中的访问量都是自己查看时产生的。

plausible