跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

在无头 Linux 设备上部署 Cloudflare One Client

最后更新 查看 MarkdownAgent 设置

本教程说明如何使用服务令牌和安装脚本在 Linux 设备上部署 Cloudflare One 客户端。此部署工作流适用于无头服务器(即无法通过浏览器登录身份提供商的服务器),以及希望完全自动化接入流程的场景。由于设备不会通过身份提供商注册,因此无法使用基于身份的策略和日志记录。

前提条件

  • Cloudflare Zero Trust 账户
  • 在受支持 Linux 设备上的 Root 或 sudo 权限
  • Zero Trust 团队名称
  • 服务令牌的 Client ID 和 Client Secret

1. 创建服务令牌

完全自动化部署依赖服务令牌,将 Cloudflare One Client 注册到您的 Zero Trust 组织。您可以使用同一个令牌注册多台设备;如果设备需要不同的设备配置文件设置,也可以为每台设备生成唯一令牌。

要创建服务令牌:

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Access controls(访问控制) > Service credentials(服务凭据) > Service Tokens(服务令牌)。

  2. 选择 Create Service Token(创建服务令牌)。

  3. 为服务令牌命名。该名称便于您在日志中识别与令牌相关的事件,并可单独撤销令牌。

  4. 选择 Service Token Duration(服务令牌有效期)。这将设置令牌的到期日期。

  5. 选择 Generate token(生成令牌)。您将看到为服务令牌生成的 Client ID 和 Client Secret,以及各自的请求头。

  6. 复制 Client Secret。

  1. 向 Access Service Tokens 端点发出 POST 请求:

    Required API token permissions

    At least one of the following token permissions is required:
    • Access: Service Tokens Write
    Create a service tokenbash
    curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens" \
    	--request POST \
    	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    	--json '{
    		"name": "CI/CD token",
    		"duration": "8760h"
    	}'
  2. 复制响应中返回的 client_id 和 client_secret 值。

    Responsejson
    "result": {
    	"client_id": "88bf3b6d86161464f6509f7219099e57.access",
    	"client_secret": "bdd31cbc4dec990953e39163fbbb194c93313ca9f0a6e420346af9d326b1d2a5",
    	"created_at": "2025-09-25T22:26:26Z",
    	"expires_at": "2026-09-25T22:26:26Z",
    	"id": "3537a672-e4d8-4d89-aab9-26cb622918a1",
    	"name": "CI/CD token",
    	"updated_at": "2025-09-25T22:26:26Z",
    	"duration": "8760h",
    	"client_secret_version": 1
    }
  1. 向您的 cloudflare_api_token ↗ 添加以下权限:

    • Access: Service Tokens Write
  2. 配置 cloudflare_zero_trust_access_service_token ↗ 资源:

    resource "cloudflare_zero_trust_access_service_token" "example_service_token" {
    	account_id = var.cloudflare_account_id
    	name       = "Example service token"
    	duration  = "8760h"
    
    	lifecycle {
    		create_before_destroy = true
    	}
    }
  3. 获取服务令牌的 Client ID 和 Client Secret:

    示例:输出到 CLI

    1. 将 Client ID 和 Client Secret 输出到 Terraform 状态文件:
      output "example_service_token_client_id" {
      	value     = cloudflare_zero_trust_access_service_token.example_service_token.client_id
      }
      
      output "example_service_token_client_secret" {
      	value     = cloudflare_zero_trust_access_service_token.example_service_token.client_secret
      	sensitive = true
      }
    2. 应用配置:
      terraform apply
    3. 读取 Client ID 和 Client Secret:
      terraform output -raw example_service_token_client_id
      terraform output -raw example_service_token_client_secret

    示例:存储在 HashiCorp Vault 中

    	resource "vault_generic_secret" "example_service_token" {
    		path         = "kv/cloudflare/example_service_token"
    
    		data_json = jsonencode({
    			"CLIENT_ID"     = cloudflare_access_service_token.example_service_token.client_id
    			"CLIENT_SECRET" = cloudflare_access_service_token.example_service_token.client_secret
    		})
    	}

2. 配置设备注册权限

设备注册权限决定哪些用户和设备可以向您的 Zero Trust 组织注册 WARP。

