Rybbit 接入 Halo 教程：开源隐私友好的流量分析工具

什么是 Rybbit？

Rybbit 是一款开源的现代化网站分析工具，定位为 Google Analytics 的隐私友好替代方案。除了基础的页面浏览量、访客数、来源渠道等统计之外，Rybbit 还提供了会话回放、漏斗分析、用户旅程、留存分析、错误追踪等进阶功能，数据展示更加直观，适合对流量分析有较高要求的站点。

相比 Google Analytics，Rybbit 有以下几个优势：

隐私友好：不使用 Cookie，不收集个人身份信息，符合 GDPR 等隐私法规
开源可自托管：数据完全掌握在自己手中
功能丰富：会话回放、漏斗、用户旅程、留存分析等进阶功能开箱即用
实时仪表盘：实时查看当前在线访客和页面浏览情况
界面现代：交互体验比 GA4 更加直观

查看在线演示

部署 Rybbit

方式一：使用 Rybbit Cloud

如果不想自行维护服务器，可以直接使用 Rybbit Cloud。Rybbit Cloud 提供 7 天免费试用，之后需要按需订阅，可以根据实际的月页面浏览量和功能需求选择合适的套餐。

注册账号后即可直接使用，无需任何部署操作。

方式二：自托管

使用一键安装脚本（推荐新服务器）

如果你打算为 Rybbit 单独准备一台服务器，推荐使用官方提供的一键安装脚本。该脚本会自动配置好 Docker 容器、Caddy 反向代理和 HTTPS 证书，无需手动操作。

前提条件

一台至少 2GB 内存的服务器（推荐 Ubuntu 24 LTS）
一个已解析到该服务器 IP 的域名或子域名（HTTPS 是必须的，否则浏览器会拦截追踪脚本）

安装步骤

安装 Docker Engine，参考 Docker 官方文档

克隆 Rybbit 仓库

 git clone https://github.com/rybbit-io/rybbit.git
 cd rybbit

赋予脚本执行权限
```
 chmod +x *.sh
```
运行安装脚本，将 your.domain.name 替换为你的域名
```
 ./setup.sh your.domain.name
```
脚本会自动生成配置、启动容器，并由 Caddy 自动申请 SSL 证书，首次运行需要几分钟时间。
等待 DNS 解析生效后，访问 https://your.domain.name/signup 创建管理员账号即可开始使用。

使用已有的反向代理服务器

如果你的服务器上已经运行了 Nginx 等反向代理，可以在启动 Rybbit 时跳过内置的 Caddy，自行配置反向代理。

启动 Rybbit（禁用内置 Web 服务器）

./setup.sh your.domain.name --no-webserver

此命令会暴露两个端口：

3001：后端 API 服务
3002：前端客户端

Nginx 配置示例

server {
    listen 80;
    server_name your.domain.name;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your.domain.name;

    ssl_certificate /etc/letsencrypt/live/your.domain.name/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your.domain.name/privkey.pem;

    location /api/ {
        proxy_pass http://localhost:3001;
        proxy_set_header HOST $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location / {
        proxy_pass http://localhost:3002;
        proxy_set_header HOST $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

在 Rybbit 中创建监控网站

创建完成之后，页面会提供一段类似于下面形式的代码：

<script
    src="https://<your-domain>/api/script.js"
    data-site-id="078bd4c1f97d"
    defer
></script>

复制这段代码，接下来将其配置到 Halo 中。

在 Halo 中配置追踪代码

保存后，访问你的站点任意页面，回到 Rybbit 控制台即可看到实时数据。

推荐订阅源

Halo - 强大易用的开源建站工具