.env 是本机私有 HFS v2 value ledger，不是 runtime 自动加载文件，也不是要上传到 GitHub 或 Hugging Face 的 env-file。以无密 .env.example 起步；遗留 .env.local 继续保持 gitignored。公开仓库只维护本文件这类 reference：写 key、分类、默认值、建议位置和说明，不写真实值。
远端 Settings、Space visibility、mount 与 Secret presence 必须在实际发布窗口重新只读回读；本文不把历史盘点当作当前部署事实。
hfs-dev.toml 和 candidate manifest 只登记具有安全非空语义的基础运行键。clean no-paid profile 不创建注册 allowlist、模型/provider tuple、外部 S3 endpoint/region 或外部 VikingDB endpoint/region/scheme 的空值和占位值。未设置这些扩展项时，render-env.sh 仍会生成完整 runtime env：文件存储使用本地 MinIO，搜索使用本地 Elasticsearch，向量存储使用本地 Milvus；模型/provider tuple 不会形成可用配置，因此不会凭空启用需要付费或外部凭据的业务能力。
| Key | 默认值 | 建议 | 说明 |
|---|---|---|---|
COZE_RUNTIME_MANIFEST_URI |
空 | artifact runtime 必填 | 直接 HTTPS manifest URL；不得带 query、fragment 或嵌入凭据。bootstrap 只读取一次，按 manifest 下载同目录的 按 source commit 命名的 BUILD_SOURCE-<commit>.json、server、web。 |
DISABLE_USER_REGISTRATION |
true |
true |
公开 Space 默认关闭注册。 |
ENABLE_LOCAL_MINIO |
1 |
P0/P1 可保留 1 |
本地 MinIO fallback；设为 0 时必须提供外部 object storage，并确保内置 Milvus 可访问 MINIO_ADDRESS。 |
COZE_PUBLIC_URL |
从 SPACE_HOST 推导 |
https://blueskyxn-coze-all-in-one-hfs.hf.space |
公开 URL；自定义域名时显式覆盖。 |
LOG_LEVEL |
info |
info |
Coze Server 日志级别。 |
CODE_RUNNER_TYPE |
sandbox |
sandbox |
v0.5.1 空值会回退到 local runner；公开部署必须显式保持 sandbox。 |
PERSISTENCE_REQUIRED |
false |
挂载 /data/coze volume 后设为 true |
为 true 时，/_ops/healthz 会确认 /data/coze 是独立 mount；volume 丢失时返回 503。 |
CODE_RUNNER_ALLOW_NET |
cdn.jsdelivr.net |
按业务最小化 | Pyodide sandbox 初次加载所需网络 allowlist。 |
CODE_RUNNER_TIMEOUT_SECONDS |
60 |
按需调整 | workflow code runner 超时。 |
CODE_RUNNER_MEMORY_LIMIT_MB |
100 |
按需调整 | workflow code runner 内存限制。 |
ADMIN_ENABLED |
false |
默认保持 false |
是否开启 /_admin/ 管理面；公开 Space 不建议长期开启。 |
ES_ADDR |
http://127.0.0.1:9200 |
默认不上传 | 内置 Elasticsearch；只有改用外部 ES/OpenSearch 时才覆盖。 |
VECTOR_STORE_TYPE |
milvus |
默认不上传 | 内置 Milvus；只有改用 VikingDB/OceanBase/外部 Milvus 时才覆盖。 |
| Key | 用途 | 说明 |
|---|---|---|
COZE_RUNTIME_DOWNLOAD_TOKEN |
私有 artifact 下载 bearer token | 仅在直接 HTTPS artifact endpoint 需要认证时设置；只经 header 发送，绝不放 URI。 |
MODEL_API_KEY_0 |
默认模型 API key | OpenAI-compatible 模型配置。 |
BUILTIN_CM_OPENAI_API_KEY |
内置 conversation model key | 通常与默认模型 key 同源。 |
OPENAI_EMBEDDING_API_KEY |
Embedding key | 启用知识库/RAG 时配置。 |
OPS_TOKEN |
/_ops/ dashboard/API token |
至少 24 字符的强随机值。 |
ADMIN_TOKEN |
/_admin/ 独立管理 token |
只有 ADMIN_ENABLED=true 时需要；不要复用 OPS_TOKEN。 |
ADMIN_CSRF_KEY |
admin cookie session CSRF HMAC key | 可选；未配置时从 SECRET_KEY 派生，最后回退到 ADMIN_TOKEN。 |
S3_ACCESS_KEY |
S3/TOS/ImageX access key | 文件上传和多模态建议外接对象存储。 |
S3_SECRET_KEY |
S3/TOS/ImageX secret key | 必须放 Secret。 |
ES_PASSWORD |
ES/OpenSearch password | 私有检索服务凭据。 |
VIKING_DB_AK / VIKING_DB_SK |
VikingDB 凭据 | 使用 VikingDB vector store 时配置。 |
TOS_ACCESS_KEY / TOS_SECRET_KEY |
火山 TOS 凭据 | 使用 TOS 时配置。 |
以下配置不是 clean no-paid profile 的必需项。selector 类键可以保留安全的本地默认值；注册 allowlist、模型/provider、S3 endpoint 和 VikingDB endpoint 相关键不登记在 clean manifests，也不应以空值、个人信息或示例 endpoint 同步。只有建立完整、经批准的扩展 profile 时才设置；私有 endpoint 与凭据放 HF Secrets。
| Key | 扩展 profile 示例 | 说明 |
|---|---|---|
ALLOW_REGISTRATION_EMAIL |
user@example.com |
仅限受控注册测试；v0.5.1 fresh fallback config 存在 upstream 读取缺陷，必须做真实注册 smoke，且不写入公开 PR、截图或 clean manifest。 |
MODEL_PROTOCOL_0 |
openai |
模型协议。 |
MODEL_OPENCOZE_ID_0 |
100001 |
Coze 内部模型 ID。 |
MODEL_NAME_0 |
example-model |
页面显示名。 |
MODEL_ID_0 |
example-model |
Provider 模型 ID。 |
MODEL_BASE_URL_0 |
https://provider.example/v1 |
如果 URL 含租户或私有网关信息，改放 Secret。 |
BUILTIN_CM_TYPE |
openai |
内置模型类型。 |
BUILTIN_CM_OPENAI_BASE_URL |
https://provider.example/v1 |
如果 URL 含私有信息，改放 Secret。 |
BUILTIN_CM_OPENAI_MODEL |
example-model |
内置模型 ID。 |
FILE_UPLOAD_COMPONENT_TYPE |
storage |
外接对象存储时使用。 |
STORAGE_TYPE |
s3 |
也可按上游支持填 tos 等。 |
S3_ENDPOINT |
https://s3.example.com |
私有 endpoint 视敏感程度放 Secret。 |
S3_BUCKET_ENDPOINT |
https://bucket.example.com |
公开 bucket endpoint 可放 Variable。 |
S3_REGION |
us-east-1 |
S3 region。 |
STORAGE_BUCKET |
opencoze |
bucket 名若敏感则放 Secret。 |
ES_ADDR |
https://es.example.com |
默认内置本地 ES；外部 endpoint 视敏感程度放 Secret。 |
ES_VERSION |
v8 |
ES 版本。 |
VECTOR_STORE_TYPE |
vikingdb |
默认内置 milvus；外部向量库才覆盖。 |
VIKING_DB_HOST |
api-vikingdb.example.com |
私有 endpoint 视敏感程度放 Secret。 |
VIKING_DB_REGION |
cn-beijing |
region。 |
VIKING_DB_SCHEME |
https |
scheme。 |
不要手动设置这些 key：
SPACE_ID
SPACE_HOST
HF_HOME
SPACE_HOST 由 Hugging Face runtime 注入，render-env.sh 会在未设置 COZE_PUBLIC_URL 时自动推导 https://${SPACE_HOST}。
/_ops/healthz、/_ops/readyz 和 /_ops/status 是公开只读健康探针，供 Docker healthcheck、HF smoke 和外部 uptime 使用。完整 /_ops/ dashboard/API 需要 OPS_TOKEN：
OPS_HOST=127.0.0.1
OPS_PORT=8081
OPS_TOKEN=<fixed-random-token>
OPS_LOG_DIR=/data/coze/logs
OPS_LOG_SERVICES_JSON=
OPS_LOG_LINES_MAX=1000
OPS_LOG_TAIL_MAX_BYTES=1048576
认证支持：
X-Ops-Token: <token>
Authorization: Bearer <token>
OPS_TOKEN 至少 24 字符。浏览器打开 /_ops/ 后在页面输入 token；token 只保留在当前页面内存中。服务拒绝 ?token=，避免 secret 进入浏览器历史、代理日志和 access log。CLI 和自动化使用 header。
/_admin/ 是独立管理面，默认关闭，不复用 OPS_TOKEN：
ADMIN_ENABLED=false
ADMIN_HOST=127.0.0.1
ADMIN_PORT=8082
ADMIN_TOKEN=
ADMIN_CSRF_KEY=
ADMIN_SESSION_TTL_SECONDS=3600
ADMIN_COOKIE_SECURE=auto
ADMIN_AUDIT_LOG=/data/coze/admin/audit.jsonl
ADMIN_LOGIN_RATE_LIMIT_WINDOW_SECONDS=300
ADMIN_LOGIN_RATE_LIMIT_BLOCK_SECONDS=300
ADMIN_LOGIN_RATE_LIMIT_MAX_PER_IP=5
ADMIN_LOGIN_RATE_LIMIT_MAX_GLOBAL=30
开启后当前白名单 action：
POST /_admin/api/actions/restart-service
POST /_admin/api/actions/run-health-checks
ADMIN_TOKEN 至少 24 字符且不能复用 OPS_TOKEN。admin service 使用独立 cozeadmin OS user，Supervisor socket 是 0700 cozeadmin:cozeadmin。action 必须传 confirm=true；浏览器 cookie session 还必须带 X-Admin-CSRF；CLI 使用 X-Admin-Token 或 Authorization: Bearer 时跳过 CSRF，但仍需要 token、白名单、confirm 和 audit。不要把 shell、SQL、secret rotation、任意命令或文件管理写入能力放进 /_ops。
Coze v0.5.1 自带的 /admin、/api/admin/* 因 upstream admin email 空配置 fail-open 被 Nginx 临时阻断。不要把 /_admin 与 upstream 内置 admin UI/API 混为一谈。
推荐保留四层：
# [HF_SPACE]
# [HF_VARIABLES]
# [HF_SECRETS]
# [LOCAL_OPS]
上传原则：
- 只上传需要生效的非空值。
- 空占位不上传，避免把云端覆盖成空字符串。
- HF Secrets 只能回读 key，不能回读明文；一致性通过本地台账、key 清单和 live smoke 闭环确认。
- GH Variables/Secrets 当前没有运行时需求，保持为空。