在 Linux VPS 上安装与配置 WARP-CLI 并通过 Socks5 代理接入 WARP 网络

2025-08-22T00:00:00Z | 4分钟阅读 | 更新于 2025-08-22T00:00:00Z

在 Linux VPS 上安装与配置 WARP-CLI 并通过 Socks5 代理接入 WARP 网络

📌 背景说明

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:更新软件源

1
sudo apt update

⚠️ 如果提示 sudo: command not found,请先安装 sudo

1
apt install sudo -y

步骤 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) 会自动获取当前系统代号,如 focaljammybullseye 等。

步骤 5:再次更新软件源

1
sudo apt update

步骤 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 可能失联
必须切换到代理模式:

1
warp-cli mode proxy

步骤 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

1
warp-cli connect

如果成功,会输出:

Success

🔍 验证 WARP 代理是否正常工作

使用 curl 通过 Socks5 代理访问:

1
curl ifconfig.me --proxy socks5://127.0.0.1:30000
  • 如果输出的是 WARP 分配的 IPv4/IPv6 地址 → 代理工作正常

  • 如果报错,请确认端口号与 warp-cli proxy port 设置一致


📊 (可选)检测 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:输入脚本参数

运行脚本后按提示输入:

  1. Socks5 服务器地址
127.0.0.1
  1. Socks5 服务器端口(需与 warp-cli 设置一致,如 30000)
30000
  1. 用户名
    直接回车(留空)

  2. 密码
    直接回车(留空)


步骤 3:等待脚本自动配置

  • 脚本会自动安装依赖、配置 TUN 虚拟网卡

  • 设置完成后,IPv6 Only VPS 将获得 WARP 提供的 IPv4 出口


✅ 总结

  • 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

© 2023 - 2025 AiEDU | Blog

关于我

Hi,这里是 AiEDU 的博客。AiEDU 是我在互联网上经常使用的名字。

我是一个热衷于开源的软件工程师,在这里我会记录一些关于技术等知识。欢迎你通过评论或者邮件与我交流。

知识共享(Creative Commons)

此网站的所有内容都遵循 CC BY-NC-SA 4.0

All contents of this website are licensed under CC BY-NC-SA 4.0.

社交链接