Skip to content

环境变量 ​

概述 ​

SForge 只读取少量 SFORGE_* 环境变量。凡是有 CLI 参数的设置(模型、推理强度、超时、backend、资源限制)都用参数或实验配置设置,不用环境变量。优先级为:

默认值  <  环境变量  <  实验 YAML  <  CLI 参数

实验文件的 env: 段会在读取其他内容之前设置到 sforge run 进程中。

Agent ​

变量用途
SFORGE_AGENT_API_KEY模型 API key。它只留在宿主机上:由 judge server 的 LLM 网关加到 Agent 的请求里
SFORGE_AGENT_API_BASE_URL模型 API 端点,不用 Agent 默认 API 时设置(Claude Code 和 OpenCode 默认 Anthropic,Codex 默认 OpenAI)
SFORGE_AGENT_EXTRA_ENV传给 work 容器的额外变量,格式 "KEY1=VAL1,KEY2=VAL2"(例如 Claude Code 的模型路由变量)
SFORGE_NODEJS_MIRROR_URL宿主机构建 Agent bundle 时使用的 Node.js 下载镜像(压缩包仍按固定 sha256 校验)
SFORGE_CACHE_DIRAgent bundle 和 sforge replay 的缓存目录(默认 ~/.cache/sforge)

Judge ​

变量用途
SFORGE_JUDGE_EXTRA_ENV传给 judge 容器的变量,格式 "KEY1=VAL1,KEY2=VAL2",例如 LLM 评分任务需要的凭据。Judge 容器不会从宿主机得到任何其他东西
SFORGE_ADMIN_SECRETsforge run 与外部 sforge serve 之间的共享密钥(会话登记、auto-eval、用量查询)。未设置时,sforge serve 在 SFORGE_LOG_DIR 下创建权限为 0600 的文件,sforge run 从同一位置读取;进程内 judge 使用随机值。绝不能暴露给 work 容器

镜像与任务 ​

变量默认值用途
SFORGE_BENCHMARKedgebenchbenchmark 目录,即 -b 的默认值
SFORGE_LOG_DIRlogs/构建日志和运行输出
SFORGE_REGISTRYbenchmark 的 registrysforge pull / sforge push 使用的 registry 前缀,镜像地址为 <前缀>/<镜像>:<tag>
SFORGE_BLOB_URLbenchmark 的 blob_urlsforge build 下载任务 blob 的地址,形如 <url>/<sha256>(可用 file:// 指向本地副本)

代理 ​

配置依次检查的环境变量(先命中者生效)
HTTP 代理SFORGE_HTTP_PROXY > HTTP_PROXY > http_proxy
HTTPS 代理SFORGE_HTTPS_PROXY > HTTPS_PROXY > https_proxy
不走代理的地址SFORGE_NO_PROXY > NO_PROXY > no_proxy

代理在哪些环节使用,见网络配置。

容器后端 ​

变量默认值用途
SFORGE_K8S_NAMESPACEdefaultKubernetes namespace
SFORGE_K8S_IMAGE_REGISTRYSFORGE_REGISTRY,否则 benchmark 的 registryPod 拉取镜像的 registry 前缀
SFORGE_K8S_KUBECONFIG---kubeconfig 文件路径
SFORGE_K8S_NODE_SELECTOR---Pod 的节点选择器,格式 "key1=val1,key2=val2"
SFORGE_E2B_TEMPLATE_NAMESPACE---共享 E2B Template 所在的 namespace(不设置则使用你自己团队的 Template)
SFORGE_E2B_TEMPLATE_MAP---显式的镜像 key 到 Template 的映射,覆盖推导出的名称。内联 "image_key=template,...",或以 .json 结尾、内容为 JSON 对象的文件路径
SFORGE_E2B_PROVIDERe2bE2B 兼容的 provider:e2b(官方)或 vefaas(火山引擎 veFaaS)。run 和 serve 两端都要设置

E2B SDK 自己读取 E2B_API_KEY(其他端点还需 E2B_DOMAIN)。

示例 ​

bash
# 模型
export SFORGE_AGENT_API_KEY="sk-ant-..."

# LLM 评分任务的凭据
export SFORGE_JUDGE_EXTRA_ENV="SFORGE_JUDGE_API_KEY=sk-...,SFORGE_JUDGE_MODEL=gpt-5.5"

# Kubernetes
export SFORGE_K8S_NAMESPACE="sforge-runs"

sforge run --backend k8s --task ad_placement_optimization --agent claude-code \
  --model claude-opus-4-8 --timeout 43200 \
  --work-cpu-limit 4 --work-mem-limit 16g \
  --judge-advertise 10.0.0.12 --judge-port 8080