Swetrix 介绍与选型指南

目标：为「隐私优先网站分析平台」的选型提供一份以官方一手资料为依据的认知与决策参考——讲清 Swetrix 是什么、架构如何组成、社区版与云服务的能力边界，并给出与 Google Analytics 4、Plausible、Umami、Aptabase、Rybbit 等同类产品的量化对比。本文全部信息来自 Swetrix 官网（swetrix.com）、官方文档站与 GitHub 仓库 Swetrix/swetrix 的公开溯源，检索日期为 2026-10-30，未包含任何本地推断数据。

一、环境信息

本文为认知与选型篇，信息取证方式如下：

• 取证方式：官网 swetrix.com、官方文档站（swetrix.com/docs，文档源码同步维护于主仓库 docs/content/ 目录）、GitHub 仓库 Swetrix/swetrix（README、Releases）、Docker Hub（swetrix/swetrix-api、swetrix/swetrix-fe）、shields.io 徽章接口。
• 取证日期：2026-10-30。
• 官方最新稳定版：v5.4.1（GitHub Releases 显示发布于 2026-08-04；浏览器端跟踪脚本 tracker-js 当前为 4.8.0，服务端跟踪库 tracker-node 当前为 3.5.0，取自仓库 releases.atom 订阅源）。
• Docker Hub 镜像 tag：swetrix/swetrix-api 当前 tags 依次为 latest、v5.4.1、v5.3.1、v5.2.2、v5.2.1、v5.2.0、v5.1.1、v5.1.0、v5.0.3、v5.0.2（Docker Hub tags 接口实查），与 GitHub 版本节奏一致。
• 社区活跃度：GitHub 星数约 1.2k（shields.io 实时徽章，2026-10-30 查询）；项目自 2021 年开源，由英国公司 Swetrix Ltd 维护，商业上完全自举（bootstrapped），无外部融资，靠云服务订阅收入反哺开源开发。
• 开源许可：AGPL-3.0（仓库 LICENSE 与 README 徽章）。

💡 说明：GitHub 对未认证的 API 调用有严格限流，本文星数与版本号分别取自 shields.io 徽章与 releases.atom 订阅源这两个不限流的官方渠道，数据口径与仓库页面一致。

二、软件概述

Swetrix 是一款无 Cookie、符合 GDPR 的开源网站分析平台，定位是 Google Analytics 的隐私尊重型替代品。官方 README 对其的一句话概括是：无 Cookie、无需同意横幅、无跨设备追踪、数据全部匿名化，仪表盘快速且实时。除基础的页面浏览统计外，它把错误追踪（Error tracking）、性能监控（Performance monitoring）、会话回放（Session replays）、漏斗（Funnels）与自定义事件（Custom events） 打包进同一个产品，官方的差异化主张正是「用一个工具替代多件套」。

几个关键身份信息：

对「无 Cookie 追踪如何识别独立访客」这一读者最常问的问题，官方 Events API 文档给出了机制说明：API 依赖访客 IP 地址与 User-Agent 计算出一个加盐哈希的临时会话，该哈希在最后一次交互 30 分钟后（或当日 UTC 零点，以先到者为准）从数据库永久删除；IP 永远不以原始形式存储，仅用于计算临时会话与填充地理位置报表。数据库中不保存任何可识别访客身份的信息。

💡 技术拓展：无 Cookie 追踪并非 Swetrix 独有，业界主要有三类实现思路——

思路	原理	代表产品	取舍
IP+UA 哈希临时会话	用访客 IP 与浏览器指纹拼盐做短时效哈希，不落原始值	Swetrix、Plausible、Umami	无需同意横幅；跨设备/跨浏览器无法关联
首方 Cookie	站点域种第一方 Cookie 标识访客	Matomo（默认）	识别更稳；部分辖区仍需同意提示
指纹识别	采集设备特征生成稳定 ID	部分 SaaS 分析	精度高但隐私争议大，GDPR 风险高

Swetrix 采用第一类，并按官方口径在服务端 30 分钟后销毁哈希，属于对隐私最保守的实现。

三、核心架构

根据官方自托管文档（swetrix.com/docs/selfhosting/how-to，2026-10-30 版）与 v5.4.1 源码仓库，Swetrix 的部署形态是一套由统一入口路由的多服务 Web 系统：

v5 的一个重要架构变化是单入口路由：不再向前端与后端分别暴露两个公网服务，而是只暴露一个 Web 入口，/ 走前端、/backend/ 在内部转发给 API（自托管编排中的 nginx 与 Traefik 配置均遵循此约定，对应的环境变量为 CLIENT_IP_HEADER，见官方 Configuring 文档）。

