配置项

全部系统配置键、默认值和说明，与服务导出的配置清单同源。在「系统 → 系统配置」里修改，每组的用法见 系统配置。

启动设置只有三个，不在这张表里。都可以不写，不写就用默认值。推荐用环境变量；同名启动参数非空时覆盖环境变量。环境变量名是 EVS_ 加上参数名的全大写。

环境变量（推荐）	启动参数	默认	含义
EVS_CLICKHOUSE	-clickhouse	http://evstats:evstats@127.0.0.1:8123/evstats	ClickHouse 连接，账号、口令、库名都是 evstats，同时是系统数据库和默认分片 s0
EVS_REDIS	-redis	redis://127.0.0.1:6379/0	Redis 连接，默认无口令
EVS_PORT	-port	51321	监听端口。进程对所有网卡开放

项目自己的开关（采集开关、域名名单、全埋点、回放、归因回看天数等）是项目的属性，不是系统配置，见 项目设置。

全部配置键

站点 site

配置键	默认值	做什么	改大改小、留空会怎样
site.public_urlurl	空	这套系统对外的访问地址，例如 https://stats.example.com	重置密码邮件里的链接用它。留空则不能找回密码

IP 库 geo

配置键	默认值	做什么	改大改小、留空会怎样
geo.ip2region.urlurl可测试	空	离线 IP 库的下载地址	留空则没有国家、省、市。不会把访客 IP 发到这个地址以外的地方

AI ai

配置键	默认值	做什么	改大改小、留空会怎样
ai.base_urlurl可测试	空	Agent 用的兼容 OpenAI 的接口地址，含到 /v1 为止	留空则不能问数，图表不受影响
ai.modelstring	空	Agent 使用的模型名	留空则不能问数，图表不受影响
ai.api_keysecret保密	空	调用模型接口的密钥	留空则不能问数，图表不受影响
ai.user_daily_limitint	200	每人每天最多问多少次	控制模型费用。填 0 不限

邮件 smtp

配置键	默认值	做什么	改大改小、留空会怎样
smtp.hoststring可测试	空	用来发重置密码邮件的 SMTP 服务器	留空则登录正常，找回密码会提示先来这里配置
smtp.portint	空	SMTP 端口，常见 587（STARTTLS）或 465（SSL）	留空按加密方式取默认端口
smtp.usernamestring	空	SMTP 登录用户名	留空则不做 SMTP 认证
smtp.passwordsecret保密	空	SMTP 登录口令	只存在配置里，不进日志
smtp.fromstring	空	发件人地址	留空则不能发信
smtp.tlsenum	starttls	连接 SMTP 的加密方式	与服务器不一致时发信失败

采集调优 ingest

配置键	默认值	做什么	改大改小、留空会怎样
ingest.batch_sizeint	1000	攒够多少条再写入 ClickHouse	加大减少写入次数，数据出现在报表上更慢
ingest.flush_msint	200	没攒够时最多等多少毫秒	减小更实时，写入更频繁
ingest.max_batch_bytesint	4194304	单批大约超过这个大小就先写	防止单批过大撑满内存
ingest.stream_maxint	1000000	队列里积压超过这个长度就拒绝新的上报	保护 Redis。太小会在高峰时拒收
http.trusted_proxiescidrs	空	反代的网段，逗号分隔的 CIDR	留空则不信任 X-Forwarded-For，避免伪造来源 IP

存储 storage

配置键	默认值	做什么	改大改小、留空会怎样
storage.cold_after_daysint	30	超过这么多天的分区迁到 ClickHouse 的冷盘，查询近期数据更快	没有冷盘时改了也不会搬迁。只在建表时生效
agg.retain_daysint	400	聚合表与点击表的保留天数	只在建表时生效，已有的表不改
audit.retain_daysint	400	操作日志的保留天数	只在建表时生效，已有的表不改
replay.retain_daysint	15	会话回放的保留天数	只在建表时生效，已有的表不改

缓存 cache

配置键	默认值	做什么	改大改小、留空会怎样
stat.cache_ttl_secint	60	统计结果在 Redis 里放多久	加大更省数据库，页面上的数会晚一点才变。填 0 则每次都查 ClickHouse
stat.cache_ttl_realtime_secint	5	实时页的缓存秒数	默认比上面更短

OpenAPI openapi

配置键	默认值	做什么	改大改小、留空会怎样
openapi.corsorigins	*	哪些网站可以用浏览器直接调用 /api/v1	默认允许所有来源。多个来源用逗号分隔

演示 demo

配置键	默认值	做什么	改大改小、留空会怎样
demo.hinttext	空	登录页下方显示的一段提示，用来公开演示账号	留空不显示。最长 200 字
demo.agent_daily_limitint	20	演示用户每人每天能问几次	通常比每人每天的上限更小

自监控 telemetry

配置键	默认值	做什么	改大改小、留空会怎样
telemetry.endpointurl	空	给这套 evstats 自己埋点，数据发到你填的完整采集地址	和密钥都留空则不发送。不会发给作者
telemetry.keysecret保密	空	给自己埋点用的写入密钥	和地址都留空则不发送

日志 log

配置键	默认值	做什么	改大改小、留空会怎样
log.levelenum	info	日志详细程度	debug 量很大，排障完改回 info

默认值为空的键，留空就是不启用对应功能。标「保密」的键在界面上只显示遮盖值；标「可测试」的键旁边有「测试」按钮，保存前可以先验证。