先确认系统和可恢复的操作环境
适用于本人管理、可在本机控制台恢复网络的 Linux 设备。路由变化可能中断 SSH;不要在只有远程会话、没有其他恢复入口的主机上直接照做。组织 Cloudflare One 注册和 Mesh 节点属于其他流程。
- 对照官方系统要求与软件源页面,确认发行版、版本、架构及目标包可用。看到旧构建文件不等于当前系统受支持。
- 记录现有 VPN、DNS 和代理状态,准备本地恢复入口。先完成安装和帮助命令检查,再执行会改变连接的命令。
按发行版接入官方软件源
| 检查项 | 处理方式 |
|---|---|
| APT 系统 | 按官方软件源页配置签名密钥和对应发行版源,再安装 cloudflare-warp |
| RPM 系统 | 按官方对应发行版步骤配置源与依赖,再安装 cloudflare-warp |
| 签名校验失败 | 核对官方密钥更新说明,不关闭校验 |
| 没有对应包 | 记录当前系统未完成安装,不强装其他发行版包 |
文末软件源页区分当前支持版本与旧构建,并说明旧密钥需要更新。采用该页与你的发行版对应的当前步骤;不要复制过时镜像命令、关闭签名检查,或使用未知来源的一键脚本。
warp-cli --help
warp-cli mode --help只在首次使用时新建个人注册
以下注册命令用于尚未完成个人版注册的设备。已有注册、组织配置或命令报错时,先确认当前状态和用途,不把删除注册当成常规修复。按命令提示阅读并确认相关条款。
warp-cli registration new明确模式后再连接
需要验证流量和 DNS 时,官方 Linux 指引使用 warp+doh;只处理 DNS 则是 doh。以下示例选择前者,不要把两种模式的结果混在一起。不同版本支持项以本机 mode 帮助为准。
warp-cli mode warp+doh
warp-cli connect验证请求,再验证实际使用路径
curl https://www.cloudflare.com/cdn-cgi/trace- 检查返回内容中的 warp=on。请求失败或没有取得输出时,记录本次未完成验证;不要只凭 connect 命令退出码判断已经可用。
- 这个结果只覆盖当前终端的这一次请求;如该终端设置了代理,也要记录。继续复测原本要使用的浏览器或应用,确认实际功能。
- 需要断开时,使用 warp-cli --help 中列出的 disconnect 子命令,并核对返回状态和原应用访问;测试后恢复原有网络设置。不要通过删除注册来代替断开。
失败时先取证,保留诊断文件
- 记录客户端版本、模式、完整错误与时间。软件包未装好、注册失败、连接失败和连接后应用失败分别处理,不反复新建注册。
- 官方 Linux 文档提供 sudo warp-diag 来收集本地诊断,输出 warp-debugging-info.zip 到当前目录。确需诊断时再运行,先检查其中个人信息和网络配置。
- 带 feedback 的诊断命令会提交支持请求;本篇不要求自动发送。仅在确认内容和接收渠道后按官方支持要求提交。