跳转到主要内容

Environment variables

Set these variables in the environment that runs cf. They configure the CLI, not the environment variables or secrets available to a deployed Worker. If a variable is unset, cf uses the behavior in the Default column.

Supported variables

The following variables control cf behavior:

Variable Default Effect
CF_FORCE_OSC_PROGRESS Unset; only recognized terminals show progress outside the terminal buffer. Set to 1 to enable terminal progress in an unrecognized compatible terminal. Requires a terminal on standard error.
CF_NO_OSC_PROGRESS Unset; supported terminals show progress. Set to 1 to turn off progress in the terminal tab title or taskbar.
CF_QUIET Unset; interactive progress is shown. Set to 1 to suppress animated API progress and terminal progress. It does not suppress command results.
CF_SEND_TELEMETRY Unset; a saved preference or the default applies. Set to true or 1 to enable anonymous CLI usage telemetry, or false or 0 to disable it. Takes precedence over WRANGLER_SEND_METRICS, but not DO_NOT_TRACK.
CI Unset; cf also detects CI providers and the absence of a terminal. Set to true in CI to avoid interactive prompts. Prompts use defaults or fail when an answer is required.
CLOUDFLARE_ACCESS_CLIENT_ID Unset; no Access service-token client ID is supplied. Identifies the service token used to connect to Access-protected Workers. Set it with CLOUDFLARE_ACCESS_CLIENT_SECRET.
CLOUDFLARE_ACCESS_CLIENT_SECRET Unset; no Access service-token secret is supplied. Supplies the secret for the Access service token. Set it with CLOUDFLARE_ACCESS_CLIENT_ID.
CLOUDFLARE_ACCOUNT_ID Unset; cf uses project configuration, a saved selection, or an accessible account. Selects the account for account-scoped commands. Overrides accountId in cloudflare.config.ts.
CLOUDFLARE_API_BASE_URL The Cloudflare API endpoint for the selected compliance region. Overrides the API endpoint. Only point it at an endpoint you trust because API requests carry credentials.
CLOUDFLARE_API_TOKEN Unset; cf uses the selected OAuth profile. Authenticates API commands with this token instead of a saved profile. Use it for CI and other automation.
CLOUDFLARE_COMPLIANCE_REGION public, unless set in cloudflare.config.ts. Selects the API compliance region and overrides the project configuration. Accepts public, fedramp_high, or fedramp-high.
CLOUDFLARE_REGISTRY_PATH The registry directory in the cf configuration directory. Sets the local development registry path shared with Wrangler and Miniflare processes started by cf.
CLOUDFLARE_ZONE_ID Unset; zone-scoped commands need a zone. Supplies a default zone ID or domain name. The --zone or -z option takes precedence.
DEBUG Unset; normal diagnostics are shown. Set to a nonempty value to show additional diagnostics, including error stack traces and delegated command details.
DO_NOT_TRACK Unset; telemetry follows the other settings. Set to 1 to disable CLI telemetry, even if CF_SEND_TELEMETRY enables it.
FORCE_COLOR Unset; color is used when standard output is a terminal. Set to a value other than 0 to enable styled output without a terminal. NO_COLOR takes precedence.
NO_COLOR Unset; color is used when standard output is a terminal. Set to any value to disable styled output and animated API progress.
TUNNEL_MANAGEMENT_TOKEN Unset; cf tunnels tail requests a token for the specified tunnel ID. Supplies an existing management token to cf tunnels tail. Do not pass a tunnel ID when this is set.
WRANGLER_SEND_METRICS Unset; cf uses its saved telemetry preference or enables telemetry. Sets CLI telemetry when CF_SEND_TELEMETRY is not set. Accepts true, false, 1, or 0.

cf loads only selected authentication and context variables from a project .env file. Other variables in this table must be set in the process environment. For the supported file variables, precedence, and security guidance, refer to Load credentials from a .env file.

For more on API tokens and account selection, refer to Install and sign in. For telemetry settings in CI, refer to Use cf in CI.

这篇文档对你有帮助吗？
想留言或继续讨论？请到 Cyberforums 赛博论坛参与。 参与讨论 / 回复