docs(env): 补全 .env.example 缺失的 5 个环境变量

代码中经 env::var 读取但示例文件遗漏:

- EXPOSE_VERSION_HEADERS (main.rs:232, 安全相关, 控制版本暴露响应头)
- SYSINFO_SAMPLE_SECS (sysinfo_sampler.rs:46, 后台采样间隔)
- CODE_RUNNER_MAX_SOURCE_BYTES (runner_config.rs:67)
- CODE_RUNNER_QUEUE_TIMEOUT_SECS (runner_config.rs:79)
- CODE_RUNNER_TASK_TTL_SECS (runner_config.rs:83)

默认值与代码一致, 注释风格沿用现有分组(安全段 / tuning 段 /
Code Runner 段)。交叉核对确认示例文件无多余项。
This commit is contained in:
xfy 2026-07-16 11:42:30 +08:00
parent d1c41e8fc5
commit fdf2243299

View File

@ -55,6 +55,10 @@ TRUSTED_PROXY_COUNT=0
# 仅对经连接池DB_POOL建立的连接生效作用是防止单条慢查询长时间占用连接拖垮池。
# 需注意PostgreSQL 的总连接数受 max_connections 限制,本超时不影响已占连接的计费。
STATEMENT_TIMEOUT_SECS=30
# 是否附加版本暴露响应头Server / X-Yggdrasil-Version / X-Yggdrasil-Git
# 默认开启;注重安全、不想对外暴露具体版本/commit 时设 0/false/no 关闭。
# bool 解析与 COOKIE_SECURE 一致(识别 0/false/no 为关闭,其余视为开启)。
EXPOSE_VERSION_HEADERS=true
# ─────────────────────────────────────────────────────────────
# WebP 编码配置(仅上传转码 / 图片格式转换时生效)
@ -87,6 +91,11 @@ MIGRATE_STARTUP_TIMEOUT_SECS=30
# 此 TTL 是唯一有效的 SSR 缓存失效手段——意味着文章更新后最长可能滞后 TTL 秒才可见。
SSR_CACHE_SECS=3600
# 系统信息后台采样间隔,单位秒(默认 0.5)。
# 仅影响 /admin/system 服务器状态页的刷新粒度;服务端函数读取快照零成本,前端可高频轮询。
# 支持小数(如 0.2),下限 0.05;过低会徒增 CPU 占用而无可见收益。
SYSINFO_SAMPLE_SECS=0.5
# HTTP 响应压缩算法。逗号分隔,大小写不敏感。
# 支持gzip、brotli可简写为 br、deflate、zstd。
# 默认关闭压缩(不设环境变量时等同 "off")。
@ -141,6 +150,14 @@ CODE_RUNNER_MAX_CPU_CORES=2.0
CODE_RUNNER_MAX_MEMORY_MB=1024
CODE_RUNNER_MAX_TIMEOUT_SECS=30
CODE_RUNNER_MAX_OUTPUT_BYTES=1048576
# 容器可接收的源码字节上限(默认 65536。超过即拒绝防止超大输入撑爆容器。
CODE_RUNNER_MAX_SOURCE_BYTES=65536
# 任务排队等容器槽的最长时间,单位秒(默认 30
# 受 CODE_RUNNER_MAX_CONCURRENT 限制,并发满时新任务排队,超时则失败。
CODE_RUNNER_QUEUE_TIMEOUT_SECS=30
# 进度表DashMap中任务条目的存活时长单位秒默认 300
# 超期后任务记录被 gc_old_tasks 清理;前端轮询结果需在此窗口内完成。
CODE_RUNNER_TASK_TTL_SECS=300
# 默认全开:注册表里的语言均可用。设置则收窄到逗号分隔列表(如 python,node
# CODE_RUNNER_LANGUAGES=python,node
DOCKER_SOCKET_PATH=/var/run/docker.sock