Litlyx 介绍与选型指南

目标:完整认知 Litlyx——一个开源、隐私优先、零 Cookie 的网站/产品分析平台。本文全部信息来自官方渠道联网溯源(来源与查询日期逐项标注),选型对比基于同类平台量化维度展开。

一、环境信息

本文为认知篇,所有信息均为联网溯源取证,未混入本地部署实测结论(部署与 API 实测见本专栏后续文章)。

二、软件概述

Litlyx 是一个隐私优先的网站与产品分析平台,由欧盟团队开发并托管(官网明确标注 "Made and hosted in the EU"),主打「无需 Cookie 横幅的诚实分析」(Honest Analytics. Without Consent Banner)。它对标 Google Analytics 4、PostHog、Mixpanel 与 Plausible,核心卖点是:

• 零 Cookie:不向浏览器写入任何 Cookie 或存储,天然免去了 GDPR 语境下的 Cookie 同意横幅;
• 不存储 IP 地址:官方数据政策明确「No IP addresses to track your visitors」,不跨会话、不跨设备追踪用户;
• 开箱即合规:官网宣称符合 GDPR、PECR、ePrivacy、法国 CNIL、德国 DSGVO、美国 CCPA 等主流隐私法规;
• 部署极简:官方宣称 30 秒接入(一段 <script> 标签),云版与自托管双形态;
• 内置 AI 分析助手:通过对话方式获得基于数据的运营建议(自托管可关闭)。

三、核心架构

Litlyx 自托管采用经典的「采集-消费-展示」三段式微服务架构,由 5 个容器协作完成(以下组件划分源自官方 Docker 镜像与源码仓库结构):

访问者浏览器                     自托管服务器
┌──────────────┐   POST /event  ┌─────────────┐  Redis Stream ┌─────────────┐
│ litlyx.js 脚本 │ ─────────────→ │  producer    │ ────────────→ │  consumer    │
│ (采集端 SDK)  │   POST /visit  │ (Express 入口)│  (LITLYX_STREAM│ (消费/解析/  │
└──────────────┘                └─────────────┘   消费组 DATABASE)│  聚合落库)   │
                                                 └──────┬───────┘└──────┬──────┘
                                                        │ Redis 7       │ MongoDB 7
                                                        └───────────────┴────→ ┌─────────────┐
                                                                               │  dashboard   │
                                                                               │ (Nuxt 3 看板) │
                                                                               └─────────────┘

• producer(数据入口):Express 轻量服务,只做三件事——解析请求、执行防护过滤(IP 黑名单、600+ 条 Bot User-Agent 模式拦截、域名白名单)、将原始事件压入 Redis Stream。不直接写库,保证采集路径低延迟;
• consumer(消费聚合):以消费组 DATABASE 读取 Redis Stream,完成地理信息解析、会话哈希计算、浏览器/操作系统/设备识别,再写入 MongoDB;
• dashboard(看板):Nuxt 3/Nitro 全栈应用,提供登录、项目(Workspace)管理、报表展示与 AI 助手,自带会话管理与自托管管理员引导;
• MongoDB:唯一持久化存储,核心集合包括 visits(访问)、events(自定义事件)、sessions(会话时长)、aggregations(预聚合)等;
• Redis:既做 Stream 消息队列解耦采集与消费,也承担指标缓存。

隐私设计落点:访客身份不落库。producer 收到的 IP 只参与计算一个「每日轮换的 MD5 会话哈希」(日期 + 网站 + IP + User-Agent),MongoDB 中仅保存该哈希,原始 IP 不持久化——这是其「不存储 IP」承诺在代码层的实现方式。

四、功能特性

按官方文档(docs.litlyx.com)的功能总表,配合官方仓库能力归纳:

值得注意的差异化能力:自定义事件免费——官网用户证言多次强调这一点(对比某些平台对事件量额外计费);云版按月页面访问量(Pageviews)分档计费,10K~10M 档位。

