如果您计划指引您的用户手动下载并配置 Cloudflare One Client(前称 WARP),用户需要将客户端连接到您组织的 Cloudflare Zero Trust 实例。
- 完成 Zero Trust 组织设置,包括激活订阅。
- 设置设备注册权限以指定哪些用户可以进行连接。
要使用客户端 GUI 注册您的设备:
-
下载并安装 Cloudflare One 客户端。
-
启动 Cloudflare One 客户端。
-
在 What would you like to use the Cloudflare One Client for?(您想将 Cloudflare One Client 用于什么?) 屏幕上,选择 Zero Trust security(Zero Trust 安全)。
输入您的团队名称。
-
完成您组织要求的身份验证步骤。
验证通过后,您将看到一个 Success 页面和一个提示您打开 Cloudflare One 客户端的对话框。
-
选择 Open the Cloudflare One Client(打开 Cloudflare One Client) 以完成注册。
-
下载并安装 Cloudflare One 客户端。
-
启动 Cloudflare One 客户端。
-
选择菜单栏中的 Cloudflare 徽标。
-
选择齿轮图标。
-
转到 Preferences(偏好设置) > Account(账户)。
-
选择 Login with Cloudflare Zero Trust(使用 Cloudflare Zero Trust 登录)。
输入您的团队名称。
-
完成您组织要求的身份验证步骤。
验证通过后,您将看到一个 Success 页面和一个提示您打开 Cloudflare One 客户端的对话框。
-
选择 Open Cloudflare WARP.app(打开 Cloudflare WARP.app) 以完成注册。
设备现在受到您组织的 Zero Trust 策略的保护。
要使用终端注册您的设备:
-
下载 ↗并安装 Cloudflare One Client 软件包。
-
打开终端窗口。确保您是以当前用户身份而不是 root 身份登录终端。
(可选)验证组织的 团队名称:
curl --fail --silent --show-error \ "https://<YOUR_TEAM_NAME>.cloudflareaccess.com/cdn-cgi/access/certs" \ > /dev/nullInvoke-WebRequest -UseBasicParsing "https://<YOUR_TEAM_NAME>.cloudflareaccess.com/cdn-cgi/access/certs" | Out-Null请求成功说明团队域名存在且可访问,但不能证明设备有资格注册。请将该值与你的 Zero Trust 设置中的团队名称进行比较。
-
使用团队名称将设备注册到 Cloudflare Zero Trust:
warp-cli registration new <your-team-name> -
在打开的浏览器窗口中,完成您组织要求的身份验证步骤。
身份验证成功后,您将看到一个成功页面,并有一个对话框提示您打开链接。
-
选择 Open Link(打开链接)。
-
在终端中验证注册:
warp-cli registration show排查丢失注册的问题
warp-cli registration new的成功消息并不表示组织注册已完成。如果浏览器报告注册请求无效,而 CLI 报告成功,应将注册视为失败。请在浏览器开发者工具中检查注册端点的 HTTP 响应。你也可以使用warp-diag收集诊断日志。不要把直接打开
https://<YOUR_TEAM_NAME>.cloudflareaccess.com/warp作为备用方法。该 URL 不包含当前的注册会话。如果注册记录仍未出现,请手动从浏览器复制身份验证令牌到 Cloudflare One Client:-
在成功页面上,右键单击并选择 View page source(查看网页源代码)。
-
找到包含令牌的 HTML 元数据标签。例如:
<meta http-equiv="refresh" content"=0;url=com.cloudflare.warp://<your-team-name>.cloudflareaccess.com/auth?token=yeooilknmasdlfnlnsadfojDSFJndf_kjnasdf..." /> -
复制 URL 字段:
com.cloudflare.warp://<your-team-name>.cloudflareaccess.com/auth?token=<your-token> -
在终端中,运行以下命令,使用上一步中获取的 URL。
warp-cli registration token "com.cloudflare.warp://<your-team-name>.cloudflareaccess.com/auth?token=<your-token>"
如果您收到
401错误,说明令牌已过期。通过刷新网页生成一个新令牌,并快速从页面源代码中获取新令牌。 -
-
如果您未将客户端配置为自动连接,请手动连接:
warp-cli connect -
如果设备配置文件通过 WARP 路由
www.cloudflare.com,请验证数据路径:curl --silent https://www.cloudflare.com/cdn-cgi/trace | grep '^warp=on$'if (-not (curl.exe --silent https://www.cloudflare.com/cdn-cgi/trace | Select-String '^warp=on$')) { exit 1 }在 Include 模式下,不在包含列表中的目标应显示
warp=off。请改为测试列表中的目标。在仅 DNS 模式下,使用步骤 7 的注册输出验证注册状态。仅 DNS 模式无法承载网络流量。
设备现在受到您组织的 Zero Trust 策略的保护。有关所有可用命令的更多信息,请运行 warp-cli --help。
- 下载并安装 Cloudflare One Agent 应用程序。
- 启动 Cloudflare One Agent 应用程序。
- 选择 Next(下一步)。
- 查看隐私政策并选择 Accept(接受)。
- 输入您的团队名称。
- 完成您组织要求的身份验证步骤。
- 身份验证后,选择 Install VPN Profile(安装 VPN 配置文件)。
- 在 Connection request(连接请求) 弹窗中,选择 OK(确定)。
- 如果您没有启用自动连接,请手动将开关切换为 Connected(已连接)。
设备现在受到您组织的 Zero Trust 策略的保护。
功能可用性
| 系统 | 可用性 | 最低客户端版本 |
|---|---|---|
| Windows | ❌ | |
| macOS | ❌ | |
| Linux | ❌ | |
| iOS | ✅ | 1.10 |
| Android | ✅ | 2.4 |
| ChromeOS | ✅ | 2.4 |
管理员可以向用户提供自定义登录 URL,该 URL 在设备注册期间会自动填充您组织的团队名称(team name)。使用 URL 可以减少手动输入团队名称时出错的可能性。
Cloudflare One Client 支持通过直接链接访问的 URL,或者包含 URL 处理程序(如二维码)的 URL。直接链接目前仅在 Safari 和 Firefox 中受支持。如果您的默认浏览器是 Chrome(或其他不支持的浏览器),我们建议将链接嵌入二维码中。
要生成用于设备注册的 URL:
复制以下链接,将
<your-team-name>替换为您的 Zero Trust 团队名称(team name):cf1app://oneapp.cloudflare.com/team?name=<your-team-name>-
(可选)使用任何二维码生成器将链接嵌入二维码中。
-
将链接或二维码分发给用户。
要使用登录 URL 注册设备:
-
下载并安装 Cloudflare One Agent 应用程序。
-
打开账户管理员提供的登录 URL。要使用二维码,请在设备上打开二维码扫描应用并扫描二维码。
Cloudflare One Agent 应用程序将打开并启动引导流程。
-
要完成引导流程:
a. 阅读隐私政策并选择 Accept(接受)。
b. 在 Enter team name 页面上,确认预填的 团队名称与你的组织匹配。
c. 完成您组织要求的身份验证步骤。
d. 身份验证后,选择 Install VPN Profile(安装 VPN 配置文件)。
e. 在 Connection request 弹出窗口中,选择 OK。
-
如果您未启用自动连接,请手动将开关切换为 Connected(已连接)。
设备现在受到您组织的 Zero Trust 策略的保护。
默认情况下,虚拟机 (VM) 受主机的设备客户端设置影响。如果您想在虚拟机中部署 Cloudflare One Client 的单独实例,必须将虚拟机配置为在桥接网络模式下运行。