trench

一条命令部署，快速搭建产品分析平台

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 66 🐛 待处理 3 👀 关注 13

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1666

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可自行部署，完全免费。

项目预览

项目数据

分类搜索知识

开发团队FrigadeHQ

官网地址https://trench.dev

GitHubhttps://github.com/FrigadeHQ/trench

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可自行部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型analytics,clickhouse,clickhouse-database,clickhouse-server,dashboard,dashboards,event-replay,kafka,kafka-engine,llm,matomo,matomo-analytics,nodejs,open-source,plausible-analytics,posthog,product-analytics,rag,tracking,tracking-events

GitHub 星标★ 1666

上线时间2024-09-30 00:00:00

代码更新2026-04-06

仓库体积6.0 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数4

项目介绍

Trench 是一个开源的轻量级分析基础设施，旨在帮助开发者快速构建产品分析、LLM RAG、可观测性平台等分析类应用。它基于 ClickHouse、Kafka 和 Node.js 构建，提供单个生产就绪的 Docker 镜像，简化了事件追踪和分析管道的搭建。Trench 解决了从零搭建分析后端的高成本问题，核心能力包括事件数据采集、流式处理、存储与查询，并支持通过 API 或 SDK 灵活接入。其设计强调易用性和可扩展性，适合需要自托管分析功能的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1666

技术标签

analytics clickhouse dashboard kafka llm

使用教程

难度：入门约 15 分钟部署方式：Docker 7 步

环境要求

已安装 Docker 与 Docker Compose（唯一前置条件）
生产环境建议至少 4GB 内存和 4 个 CPU 核心
本地需能访问 4000 端口，并能拉取 git 仓库与 Docker 镜像

安装与启动步骤

1克隆仓库

把 Trench 源码克隆到本地，URL 来自 README。克隆完成后目录名为 trench。
```
git clone https://github.com/frigadehq/trench.git
```
2准备配置文件

进入服务目录（apps/trench），把示例环境变量文件复制为 .env，后续可在这里改配置和 API Key。
```
cd trench/apps/trench
cp .env.example .env
```
3启动 Dev 服务

用 dev compose 文件启动，会自动构建镜像并拉起本地 ClickHouse 与 Kafka，首次构建耗时较长。
```
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build --force-recreate --renew-anon-volumes
```

4发送示例事件

用 .env 中的 public API Key 以 Bearer 方式向 /events 发送一条 ConnectedAccount 事件。

curl -i -X POST -H "Authorization:Bearer public-d613be4e-di03-4b02-9058-70aa4j04ff28" -H "Content-Type:application/json" -d "{\"events\":[{\"userId\":\"550e8400-e29b-41d4-a716-446655440000\",\"type\":\"track\",\"event\":\"ConnectedAccount\",\"properties\":{\"totalAccounts\":4,\"country\":\"Denmark\"}}]}" 'http://localhost:4000/events'

5查询事件

用 private API Key 调用 GET /events 并按事件名过滤，可看到刚发送的事件返回。

curl -i -X GET -H "Authorization: Bearer private-d613be4e-di03-4b02-9058-70aa4j04ff28" 'http://localhost:4000/events?event=ConnectedAccount'

6执行 SQL 查询

调用 /queries 端点直接跑 ClickHouse SQL 做统计分析，示例统计某 userId 的事件条数。

curl -i -X POST -H "Authorization:Bearer public-d613be4e-di03-4b02-9058-70aa4j04ff28" -H "Content-Type:application/json" -d "{\"queries\":[\"SELECT COUNT(*) FROM events WHERE userId = '550e8400-e29b-41d4-a716-446655440000'\"]}" 'http://localhost:4000/queries'

7SASL 方式启动

如需 Kafka SASL 认证，改用专用 compose 文件在后台构建启动；SSL+SASL 用 docker-compose.ssl-sasl.yml。
```
docker compose -f docker-compose.sasl.yml up -d --build
```

关键配置

配置项	必填	说明	示例
`public API key（.env 内）`	是	公共 Key，用于发送事件与执行查询的 Bearer 鉴权	`public-d613be4e-di03-4b02-9058-70aa4j04ff28`
`private API key（.env 内）`	是	私有 Key，用于读取事件等需要更高权限的请求	`private-d613be4e-di03-4b02-9058-70aa4j04ff28`
`KAFKA_SASL_MECHANISM`	否	SASL 认证机制，SASL compose 启动时使用	`PLAIN`
`KAFKA_SASL_USERNAME`	否	Kafka SASL 用户名，SASL compose 启动时使用	`kafka_user`
`KAFKA_SASL_PASSWORD`	否	Kafka SASL 密码，SASL compose 启动时使用	`kafka_password`