在运行 cf 的环境中设置这些变量。它们配置 CLI,而不是已部署 Worker 可用的环境变量或 secrets。如果变量未设置,cf 使用默认值列中的行为。
以下变量控制 cf 行为:
| 变量 | 默认值 | 效果 |
|---|---|---|
CF_FORCE_OSC_PROGRESS |
未设置;仅受识别的终端会在终端缓冲区外显示进度。 | 设为 1 可在未识别但兼容的终端中启用终端进度。需要标准错误上有终端。 |
CF_NO_OSC_PROGRESS |
未设置;受支持的终端显示进度。 | 设为 1 可关闭终端标签标题或任务栏中的进度。 |
CF_QUIET |
未设置;显示交互式进度。 | 设为 1 可抑制动画 API 进度和终端进度。不会抑制命令结果。 |
CF_SEND_TELEMETRY |
未设置;使用已保存的偏好或默认值。 | 设为 true 或 1 启用匿名 CLI 使用遥测,设为 false 或 0 则禁用。优先于 WRANGLER_SEND_METRICS,但不优先于 DO_NOT_TRACK。 |
CI |
未设置;cf 也会检测 CI 提供商以及是否缺少终端。 |
在 CI 中设为 true 以避免交互式提示。提示使用默认值,或在必须作答时失败。 |
CLOUDFLARE_ACCESS_CLIENT_ID |
未设置;不提供 Access 服务令牌 client ID。 | 标识用于连接受 Access 保护的 Workers 的服务令牌。请与 CLOUDFLARE_ACCESS_CLIENT_SECRET 一起设置。 |
CLOUDFLARE_ACCESS_CLIENT_SECRET |
未设置;不提供 Access 服务令牌密钥。 | 提供 Access 服务令牌的密钥。请与 CLOUDFLARE_ACCESS_CLIENT_ID 一起设置。 |
CLOUDFLARE_ACCOUNT_ID |
未设置;cf 使用项目配置、已保存的选择或可访问的账户。 |
为账户范围的命令选择账户。覆盖 cloudflare.config.ts 中的 accountId。 |
CLOUDFLARE_API_BASE_URL |
所选合规区域的 Cloudflare API 端点。 | 覆盖 API 端点。仅指向你信任的端点,因为 API 请求会携带凭据。 |
CLOUDFLARE_API_TOKEN |
未设置;cf 使用所选 OAuth profile。 |
使用此令牌而非已保存的 profile 对 API 命令进行身份验证。用于 CI 和其他自动化。 |
CLOUDFLARE_COMPLIANCE_REGION |
public,除非在 cloudflare.config.ts 中设置。 |
选择 API 合规区域并覆盖项目配置。接受 public、fedramp_high 或 fedramp-high。 |
CLOUDFLARE_REGISTRY_PATH |
cf 配置目录中的 registry 目录。 |
设置与 Wrangler 以及由 cf 启动的 Miniflare 进程共享的本地开发 registry 路径。 |
CLOUDFLARE_ZONE_ID |
未设置;zone 范围的命令需要 zone。 | 提供默认 zone ID 或域名。--zone 或 -z 选项优先。 |
DEBUG |
未设置;显示常规诊断信息。 | 设为非空值可显示额外诊断信息,包括错误堆栈跟踪和委派命令详情。 |
DO_NOT_TRACK |
未设置;遥测遵循其他设置。 | 设为 1 可禁用 CLI 遥测,即使 CF_SEND_TELEMETRY 已启用。 |
FORCE_COLOR |
未设置;当标准输出为终端时使用颜色。 | 设为非 0 的值可在没有终端时启用带样式的输出。NO_COLOR 优先。 |
NO_COLOR |
未设置;当标准输出为终端时使用颜色。 | 设为任意值可禁用带样式的输出和动画 API 进度。 |
TUNNEL_MANAGEMENT_TOKEN |
未设置;cf tunnels tail 会为指定的 tunnel ID 请求令牌。 |
向 cf tunnels tail 提供已有的管理令牌。设置此项时不要传入 tunnel ID。 |
WRANGLER_SEND_METRICS |
未设置;cf 使用其已保存的遥测偏好或启用遥测。 |
在未设置 CF_SEND_TELEMETRY 时设置 CLI 遥测。接受 true、false、1 或 0。 |
cf 仅从项目 .env 文件加载选定的身份验证和上下文变量。此表中的其他变量必须在进程环境中设置。有关受支持的文件变量、优先级和安全建议,请参阅从 .env 文件加载凭据。
有关 API 令牌和账户选择的更多信息,请参阅安装并登录。有关 CI 中的遥测设置,请参阅在 CI 中使用 cf。