serve 环境变量

这些环境变量调节 tansr serve 的准入、超时、事件缓冲、多会话治理与日志形态。全部键都可以不设:留空等于未设,走库内缺省,行为不变;取值非法时忽略并打一条告警,不会拒绝启动。

「类型」列给出取值形;整数类的单位(ms / bytes / days)写在括号里。
「敏感」为「是」的键其取值不会进入日志和告警;不要把它写进版本库。
深链锚点为小写键名,例如 #tansr_serve_max_active_sessions。
另有 5 个键由 tansr serve 入口自行定义,不在本表(见末节「入口级键」)。

键一览

键	组	类型	缺省	敏感
`TANSR_SERVE_MAX_ACTIVE_SESSIONS`	准入 / 过载保护	整数:`integer >= 1`	留空(库缺省)	否
`TANSR_SERVE_MAX_SSE_CONNECTIONS`	准入 / 过载保护	整数:`integer >= 1`	留空(库缺省)	否
`TANSR_SERVE_MAX_INFLIGHT_BODY_BYTES`	准入 / 过载保护	整数:`integer >= 1;bytes`	留空(库缺省)	否
`TANSR_SERVE_ELD_THRESHOLD_MS`	准入 / 过载保护	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_REQUEST_TIMEOUT_MS`	node:http 参数	整数:`integer >= 0;ms`	留空(库缺省)	否
`TANSR_SERVE_EXPOSE_OBSERVABILITY`	观测端点暴露	布尔:`1\|true\|yes\|on / 0\|false\|no\|off`	留空(库缺省)	否
`TANSR_SERVE_EXPOSE_METRICS`	观测端点暴露	布尔:`1\|true\|yes\|on / 0\|false\|no\|off`	留空(库缺省)	否
`TANSR_SERVE_EVENT_BUFFER_MAX_BYTES`	事件环形缓冲	整数:`integer >= 1;bytes`	留空(库缺省)	否
`TANSR_SERVE_ORPHAN_GRACE_MS`	/v2 多会话治理	整数:`integer >= 0;ms`	留空(库缺省)	否
`TANSR_SERVE_IDLE_AFTER_GONE_MS`	/v2 多会话治理	整数:`integer >= 0;ms`	留空(库缺省)	否
`TANSR_SERVE_MAX_RETAINED_SESSIONS`	/v2 多会话治理	整数:`integer >= 0`	留空(库缺省)	否
`TANSR_SERVE_MAX_SESSION_LIFETIME_MS`	/v2 多会话治理	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_MAX_TURNS_PER_SESSION`	/v2 多会话治理	整数:`integer >= 1`	留空(库缺省)	否
`TANSR_SERVE_SESSION_SHARD`	/v2 多副本分片	整数:`integer in [0, 255]`	留空(库缺省)	否
`TANSR_SERVE_NOTIFY_URL`	/v2 轮末 webhook 出站	URL:`absolute http(s) URL`	留空(库缺省)	否
`TANSR_SERVE_NOTIFY_SECRET`	/v2 轮末 webhook 出站	字符串:`non-empty string; value never logged; requires TANSR_SERVE_NOTIFY_URL`	留空(库缺省)	是
`TANSR_SERVE_UPSTREAM_MAX_INFLIGHT`	上游治理层	整数:`integer >= 1`	留空(库缺省)	否
`TANSR_SERVE_UPSTREAM_CONNECT_TIMEOUT_MS`	驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_UPSTREAM_IDLE_TIMEOUT_MS`	驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_UPSTREAM_TOTAL_TIMEOUT_MS`	驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_TURN_WALL_CLOCK_MS`	驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	否
`TANSR_SERVE_SSE_MAX_BUFFER_BYTES`	SSE 传输	整数:`integer >= 1;bytes`	留空(库缺省)	否
`TANSR_SERVE_SSE_SLOW_POLICY`	SSE 传输	枚举:`disconnect\|drop-oldest`	留空(库缺省)	否
`TANSR_SERVE_SSE_RETRY_MS`	SSE 传输	整数:`integer >= 0;ms`	留空(库缺省)	否
`TANSR_SERVE_LOG_FORMAT`	日志形态	枚举:`json\|text`	留空(库缺省)	否
`TANSR_SERVE_ON_UNHANDLED`	进程级兜底	枚举:`log\|drain-exit`	留空(库缺省)	否
`TANSR_SERVE_READY_STREAM`	进程级兜底	枚举:`stdout\|stderr\|none`	留空(库缺省)	否
`TANSR_SERVE_CWD_ON_RESUME`	factory	枚举:`current\|stored`	留空(库缺省)	否
`TANSR_SERVE_SESSION_MAX_AGE_DAYS`	factory	整数:`integer >= 1;days`	留空(库缺省)	否
`TANSR_SERVE_SESSION_MAX_PER_END_USER`	factory	整数:`integer >= 1`	留空(库缺省)	否

准入 / 过载保护

组 admission,共 4 键。

TANSR_SERVE_MAX_ACTIVE_SESSIONS

组	类型	缺省	说明	敏感
准入 / 过载保护	整数:`integer >= 1`	留空(库缺省)	对应运行时选项 `admission.maxActiveSessions`。	否

TANSR_SERVE_MAX_SSE_CONNECTIONS

组	类型	缺省	说明	敏感
准入 / 过载保护	整数:`integer >= 1`	留空(库缺省)	对应运行时选项 `admission.maxSseConnections`。	否

TANSR_SERVE_MAX_INFLIGHT_BODY_BYTES

组	类型	缺省	说明	敏感
准入 / 过载保护	整数:`integer >= 1;bytes`	留空(库缺省)	对应运行时选项 `admission.maxInflightBodyBytes`。	否

TANSR_SERVE_ELD_THRESHOLD_MS

组	类型	缺省	说明	敏感
准入 / 过载保护	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `admission.eventLoopDelayP99Ms`。	否

node:http 参数

组 http,共 1 键。

TANSR_SERVE_REQUEST_TIMEOUT_MS

组	类型	缺省	说明	敏感
node:http 参数	整数:`integer >= 0;ms`	留空(库缺省)	对应运行时选项 `http.requestTimeout`。	否

观测端点暴露

组 observability,共 2 键。

TANSR_SERVE_EXPOSE_OBSERVABILITY

组	类型	缺省	说明	敏感
观测端点暴露	布尔:`1\|true\|yes\|on / 0\|false\|no\|off`	留空(库缺省)	对应运行时选项 `observability.expose`。	否

TANSR_SERVE_EXPOSE_METRICS

组	类型	缺省	说明	敏感
观测端点暴露	布尔:`1\|true\|yes\|on / 0\|false\|no\|off`	留空(库缺省)	对应运行时选项 `observability.exposeMetrics`。	否

事件环形缓冲

组 ring,共 1 键。

TANSR_SERVE_EVENT_BUFFER_MAX_BYTES

组	类型	缺省	说明	敏感
事件环形缓冲	整数:`integer >= 1;bytes`	留空(库缺省)	对应运行时选项 `eventBufferMaxBytes`。	否

/v2 多会话治理

组 governance,共 5 键。

TANSR_SERVE_ORPHAN_GRACE_MS

组	类型	缺省	说明	敏感
/v2 多会话治理	整数:`integer >= 0;ms`	留空(库缺省)	对应运行时选项 `v2.governance.orphanGraceMs`。	否

TANSR_SERVE_IDLE_AFTER_GONE_MS

组	类型	缺省	说明	敏感
/v2 多会话治理	整数:`integer >= 0;ms`	留空(库缺省)	对应运行时选项 `v2.governance.idleAfterGoneMs`。	否

TANSR_SERVE_MAX_RETAINED_SESSIONS

组	类型	缺省	说明	敏感
/v2 多会话治理	整数:`integer >= 0`	留空(库缺省)	对应运行时选项 `v2.governance.maxRetainedSessions`。	否

TANSR_SERVE_MAX_SESSION_LIFETIME_MS

组	类型	缺省	说明	敏感
/v2 多会话治理	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `v2.governance.maxSessionLifetimeMs`。	否

TANSR_SERVE_MAX_TURNS_PER_SESSION

组	类型	缺省	说明	敏感
/v2 多会话治理	整数:`integer >= 1`	留空(库缺省)	对应运行时选项 `v2.governance.maxTurnsPerSession`。	否

/v2 多副本分片

组 v2,共 1 键。

TANSR_SERVE_SESSION_SHARD

组	类型	缺省	说明	敏感
/v2 多副本分片	整数:`integer in [0, 255]`	留空(库缺省)	对应运行时选项 `v2.sessionIdShard`。	否

/v2 轮末 webhook 出站

组 notify,共 2 键。

TANSR_SERVE_NOTIFY_URL

组	类型	缺省	说明	敏感
/v2 轮末 webhook 出站	URL:`absolute http(s) URL`	留空(库缺省)	对应运行时选项 `v2.onTurnEndNotify.url`。	否

TANSR_SERVE_NOTIFY_SECRET

组	类型	缺省	说明	敏感
/v2 轮末 webhook 出站	字符串:`non-empty string; value never logged; requires TANSR_SERVE_NOTIFY_URL`	留空(库缺省)	对应运行时选项 `v2.onTurnEndNotify.secret`;取值不入日志与告警。	是

上游治理层

组 upstream,共 1 键。

TANSR_SERVE_UPSTREAM_MAX_INFLIGHT

组	类型	缺省	说明	敏感
上游治理层	整数:`integer >= 1`	留空(库缺省)	对应运行时选项 `governor.bulkhead.maxConcurrent`。	否

驱动分层超时 / 每轮墙钟

组 session,共 4 键。

TANSR_SERVE_UPSTREAM_CONNECT_TIMEOUT_MS

组	类型	缺省	说明	敏感
驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `session.timeouts.connectTimeoutMs`。	否

TANSR_SERVE_UPSTREAM_IDLE_TIMEOUT_MS

组	类型	缺省	说明	敏感
驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `session.timeouts.idleTimeoutMs`。	否

TANSR_SERVE_UPSTREAM_TOTAL_TIMEOUT_MS

组	类型	缺省	说明	敏感
驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `session.timeouts.totalTimeoutMs`。	否

TANSR_SERVE_TURN_WALL_CLOCK_MS

组	类型	缺省	说明	敏感
驱动分层超时 / 每轮墙钟	整数:`integer >= 1;ms`	留空(库缺省)	对应运行时选项 `session.maxTurnWallClockMs`。	否

SSE 传输

组 sse,共 3 键。

TANSR_SERVE_SSE_MAX_BUFFER_BYTES

组	类型	缺省	说明	敏感
SSE 传输	整数:`integer >= 1;bytes`	留空(库缺省)	对应运行时选项 `sse.maxBufferBytes`。	否

TANSR_SERVE_SSE_SLOW_POLICY

组	类型	缺省	说明	敏感
SSE 传输	枚举:`disconnect\|drop-oldest`	留空(库缺省)	对应运行时选项 `sse.onSlowSubscriber`。	否

TANSR_SERVE_SSE_RETRY_MS

组	类型	缺省	说明	敏感
SSE 传输	整数:`integer >= 0;ms`	留空(库缺省)	对应运行时选项 `sse.retryMs`。	否

日志形态

组 log,共 1 键。

TANSR_SERVE_LOG_FORMAT

组	类型	缺省	说明	敏感
日志形态	枚举:`json\|text`	留空(库缺省)	对应运行时选项 `logger.log`。	否

进程级兜底

组 process,共 2 键。

TANSR_SERVE_ON_UNHANDLED

组	类型	缺省	说明	敏感
进程级兜底	枚举:`log\|drain-exit`	留空(库缺省)	对应运行时选项 `processGuards.onFatal`。	否

TANSR_SERVE_READY_STREAM

组	类型	缺省	说明	敏感
进程级兜底	枚举:`stdout\|stderr\|none`	留空(库缺省)	对应运行时选项 `readyFrame`。	否

factory

组 factory,共 3 键。

TANSR_SERVE_CWD_ON_RESUME

组	类型	缺省	说明	敏感
factory	枚举:`current\|stored`	留空(库缺省)	对应运行时选项 `factory.cwdOnResume`。	否

TANSR_SERVE_SESSION_MAX_AGE_DAYS

组	类型	缺省	说明	敏感
factory	整数:`integer >= 1;days`	留空(库缺省)	对应运行时选项 `factory.sessions.retention.maxAgeDays`。	否

TANSR_SERVE_SESSION_MAX_PER_END_USER

组	类型	缺省	说明	敏感
factory	整数:`integer >= 1`	留空(库缺省)	对应运行时选项 `factory.sessions.retention.maxPerEndUser`。	否