数据流的完整链路是：访客浏览器加载 tracker-js → 脚本把页面浏览/事件发送到 /backend/v1/log（自托管时通过 apiURL 参数指向自己的实例）→ swetrix-api 校验并写入 ClickHouse → 仪表盘通过后端 API 聚合查询实时渲染。

💡 技术拓展：为什么分析类产品普遍选择 ClickHouse 而不是 MySQL/PostgreSQL 这类行式数据库——

存储引擎类型	原理	适用负载	在网站分析中的表现
列式存储（ClickHouse）	按列组织数据、向量化执行、高压缩比	少写多读的大表聚合	亿级事件按天/维度聚合可达亚秒级
行式 OLTP（MySQL/PostgreSQL）	按行组织、事务强	高频小事务	聚合查询随数据量线性变慢
时序数据库（InfluxDB 等）	面向时间线优化	指标监控	维度灵活度不如列式的多维分析

Swetrix 选择 ClickHouse 存放分析事件（官方编排同时用它承载部分事务数据），属于行业标准做法——Google Analytics 内部、Plausible、Rybbit 等同类产品同样基于 ClickHouse。

四、功能特性

按官方 README 与文档站（2026-10-30 版）整理，Swetrix 的功能面覆盖以下域：

• 隐私与合规：无 Cookie、数据匿名化、GDPR 合规设计、无需同意横幅；跟踪脚本支持 respectDNT 选项尊重浏览器「请勿追踪」设置。
• 流量分析：Top 页面、带地图视图的地理位置、设备与浏览器、流量来源与 UTM 活动归因、实时访客计数。
• 自定义事件与属性：以任意语义追踪转化、销售等关键动作，事件可携带 key/value 元数据（单事件最多 100 个键，键值总长限 2000 字符）。
• 会话与用户流：理解访客的浏览路径与行为流；支持 identify 端点把匿名访客与登录用户 ID 关联（MAU/DAU 追踪）。
• 漏斗：可视化步骤流失，改进转化率。
• 性能监控：真实用户指标（RUM）——DNS、TLS、连接、TTFB、DOM 加载、整页加载、渲染耗时。
• 错误追踪：捕获客户端错误，含错误名、消息、堆栈与聚合视图。
• 告警与通知（云服务）：邮件、Slack、Telegram、Discord、Webhook、Web Push。
• 会话回放（云服务）：基于 rrweb 录制回放访客会话。
• 收入分析 / Feature Flags / A/B 实验 / Ask AI（云服务）。
• 团队与共享：组织、角色、公开或密码保护的仪表盘分享。
• 数据可携：CSV 导出 + 完整开发者 API（统计查询 API、管理 API、事件上报 API）。
• 企业登录：自托管版支持 OIDC 单点登录（可配置为仅 OIDC 认证）、双因素认证（2FA）。

社区版（CE）与云服务的能力边界是选型时的关键事实，官方 Cloud vs Community Edition 对比表如下（照官方 README 抄录）：

解读：若只需要「隐私流量统计 + 自定义事件 + 漏斗 + 性能与错误追踪」这一核心组合，社区版即可完整覆盖；若依赖会话回放、收入归因、A/B 实验或开箱即用的告警体系，则需订阅云服务或在社区版之上自行补齐。 网络智能（ISP/机房流量识别）虽是云服务特性，但社区版可通过 IP_GEOLOCATION_DB_PATH 指向付费 MaxMind/DB-IP 数据库补齐部分能力。

五、快速开始（最小可用示例）

Swetrix 提供两条上手路径，均以官方渠道为准：

路径 A：云服务（官方推荐，零部署）。在 swetrix.com 注册账号（免费试用），创建项目后把官方跟踪脚本嵌入站点即可看到实时数据。跟踪脚本的标准接入形态如下（取自官方文档站 script-reference 页）：

<script src="https://swetrix.com/swetrix.js" defer></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    swetrix.init('YOUR_PROJECT_ID')
    swetrix.trackViews()
  })
</script>

路径 B：自托管社区版。官方提供专门的自托管编排仓库 github.com/swetrix/selfhosting（内含 compose.yaml、configure.sh 环境生成脚本、nginx 与 ClickHouse 配置），支持 x86_64/arm64，建议内存 2GB 以上。完整部署步骤、环境变量生成与验证过程见官方自托管指南（https://swetrix.com/docs/selfhosting/how-to），本站亦有全程实测的 《Swetrix Docker Compose 部署指南》 可直接照做。自托管时跟踪脚本的 apiURL 需指向自己的实例（官方文档给出的格式为 [BASE_URL]/backend/v1/log）。

数据接入后，官方文档站还提供统计查询 API（Statistics API）与管理 API（Admin API）的完整参考，便于把仪表盘数据接入自己的报表体系；统计端点、认证方式与实测回显详见本站 《Swetrix API 使用详解》。

