本文分两部分:管理员先配后台,成员再装客户端。按序号做,每步都给了验证方法,做错能立刻发现。
第一部分:管理员后台配置(一次性)
入口:浏览器打开 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 安装
- 右键安装包 → 以管理员身份运行
- 保持默认选项,一路下一步
- 安装完成,先不要点界面上的任何按钮
安装包存一份到非临时目录,浏览器下载缓存目录会被自动清理。
2.3 进入团队登录
- 打开 Cloudflare One Client(旧版图标名为 Cloudflare WARP)
- 首屏两张卡片:
- 「私密浏览」:个人 1.1.1.1 模式,不加入任何组织,团队用户不要选
- 「Cloudflare One Client」/「Zero Trust 安全」:点击「继续」
- 填写团队名(第 1.1 步复制的那个)
旧版界面入口(2026.1 及更早):左上角 Cloudflare 图标 → 齿轮 → 首选项 → 账户 → 使用 Cloudflare Zero Trust 登录
2.4 完成浏览器认证
客户端唤起浏览器,走组织要求的认证流程。邮箱验证码的走法:
- 输入邮箱 → Send login code
- 查收验证码,填回
Code框 → Verify - 看到 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 手动回传注册令牌(浏览器成功、客户端失败时用)
- 在认证成功的 Success 页面,右键 → 查看网页源代码
- 找到含 token 的 meta 标签,形如:
com.cloudflare.warp://<团队域>/auth?token=... - 复制整个 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 # 查看当前版本可用子命令
三条禁忌:
registration new输出的网址不要手动复制到浏览器,它不含活跃会话- 部分版本没有
reset子命令,执行前先--help确认 - 不要强制结束
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 步的设定