TelemetryDeck 平替：TelemetryLite
我一直拿 TelemetryDeck 给自己的 App 做使用统计，隐私友好，SDK 也省心，用着一直挺舒服。直到最近，我发现自己好像把它的免费额度快用”超标”了。。。
原因也简单：vibe coding 玩多了以后，App 的产出速度完全失控——今天一个小工具、明天一个小 App，不知不觉手上的 App 越来越多，免费额度就肉眼可见地不够用了。
掏钱升级吧，又觉得为一堆还没几个用户的小 App 付费有点肉疼；那自己搭一个？我在网上找了一圈，没找到合适的。我要的其实不多：轻、能自己部署、最好能直接用 TelemetryDeck 的 SDK（App 里的埋点代码我是一点都不想动）。
行吧，那就自己 vibe coding 一个。折腾了一阵，成品就是今天要介绍的 TelemetryLite：一个 Rust 单二进制 + SQLite 的极简 App 统计服务，已经开源了。（基本是我和 Claude Code 一起聊出来的，我负责提需求、拍板和嫌弃😄）分享给一样爱vibe coding的朋友。
它到底是个什么东西？
一句话：一个能直接吃 TelemetryDeck SDK 数据的、自己部署的极简统计后台。几个特点：
轻。就一个静态编译的二进制，五兆多，数据就是一个 SQLite 文件，空载内存十来 MB。没有数据库服务、没有消息队列，丢到服务器上就能跑。
不用改埋点。SDK 里只要把服务器地址（baseURL）指过来就行，埋点代码基本不用动。顺带也兼容 OpenTelemetry 的 OTLP/HTTP Logs。
隐私友好。不存 IP。国家和城市是用 DB-IP 的免费库在内存里现查的，查完 IP 就扔，库里只留国家和城市。
界面够用。活跃用户、事件趋势、按周留存、各版本占比随时间的变化、新老用户、错误、设备/系统/语言/国家城市分布，该有的都有。鼠标悬停时那种带日期和百分比的小卡片，是我对着 TelemetryDeck 的页面抄的哈哈。界面有中英文；同一个 App 的 iOS 和安卓版本也可以共用，用一个下拉框按平台筛选。
自己发 key。在后台给每个 App 签发只有写入权限的 key，泄露了吊销重发就行。
省心的运维。一行命令安装，更新也是同一条命令（用 systemd 的话，新版本起不来还会自动回滚）。发布前还有一套回归测试在 CI 里挡着，毕竟代码是 AI 写的，我心里没底，就让它多测测。。。
最简单的用法是什么？
就三步。
第一步，装到服务器上。因为这个脚本是用 root 权限改系统的，我建议先下载下来看一眼，再 –dry-run 预演一下，没问题再装（README 里我特意标了 USE ON YOUR OWN RISK，别嫌我啰嗦）：
|
1 2 3 4 |
curl -fsSL https://github.com/bones7456/telemetrylite/releases/latest/download/install.sh -o install.sh less install.sh # 先看一眼 sh install.sh --dry-run # 只预演，不改任何东西 sh install.sh |
装完会打印一个管理员密码，只显示一次，记得存好。服务默认只监听本机的 8888 端口，要挂域名和 HTTPS 的话，前面放个 nginx 就行（脚本也可以帮你配），这块细节去看文档。
第二步，登录后台，新建一个 App，到「设置」里签发一个 key。名称默认填的是当前时间，你也可以改成 ios-prod 这种一眼能认出来的。
第三步，改 SDK 的地址。以 Swift 为例，只改初始化那一处：
|
1 2 3 4 |
let config = TelemetryDeck.Config( appID: "你的 App ID", baseURL: URL(string: "https://你的域名/k/你的key/")!) TelemetryDeck.initialize(config: config) |
这里有个小细节：key 是放在地址路径里的，因为 TelemetryDeck 的 Swift SDK 发请求时不带任何鉴权头，只能这么玩（claude说它确认过）。
嫌麻烦的话，还有个偷懒的办法：后台「设置」页里有一块「让 AI agent 完成接入」，里面是一段已经把你的服务器地址、App ID 和 key 都填好的提示词，点一下复制，丢给 Claude Code 或者 Codex，让它去帮你接。毕竟 vibe coding 出来的 App，接统计这种事也交给 AI，才顺理成章嘛～
有什么短板？
坦白一下：
1. 只有一个管理员账号，没有多用户和角色；
2. 单机 SQLite，设计目标是每天十万以内的事件，再大就别指望了；
3. 没有 TelemetryDeck 那种自己拼查询的 Playground，也不能跨 App 汇总。
我自己用，这些都够了。
不说了，我先去把手头几个 App 的 baseURL 改过来试试水。想想也挺有意思的：vibe coding 带来的”额度焦虑”，最后还是靠 vibe coding 解决了，闭环了哈哈。项目在 GitHub 上，更详细的安装、nginx 配置和各种选项，都在 README 和 docs 里，有问题欢迎提 issue～
发表回复