六、适用场景与限制

适用场景：

1. 合规驱动的站点统计：欧盟业务、需要免去 Cookie 同意横幅的营销站点，Swetrix 的无 Cookie 设计直接消除了一大类合规负担。
2. 想用一套工具替代多件套的技术团队：流量统计 + 错误追踪 + 性能监控 + 漏斗本是四类工具，Swetrix 把它们收敛到一个数据面。
3. 数据主权敏感的组织：AGPLv3 开源 + 完整自托管路径 + CSV/API 数据导出，可把数据完全留在自己的基础设施内。
4. 需要服务端/应用内事件追踪：Events API 与 tracker-node 支持后端与移动端上报，覆盖浏览器脚本触达不了的场景。
5. 统一认证的内网部署：自托管版支持 OIDC 与 2FA，可并入企业身份体系。

限制（基于官方文档 2026-10-30 版）：

1. 社区版功能边界明确：会话回放、收入分析、A/B 实验、告警通知、邮件报告均仅限云服务。
2. 地理精度依赖外部数据库：默认只带 DB-IP IP to City Lite（国家/地区/城市）；ISP、组织、连接类型等网络维度需要自购商业数据库。
3. 资源占用不低：ClickHouse + Redis + 前后端四件套，官方建议至少 2GB 内存，对小规格 NAS/单板机不友好。
4. 升级需跟随 changelog：官方明确提示新版本通常附带数据库迁移，升级前必须备份并按发布说明逐条执行。
5. 注册闭环默认收紧：自托管默认关闭注册（DISABLE_REGISTRATION=true，首个用户除外），多用户协作需管理员控制入口。
6. 无免费托管层：云服务试用结束后从 $19/月起，预算敏感场景只能走自托管。

七、同类选型对比

隐私分析与产品分析赛道的开源选项相当多，下表给出量化维度对比（星数与版本为 2026-10-30 经 shields.io/官方发布渠道实查的量级口径）：

💡 说明：Umami/Plausible/GoatCounter 等竞品的星数与许可证以各自官方仓库当日实查为准，本表只作量级对比；各产品的深入部署与配置对比可参考本站对应组件专栏，如 《Aptabase 介绍与选型指南》（面向桌面/移动应用的产品分析，与 Swetrix 的 Web 站点分析互补）与 《Rybbit 介绍与选型指南》（同样基于 ClickHouse 的新锐隐私分析平台）。

「如果…则…」选型建议：

• 如果你的核心诉求是合规无 Cookie 的网站流量统计，且希望错误追踪、性能监控开箱即用 → Swetrix 是当前开源阵营里少数把三者打包的产品，社区版即可落地（本站 Swetrix 专栏配套有部署、配置与 API 实测篇：《Swetrix Docker Compose 部署指南》、《Swetrix v5.4.1 配置参数详解》、《Swetrix API 使用详解》，也可与 《Aptabase 介绍与选型指南》、《Rybbit 介绍与选型指南》 交叉阅读）。
• 如果只需要最基础的 PV/UV/来源统计，机器只有 512MB 内存 → Umami 或 GoatCounter 更合适，Swetrix 的 ClickHouse 栈属于资源超配。
• 如果分析对象是桌面/移动应用而非网站 → Aptabase 的事件模型与应用 SDK 更对口。
• 如果追求最大社区规模与营销侧口碑背书 → Plausible 的品牌与生态更成熟，但注意其核心高级功能在托管版收费墙内。
• 如果需要会话回放、收入归因、A/B 实验且不想自己拼装 → Swetrix 云服务或 PostHog 一类全栈产品比 Swetrix 社区版更合适。

八、参考链接

• 官网：https://swetrix.com
• 官方文档站：https://swetrix.com/docs
• 自托管指南（官方）：https://swetrix.com/docs/selfhosting/how-to
• 自托管环境变量参考：https://swetrix.com/docs/selfhosting/configuring
• GitHub 主仓库（含文档站源码）：https://github.com/Swetrix/swetrix
• 自托管编排仓库：https://github.com/swetrix/selfhosting
• Releases 订阅（版本取证）：https://github.com/Swetrix/swetrix/releases.atom
• Docker Hub（swetrix-api）：https://hub.docker.com/r/swetrix/swetrix-api
• Docker Hub（swetrix-fe）：https://hub.docker.com/r/swetrix/swetrix-fe
• 事件上报 API 参考：https://swetrix.com/docs/events-api
• 统计 API 参考：https://swetrix.com/docs/statistics-api

本文取证日期：2026-10-30。版本号、星数、tag 清单均为当日官方渠道实查值，后续发布请以官方渠道最新数据为准。