要允许设备使用服务令牌注册:

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Team & Resources > Devices,然后选择 Management 选项卡。

  2. 在 Device enrollment permissions 中,选择 Manage。

  3. 在 Policies 选项卡中,选择 Create new policy。系统会在新选项卡中打开策略创建页面。

  4. 将 Action 设置为 Service Auth。

  5. 对于 Selector 字段,有两种选择:允许所有服务令牌(Any Access Service Token),或仅允许指定服务令牌(Service Token)。例如:

    规则操作 规则类型 选择器 值
    Service Auth(服务身份验证) Include(包含) Service Token(服务令牌) <TOKEN-NAME>
  6. 保存策略。

  7. 返回 Device enrollment permissions,将新创建的策略添加到权限中。

  8. 选择 Save(保存)。

有关使用 Terraform 配置服务令牌注册的方法,请参阅检查服务令牌。

3. 创建安装脚本

您可以使用 shell 脚本自动安装并注册 WARP。以下示例展示如何在 Ubuntu 24.04 上部署 Cloudflare One Client。

  1. 在终端中使用文本编辑器创建新的 .sh 文件。例如:

    umask 077
    vim install_warp.sh
  2. 按 i 进入插入模式,并添加以下内容:

    #!/bin/bash
    set -e
    
    # Download and install the Cloudflare One Client
    function warp() {
            curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
            echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list
            sudo apt-get update --assume-yes
            sudo apt-get install --assume-yes cloudflare-warp
    }
    
    # Create an MDM file with your Cloudflare One Client deployment parameters
    function mdm() {
            sudo install -m 600 /dev/null /var/lib/cloudflare-warp/mdm.xml
            sudo tee /var/lib/cloudflare-warp/mdm.xml > /dev/null << "EOF"
    <dict>
            <key>auth_client_id</key>
            <string>YOUR_CLIENT_ID</string>
            <key>auth_client_secret</key>
            <string>YOUR_CLIENT_SECRET</string>
            <key>auto_connect</key>
            <integer>1</integer>
            <key>onboarding</key>
            <false/>
            <key>organization</key>
            <string>your-team-name</string>
            <key>service_mode</key>
            <string>warp</string>
    </dict>
    EOF
    }
    
    #main program
    warp
    mdm
    sudo systemctl restart warp-svc
  3. 如果使用 Debian 或 RHEL / CentOS,请修改 warp() 函数,使其为您的操作系统安装正确的 WARP 软件包 ↗。

  4. 修改 mdm() 函数中的值:

    1. 对于 auth_client_id 和 auth_client_secret,将字符串值替换为服务令牌的 Client ID 和 Client Secret。
    2. 对于 organization,将 your-team-name 替换为您的 Zero Trust 团队名称。
    3. (可选)根据需要添加或修改其他 Cloudflare One Client 部署参数。
  5. 按 esc,再输入 :x 并按 Enter 保存并退出。

4. 安装 WARP

要使用示例脚本安装 Cloudflare One Client:

  1. 为脚本添加可执行权限:

    chmod 700 install_warp.sh
  2. 运行脚本:

    sudo ./install_warp.sh
  3. 删除脚本,因为其中包含服务令牌密钥:

    rm install_warp.sh

Cloudflare One Client 现已部署,其配置参数保存在仅 Root 可访问的 /var/lib/cloudflare-warp/mdm.xml 中。如果已配置 auto_connect,客户端会自动连接到您的 Zero Trust 组织。

验证注册和连接:

sudo warp-cli --accept-tos registration show
sudo warp-cli --accept-tos status

成功注册后,Zero Trust > Team & Resources > Devices 中会出现一台设备,其电子邮件为 non_identity@<team-name>.cloudflareaccess.com。请确认 status 报告 Connected。命令执行完成或出现 HTTP 重定向本身,不能证明设备已注册或连接。

注册和状态命令可验证设备注册及其与 Cloudflare 的连接。要验证端到端流量,请使用计划采用的协议连接到已纳入路由的目标。对于 Cloudflare Mesh,请按照验证连接操作。

如果客户端报告 Registration Missing due to: Does not exist in API,或 warp-svc 日志显示 HTTP 400 注册响应,说明注册失败。请确认服务令牌策略使用 Service Auth 操作、策略已附加到设备注册权限,并且 MDM 团队名称和令牌值正确。修正或确认配置后,重启服务并重新运行两条验证命令:

sudo systemctl restart warp-svc
sudo warp-cli --accept-tos registration show
sudo warp-cli --accept-tos status

这篇文档对您有帮助吗?