本文分两部分:管理员先配后台,成员再装客户端。按序号做,每步都给了验证方法,做错能立刻发现。


第一部分:管理员后台配置(一次性)

入口:浏览器打开 dash.cloudflare.com 登录 → 左侧 Zero Trust。国内可直连,不需要代理。

1.1 确认团队名

路径:Zero Trust → 设置(Settings)

页面上的「团队域」形如 xxxx.cloudflareaccess.com,其中 xxxx 就是团队名,成员客户端要填的就是这一段。

团队名由数字和字母混合组成,容易看错(数字 1 与字母 l、t)。复制粘贴给成员,不要口头传达。

验证:本页能看见团队域,即确认无误。

1.2 开启邮箱验证码登录(OTP)

新建的 Zero Trust 组织默认只有「Cloudflare 身份」一种登录方式,邮箱验证码需要手动添加。

路径:Zero Trust → 集成(Integrations)→ 身份提供者(Identity providers)→ 添加新身份提供者 → One-time PIN(一次性 PIN)→ 保存

我此前给过 one/settings/authentication/login-methods 这个路径,是错的,后台没有该页面。以本条为准。

验证:保存后,「你的身份提供者」列表里出现 One-time PIN 一项。

邮件网关放行(企业邮箱必做):若成员用的是公司邮箱,需让邮件网关放行验证码发件方,否则验证码会被拦截或扫描消费掉:

项目 值
发件域 notify.cloudflare.com
发件地址 noreply@notify.cloudflare.com
IP 104.30.16.2 ~ 104.30.16.7

1.3 配置设备注册权限(决定谁能接入)

路径:Zero Trust → 团队和资源 → 设备 → 设备配置文件 → 管理(Management)→ 设备注册权限 → 管理 → 策略(Policies)标签页

新建一条 Access 策略,示例:

字段 值
规则类型 包含(Include)
选择器 邮箱后缀(Emails ending in)
值 @你的公司域名.com
动作 允许(Allow)

验证:用不在允许列表内的邮箱试登录,应被拒绝;用列表内的邮箱,应收到验证码。

同一页的「登录方式」标签页可限制只用某个身份提供者。刚起步时留默认即可。

1.4 防止成员误退出组织

在同一个设备管理页,关闭 允许设备离开组织(Allow devices to leave organization)。

否则成员在客户端点一下就能脱离组织管理。

1.5 拆分隧道(建议配置,影响日常体验)

路径:Zero Trust → 设置 → WARP 客户端 → 设备设置 → 找到目标配置文件 → 配置 → 拆分隧道(Split Tunnels)

模式 行为 适用
排除模式(默认) 除指定地址外,全部流量进隧道 需要统一上网管控
包含模式 只有指定地址进隧道,其余直连 只访问内网资源、不想影响上网速度

包含模式的推荐填法:

类型 值 说明
IP 段 100.96.0.0/12 WARP 设备虚拟 IP 段,用于设备间互访

⚠️ 优先级坑(最容易踩):配置文件从上到下匹配,越靠上优先级越高。自定义配置文件若排在「默认」下方,实际生效的仍是默认配置,改了等于没改。

验证(Windows 客户端上):

route print -4 | findstr 100.96

能看到 100.96.0.0/12 且接口为 CloudflareWARP,即生效。

1.6 后台配置检查清单

  • [ ] 团队名已确认并复制备用
  • [ ] One-time PIN 已出现在身份提供者列表
  • [ ] 注册策略已允许目标邮箱
  • [ ] 已关闭「允许设备离开组织」
  • [ ] 拆分隧道模式已选定,自定义配置文件优先级高于「默认」

第二部分:成员端安装与接入

2.1 下载客户端

渠道 地址
官方统一下载页(推荐,自动识别系统) https://one.cloudflare.com/install
各版本历史下载页(官方,含全部稳定版与更新说明) https://docs.cloudflare.com/cloudflare-one/team-and-resources/devices/warp/download-warp/

历史版本页列出了每个版本的发布日期、体积和更新说明,需要固定版本或排查版本问题时用它。

只从上述官方地址下载,不要用第三方下载站的安装包。

验证:安装包为 .msi,属性中的数字签名颁发给 Cloudflare, Inc.。

2.2 安装

  1. 右键安装包 → 以管理员身份运行
  2. 保持默认选项,一路下一步
  3. 安装完成,先不要点界面上的任何按钮

安装包存一份到非临时目录,浏览器下载缓存目录会被自动清理。

2.3 进入团队登录

  1. 打开 Cloudflare One Client(旧版图标名为 Cloudflare WARP)
  2. 首屏两张卡片:
    • 「私密浏览」:个人 1.1.1.1 模式,不加入任何组织,团队用户不要选
    • 「Cloudflare One Client」/「Zero Trust 安全」:点击「继续」
  3. 填写团队名(第 1.1 步复制的那个)