五、快速开始(官方口径)

以下均引自官方 README 与文档站(溯源,非本地实测)。云版注册后在 dashboard 拿到 workspace_id 即可接入。

方式一:通用脚本标签(CDN)

<script defer data-workspace="workspace_id"
        src="https://cdn.jsdelivr.net/npm/litlyx-js@latest/browser/litlyx.js"></script>

方式二:包管理器接入(框架内使用)

npm i litlyx-js

import { Lit } from 'litlyx-js';

Lit.init('your_workspace_id');        // 自动追踪 PV、UV、实时用户
Lit.event('click_on_buy_item', {      // 自定义事件 + 元数据
  metadata: {
    'product-name': 'Coca-Cola',
    'price': 1.50,
    'currency': 'EUR'
  }
});

方式三:cURL 直接上报(官方 README 示例,亦为自托管采集端点形态)

curl -X POST "https://broker.litlyx.com/event" \
  -H "Content-Type: application/json" \
  -d '{
    "pid": "workspace_id",
    "name": "testEvent1",
    "metadata": "{\"test\": \"something\"}",
    "website": "something",
    "userAgent": "something"
  }'

自托管时,脚本标签需改用 data-project/data-host/data-port/data-secure 参数指向自己的实例,完整步骤见本专栏 《Litlyx Docker Compose 部署指南》;数据上报端点与认证机制详解见 《Litlyx API 使用详解》。

六、适用场景与限制

适合:

1. 需要去除 Cookie 横幅、面向欧盟访客的官网/营销站分析;
2. 个人开发者与小型团队的轻量产品分析(自定义事件 + 漏斗);
3. 想要「数据完全在自己服务器上」的隐私敏感型组织(Apache-2.0 允许商用闭源集成);
4. 被 Google Analytics 采样/拦截困扰、希望覆盖 100% 流量(含拒绝 Cookie 的访客)的站点。

限制与注意:

1. 依赖 MongoDB + Redis,比单二进制竞品(GoatCounter、Offen)部署重(5 容器);
2. 官方 release notes 最近更新停留在 2025-12-01,需评估项目迭代节奏(2026-10-30 溯源);
3. 采集端点本身无认证(与同类无 Cookie 分析工具一致),防滥用依赖内置 Shields 机制;
4. 自托管管理员账号只能有一个(首个引导账号),多成员协作能力弱于云版;
5. 无内置用户级跨站追踪——这是隐私设计使然,不适合需要用户画像串联的场景。

七、同类选型对比

对比对象选取本站已实测交付的同类隐私分析平台(数据口径:各专栏实测版本,2026-10 交付;Litlyx 数据为本文溯源口径):

选型建议(如果…则…):

• 如果你要产品级事件分析 + 漏斗 + AI 助手,且接受 MongoDB 依赖 → 选 Litlyx;
• 如果你要最小部署足迹(NAS/小鸡,单二进制)→ GoatCounter 或 Offen;
• 如果你要高性能多维下钻(海量事件 + ClickHouse)→ Rybbit;
• 如果你更看重成熟度与插件生态 → 考虑 Matomo 等老牌平台(本站后续批次交付);
• 如果你要采集端点带认证、防伪造上报 → Swetrix/Rybbit 形态更合适,Litlyx 需自行加反代防护(见 《Litlyx Docker Compose 部署指南》 的防护章节)。

八、参考链接

1. Litlyx 官网(定位/定价/数据政策):https://litlyx.com
2. 官方文档站(功能总表/SDK):https://docs.litlyx.com
3. GitHub 仓库(源码/LICENSE):https://github.com/litlyx/litlyx
4. Docker Hub 镜像:https://hub.docker.com/u/litlyx
5. npm SDK:https://www.npmjs.com/package/litlyx-js
6. 本站同类平台实测:Swetrix、Rybbit、Offen、GoatCounter 各专栏