
📌 背景说明
Cloudflare 提供的 WARP 服务,默认用于客户端加速网络。但在 VPS 上直接运行 WARP-CLI,会接管 VPS 全部流量,导致 VPS 失联。
为避免此问题,本教程指导你在 Linux VPS 上以 Proxy 模式 运行 WARP-CLI,使其仅在本地创建一个 Socks5 代理端口,你可以将需要的应用流量通过该端口走 WARP 网络。
最终效果:
- VPS 本身网络不受影响(不会失联)
- 你可以通过本地 Socks5 代理访问 WARP 网络
- IPv6 Only VPS 也能通过 WARP 获取 IPv4 出口(可选扩展)
🛠 环境准备
- 操作系统:Ubuntu/Debian(其他系统命令可能不同)
- 权限:具备
sudo
- 网络:VPS 能访问 Cloudflare 软件仓库
🚀 安装 WARP-CLI
步骤 1:更新软件源
⚠️ 如果提示 sudo: command not found
,请先安装 sudo
:
步骤 2:安装 gnupg(必需)
WARP 软件仓库启用了 GPG 数字签名,系统需要 gnupg
校验签名。
1
| sudo apt install gnupg -y
|
步骤 3:导入 Cloudflare GPG 公钥
1
2
3
| curl https://pkg.cloudflareclient.com/pubkey.gpg \
| sudo gpg --yes --dearmor \
--output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
|
步骤 4:添加 Cloudflare 软件仓库
1
2
| 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
|
说明:
$(lsb_release -cs)
会自动获取当前系统代号,如 focal
、jammy
、bullseye
等。
步骤 5:再次更新软件源
步骤 6:安装 WARP-CLI
1
| sudo apt install cloudflare-warp -y
|
安装完成后,warp-cli
命令即可使用。
⚙️ 配置与运行 WARP-CLI
步骤 1:注册 WARP 免费账户
1
| warp-cli registration new
|
首次运行会提示是否同意用户协议,输入:
y
并回车确认。
步骤 2:设置为 Proxy 模式
默认模式会接管全局流量,风险是 VPS 可能失联。
必须切换到代理模式:
步骤 3:设置 Socks5 代理端口
例如设置为 30000
:
1
| warp-cli proxy port 30000
|
说明:
代理仅监听本地 127.0.0.1:30000
之后需要通过此端口访问 WARP 网络
步骤 4:(可选)切换协议为 MASQUE
WARP 默认使用 WireGuard 协议,你可以切换到 MASQUE 协议:
1
| warp-cli tunnel protocol set MASQUE
|
查看是否切换成功:
1
| warp-cli settings | grep protocol
|
步骤 5:连接 WARP
如果成功,会输出:
Success
🔍 验证 WARP 代理是否正常工作
使用 curl 通过 Socks5 代理访问:
1
| curl ifconfig.me --proxy socks5://127.0.0.1:30000
|
📊 (可选)检测 WARP 分配的 IP 质量
你可以使用第三方脚本检测 IP 可用性:
1
| bash <(curl -Ls IP.Check.Place) -x socks5://127.0.0.1:30000
|
说明:
该脚本由社区维护,可能会失效或地址变更
输出结果主要用于参考(例如判断能否解锁某些服务)
🌐 (可选)为 IPv6 Only VPS 添加 WARP IPv4 出口
通过 onekey-tun2socks
工具,可以让 IPv6 Only VPS 拥有 IPv4 出口。
步骤 1:下载脚本并赋予权限
1
2
3
| curl -L https://raw.githubusercontent.com/hkfires/onekey-tun2socks/main/onekey-tun2socks.sh -o onekey-tun2socks.sh
chmod +x onekey-tun2socks.sh
sudo ./onekey-tun2socks.sh -i custom
|
⚠️ 如果 VPS 无法访问 GitHub,请使用代理或反代替换下载链接。
步骤 2:输入脚本参数
运行脚本后按提示输入:
- Socks5 服务器地址
127.0.0.1
- Socks5 服务器端口(需与 warp-cli 设置一致,如 30000)
30000
用户名
直接回车(留空)
密码
直接回车(留空)
步骤 3:等待脚本自动配置
✅ 总结
warp-cli
默认接管全局流量,务必使用 Proxy 模式 避免 VPS 失联
完成配置后,可以通过本地 Socks5 代理访问 WARP 网络
若 VPS 仅支持 IPv6,可结合 onekey-tun2socks
提供 IPv4 出口
IP 检测脚本等可选步骤仅供参考,非必需
速查表
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
| ## ⚡️ WARP-CLI 命令速查表 (Cheat Sheet)
### 📥 安装
```bash
# 更新系统
sudo apt update
# 安装 sudo(如缺失)
apt install sudo -y
# 安装 gnupg
sudo apt install gnupg -y
# 导入 Cloudflare GPG 公钥
curl https://pkg.cloudflareclient.com/pubkey.gpg \
| sudo gpg --yes --dearmor \
--output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
# 添加 Cloudflare 软件仓库
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
# 更新并安装 WARP-CLI
sudo apt update
sudo apt install cloudflare-warp -y
|
⚙️ 配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| # 注册 WARP 账户
warp-cli registration new
# 设置 Proxy 模式(避免全局流量接管)
warp-cli mode proxy
# 指定 Socks5 代理端口(示例:30000)
warp-cli proxy port 30000
# (可选)切换到 MASQUE 协议
warp-cli tunnel protocol set MASQUE
# 查看当前协议
warp-cli settings | grep protocol
# 连接 WARP
warp-cli connect
|
🔍 验证
1
2
3
4
5
| # 通过代理查看 WARP IP
curl ifconfig.me --proxy socks5://127.0.0.1:30000
# (可选)测试 WARP IP 质量
bash <(curl -Ls IP.Check.Place) -x socks5://127.0.0.1:30000
|
🌐 IPv6 Only VPS → 启用 IPv4 出口
1
2
3
4
| # 下载并运行 onekey-tun2socks 脚本
curl -L https://raw.githubusercontent.com/hkfires/onekey-tun2socks/main/onekey-tun2socks.sh -o onekey-tun2socks.sh
chmod +x onekey-tun2socks.sh
sudo ./onekey-tun2socks.sh -i custom
|
参数输入:
Socks5 地址: 127.0.0.1
Socks5 端口: 30000
用户名: (直接回车留空)
密码: (直接回车留空)
特别鸣谢:本文章灵感来自https://www.nodeseek.com/post-429175-1