Jitsu

开源事件数据平台。Segment 的替代方案。

网站 · 文档 · MCP 服务 · Jitsu Cloud · 自托管 · Slack · MIT 许可证

---

什么是 Jitsu？

Jitsu 从你的网站、应用和服务器收集事件数据，并将其传送到你的数据仓库以及你使用的其他工具。它涵盖了与 Segment 相同的领域，但采用 MIT 许可证且可自托管，因此整个数据管道可以运行在你自己的基础设施中，也可以使用托管版 Jitsu Cloud，软件相同。

数据几分钟内即可送达，而不是几小时：Segment 每天向数据仓库加载一到两次数据（最快每小时一次），而 Jitsu 会按目标端分别投递，频率最高可达每分钟一批；如果目标端适合逐行写入，也可以逐行投递。Segment 按月活跃用户计费，而 Jitsu Cloud 按事件量计费，因此费用反映的是数据量，而非受众规模；自托管则完全没有用量费用。

典型的 Jitsu 部署包含：

• 事件收集：通过SDK、HTTP API 或开箱即用的 Segment 代理，从浏览器、移动设备或服务器收集事件。
• 投递到目标端——ClickHouse、BigQuery、Snowflake、Redshift、Postgres、S3、GCS，以及数十种 SaaS 工具；根据目标端的偏好，以流式或微批处理方式传送。请参阅目标端目录。
• 函数——在每个事件上运行的 JavaScript，可在投递前对事件进行筛选、转换和丰富。
  • 你可以在浏览器中编写，也可以通过自己的代码仓库构建并部署，Jitsu CLI 会用 jitsu-cli init 搭建一个带测试的 TypeScript 项目，再用 jitsu-cli deploy 将其发布到你的工作区。你可以使用喜欢的工具：TypeScript、npm 库、自有测试套件，以及常用的 CI。
• 连接器同步——从第三方来源拉取数据到你的数据仓库（兼容 Airbyte 的连接器）。
• 用户身份图谱和用户资料构建器，可根据事件流自动构建。
• 实时事件——实时查看每个事件、函数日志和目标端写入情况，让数据管道调试只需几秒，而不是几天。
• MCP 服务，让 AI Agent 能够配置和操作上述所有功能。

## 开始使用 Jitsu Cloud

运行 Jitsu 最快捷的方式是使用 Jitsu Cloud——我们会为你托管并扩展服务。

• 免费套餐：每月 200k 个事件，无需信用卡。
• 所有套餐均提供不限数量的目标和捕获事件。
• 套餐包含一个免费的 ClickHouse 实例，因此你无需先配置数据仓库，即可从零开始查询事件数据。
• 免费套餐还提供自定义域名、事件调试器和 Configuration API。

如需了解完整详情，请查看定价，或直接阅读快速入门指南。

创建工作区后：

1. 创建一个站点（一个流），并获取写入密钥。
2. 添加目标——ClickHouse、BigQuery、Snowflake、Postgres、S3，或目录中的任何目标。
3. 开始发送事件，使用以下任一方法。

发送事件

方法	适用场景
HTML 代码片段	任何网站，无需构建步骤
@jitsu/js	同构应用——可在浏览器和 Node.js 中运行
@jitsu/jitsu-react	React 和 Next.js 应用
HTTP API	任何语言、后端服务
Segment 代理	从 Segment 迁移，无需改动客户端代码

UI 中的所有操作也都可以通过 Management API 和 Jitsu CLI 完成。

Jitsu MCP Server

Jitsu 提供了 Model Context Protocol 服务，因此编码 Agent 和 AI 助手可以直接构建和运行数据管道——无需在 UI 中逐项点击。

连接到 Jitsu 的 Agent 可以设置目标、配置连接、发送测试事件、读取生成的实时事件、发现函数抛出错误、修复函数并重新运行——整个流程无需人工介入。

端点： https://use.jitsu.com/mcp（可自托管时使用 <your-console-url>/mcp）。

连接客户端

Claude Code

claude mcp add --transport http jitsu https://use.jitsu.com/mcp

其他客户端（Claude Desktop、Cursor、VS Code）也使用相同的 URL——请参阅 jitsu.com/docs/mcp 了解设置方法。

身份验证

交互式客户端使用 OAuth 2.1——无需管理 API 密钥。首次调用工具时会打开浏览器标签页，请求你批准连接；令牌具有范围限制，可在账户设置页面中查看和撤销。

无头环境（CI、cron、服务器）则使用个人 API 密钥——在用户设置页面生成密钥，并将其作为 Authorization: Bearer <keyId>:<keySecret> 传入：

claude mcp add --transport http jitsu https://use.jitsu.com/mcp \
  --header "Authorization: Bearer $JITSU_API_KEY"

Agent 可以做什么

提供 25 个工具，涵盖控制台的所有功能：读取和写入工作区配置（目标、流、连接、函数），查询实时事件和函数日志，运行和取消连接器同步，发现源流并检查同步状态，针对测试数据执行函数和分析构建器，以及获取事件和同步统计信息。完整参考文档： jitsu.com/docs/mcp。

架构

Jitsu 由几个可独立扩展的服务组成：

服务	技术栈	功能
ingest	Go	接收事件并将其写入 Kafka 的 HTTP 端点
rotor	TypeScript	路由事件、运行 Functions，并应用特定于目标的转换
bulker	Go	高吞吐量数据仓库摄取——批处理、架构管理、重试
sync-controller	Go	编排连接器同步（从第三方数据源拉取数据）
console	Next.js	管理 UI、管理 API 和 MCP 服务

底层依赖 Postgres（配置）、Kafka/Redpanda（事件总线）、ClickHouse（实时事件和指标）以及 MongoDB（用户档案）。

如果你只需要一个数据仓库摄取引擎，并且能够使用底层 API，Bulker 也可以独立使用。

自托管

Jitsu 采用 MIT 许可，完全支持自托管，没有使用限制，也没有功能限制。Cloud 是最省事的选择；当你需要让数据留在自己的基础设施中时，可以选择自托管。

快速开始（Kubernetes / Minikube）

开发用 Helm chart 是在本地运行完整服务栈的推荐方式。你需要安装 Minikube（在你的计算机上运行的单节点 Kubernetes 集群）和 Helm v3+：

git clone -b newjitsu --single-branch https://github.com/jitsucom/jitsu
cd jitsu/helm

minikube start          # give the VM at least 8GB RAM
./dev-deploy.sh deploy
./dev-deploy.sh tunnel  # in a second terminal

./dev-deploy.sh tunnel 会运行 minikube tunnel，将集群的 LoadBalancer 服务路由到 localhost，以便你在浏览器中访问它们——console 位于 :3000，ingest 位于 :3049，bulker 位于 :3042，rotor 位于 :3401，此外还有 Postgres、ClickHouse、MongoDB 和 Kafka。它会请求 sudo 权限（因为需要绑定特权端口），并且在整个会话期间都必须在单独的终端中持续运行。

console 的访问地址为 http://localhost:3000。完整说明请见： 自托管快速开始。

生产环境

有关实际部署，请阅读 生产环境部署指南和 配置参考。其中介绍了如何扩展各项服务、Kafka 容量规划，以及每个组件读取的环境变量。

参与贡献

欢迎贡献。CONTRIBUTING.md 介绍了代码仓库布局、如何设置开发环境并运行测试套件，以及分支、提交和拉取请求规范。

社区与支持

• Slack — 联系团队和其他用户最快捷的方式
• GitHub Issues — 报告错误和提出功能请求
• 文档 — 指南和参考资料

许可证

Jitsu 采用 MIT License 许可。