旧版界面入口(2026.1 及更早):左上角 Cloudflare 图标 → 齿轮 → 首选项 → 账户 → 使用 Cloudflare Zero Trust 登录

2.4 完成浏览器认证

客户端唤起浏览器,走组织要求的认证流程。邮箱验证码的走法:

  1. 输入邮箱 → Send login code
  2. 查收验证码,填回 Code 框 → Verify
  3. 看到 Success 页面后,点击 打开 Cloudflare One Client 完成注册

验证码的两个坑:

现象 原因与处理
提示 This One-Time PIN has already been used 邮件安全软件预先扫描并消费了链接。点 Request new code 重取,并让管理员做第 1.2 步的网关放行
提示 That account does not have access 邮箱不在注册策略允许范围内,找管理员加白

验证码 10 分钟过期,每次请求会使上一枚失效,不要连点。

2.5 验证接入成功

客户端:主开关变蓝,显示「已连接」。

后台:Zero Trust → 团队和资源 → 设备 → 设备,列表中出现该设备。

命令行(可选):

warp-cli registration show

能显示注册信息即成功。


第三部分:故障排查表

症状 原因 处理
浏览器提示「资源解析服务请求失败」 手动访问了 <团队名>.cloudflareaccess.com/warp。该地址不含活跃的注册会话,手输必失败 关掉页面,回客户端重新点登录。任何情况下都不要手输这个地址作为 fallback
状态显示 Registration Missing 本地注册凭据损坏(常见于强杀服务进程后) 卸载客户端 → 重启系统 → 重装
浏览器认证成功但客户端仍提示注册无效 注册未完成,CLI 报成功也不代表入库 手动回传令牌,见下方 3.1
where warp-cli 有输出,但执行提示「不是内部或外部命令」 卸载后残留无扩展名的旧文件 删除 C:\Windows\System32\warp-cli
收不到验证码 邮箱服务国内不可直连,或被网关拦截 换国内可达邮箱,或让管理员放行发件方
登录页持续转圈、不唤起浏览器 系统默认浏览器未设置 设置 → 应用 → 默认应用 → 将 http/https 指定为 Edge 或 Chrome
全部流量被代理、上网变慢 拆分隧道未生效或配置文件优先级不对 检查第 1.5 步的配置文件顺序
DNS 中出现 2606:4700::1111 且不可达 路由器或 DHCP 下发的 IPv6 DNS 网卡 DNS 手动指定 223.5.5.5 / 119.29.29.29;此项不影响登录

3.1 手动回传注册令牌(浏览器成功、客户端失败时用)

  1. 在认证成功的 Success 页面,右键 → 查看网页源代码
  2. 找到含 token 的 meta 标签,形如: com.cloudflare.warp://<团队域>/auth?token=...
  3. 复制整个 URL 字段,执行:
warp-cli registration token "com.cloudflare.warp://<团队域>/auth?token=..."

第四部分:命令行速查

图形界面能做的,优先用图形界面。 以下命令用于查看状态和排障:

warp-cli status               # 查看连接状态
warp-cli registration show    # 查看注册信息
warp-cli registration new     # 重新发起注册(会唤起浏览器)
warp-cli connect              # 连接
warp-cli disconnect           # 断开
warp-cli --help               # 查看当前版本可用子命令

三条禁忌:

  1. registration new 输出的网址不要手动复制到浏览器,它不含活跃会话
  2. 部分版本没有 reset 子命令,执行前先 --help 确认
  3. 不要强制结束 warp-svc.exe,它是后台服务,强杀会损坏注册凭据;重启服务用 sc stop / sc start

验证团队域可达(不验证是否有注册资格):

Invoke-WebRequest -UseBasicParsing "https://<团队域>.cloudflareaccess.com/cdn-cgi/access/certs" | Out-Null

无报错即域名存在且可达。


第五部分:清理无效的 IPv6 DNS(可选)

netsh interface show interface
netsh interface ipv6 delete dns "以太网" 2606:4700::1111

第一条用于查实际网卡名,把 "以太网" 换成查询结果中的名称。此操作与登录无关。


附:端到端验收清单

管理员侧

  • [ ] 后台配置检查清单(第 1.6 步)全部通过
  • [ ] 用一个测试邮箱完整走通一次接入

成员侧

  • [ ] 安装包数字签名属于 Cloudflare
  • [ ] 客户端「关于」页显示的团队名与后台一致
  • [ ] 主开关变蓝
  • [ ] 后台设备列表出现该设备
  • [ ] route print -4 中拆分隧道路由符合第 1.5 步的设定