为什么是 evstats
这一页说清 evstats 和常见选择差在哪里，以及什么时候不该选它。
和常见选择的差别
| 相对于 | evstats 的做法 |
|---|---|
| 托管统计服务 | 数据在自己的 ClickHouse 里，明细随时能查。访客 IP 用离线库在本机解析，不发给任何第三方 |
| 只做页面 PV 的轻量统计 | 除了流量和页面，还有事件、漏斗、留存、路径、用户画像、看板，并提供 OpenAPI |
| 把行为分析放在商业模块里的产品 | 热力图、A/B 实验、会话回放、归因、全埋点都在开源版本里，没有功能开关 |
| 要自己跑迁移脚本的系统 | 换版本启动时自己补表补列，改了什么记在「关于」页，不要求对着生产库执行脚本 |
| 「让模型写 SQL」的 AI 问数 | 模型只能调用和图表相同的统计查询，数字可以对回图表；项目由会话决定，模型改不了 |
| 能力 | 托管统计 | 轻量开源统计 | 商业分析平台 | evstats |
|---|---|---|---|---|
| 数据在自己手里 | 无在服务商那里 | 有自己部署 | 付费私有化部署另购 | 有自己的 ClickHouse，IP 离线解析 |
| 事件 / 漏斗 / 留存 | 有口径由服务商决定 | 部分以页面流量为主 | 有 | 有口径公开在文档里 |
| 热力图 / 回放 / A/B | 部分常要另接工具 | 无多数不提供 | 付费常是附加模块 | 有都在开源版本里 |
| AI 问数 | 部分少数提供 | 无 | 付费多在商业方案里 | 有和图表同一个查询 |
| OpenAPI | 部分接口有限 | 部分能力不一 | 付费多在商业方案里 | 有OpenAPI 3.0，只读 |
| 升级方式 是否不用人工跑迁移 | 有服务商负责 | 部分常要执行迁移脚本 | 付费由厂商实施 | 有换版本启动，自己补表补列 |
| 授权方式 全部功能是否免费 | 部分高级功能收费 | 有开源许可 | 付费按量或按年 | 有Apache-2.0，没有功能开关 |
按常见情况归纳，不代表任何一个具体产品；以各产品自己的说明为准。
起步只要三个启动参数
启动只认三个设置，都有默认值。推荐环境变量 EVS_CLICKHOUSE、EVS_REDIS、EVS_PORT；同名启动参数 -clickhouse、-redis、-port 写了就覆盖。ClickHouse 与 Redis 的默认主机是 127.0.0.1，端口默认 51321，进程对所有网卡开放。没有配置文件，没有预置账号。管理员在第一次打开网页时设置，还可以顺手建一个装好示例数据的演示项目；其余设置在「系统配置」页，每一项都写明做什么、改大改小会怎样、留空会怎样，能测的旁边有「测试」按钮。见 首次引导 和 系统配置。
沿用行业里的字段
批量上报的外壳用 Segment HTTP API 的字段（batch、messageId、anonymousId、userId、properties……），预置事件和属性用神策的名字（$pageview、$WebClick、$utm_source……）。已经按这两套习惯埋过点的团队，改的是上报地址和密钥，不是埋点代码的语义。见 HTTP 协议 和 事件与属性名。
隐私是默认值
- IP 用离线库在本机解析，访客 IP 不发给任何第三方。
- 全埋点不采输入框内容；元素文本截断到 100 个字。
- 会话回放默认关闭；打开后按比例抽样，默认遮住输入框；回放正文不进 OpenAPI，也不交给模型。
- evstats 不向作者回传任何数据。
详见 安全与隐私。
口径公开，数字对得上
区间 UV 按人去重后合并，不把每天的 UV 加起来；默认不抽样。每个指标名旁边都有说明，和 指标口径 一致。