【水贴】debian cloudflare warp 官方安装指南

准备工作与注意事项

⚠️ 重要提示：在连接 WARP 之前，必须将 WARP 的运行模式切换为代理模式（Proxy Mode）。如果直接使用默认的全局模式连接，系统的默认路由会被修改，导致 SSH 远程连接直接断开，VPS 将会彻底失联！

第一步：检查并安装基础依赖包

在配置存储库之前，需要先检查系统是否已经安装了 curl、gnupg以及 lsb-release。如果未安装，则进行自动安装。这里推荐使用更现代的 apt 命令替换传统的 apt-get。

小白可以直接复制并运行以下一键脚本来完成检查与安装：

# 定义所需软件包
REQUIRED_PKGS=("curl" "gnupg" "lsb-release")
NEED_INSTALL=()

# 循环检查软件包是否已安装
for pkg in "${REQUIRED_PKGS[@]}"; do
    if ! dpkg -s "$pkg" >/dev/null 2>&1; then
        NEED_INSTALL+=("$pkg")
    fi
done

# 如果有未安装的包，则执行安装
if [ ${#NEED_INSTALL[@]} -ne 0 ]; then
    echo "发现未安装的依赖包: ${NEED_INSTALL[*]}，正在启动安装..."
    sudo apt update && sudo apt install -y "${NEED_INSTALL[@]}"
else
    echo "检查完毕：必需的依赖包（curl, gnupg, lsb-release）均已安装。"
fi

第二步：添加 Cloudflare GPG 密钥

为了确保下载包的真实性与安全性，需要将 Cloudflare 的官方 GPG 密钥添加到系统的信任密钥环中。

curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg

第三步：添加 Cloudflare 官方存储库

使用以下命令自动检测 Debian 版本，并将对应的官方源写入 APT 存储库列表中：

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

第四步：安装 Cloudflare WARP 客户端

更新本地软件包索引并正式安装 WARP 客户端：

sudo apt update && sudo apt install -y cloudflare-warp

第五步：WARP 客户端初始化与核心配置

1. 注册 WARP 账户

首次使用需要注册一个新的 WARP 客户端账户：

warp-cli registration new

2. 切换至代理模式（🔥 关键步骤，防失联）

在连接前，务必执行以下命令将 WARP 模式更改为代理模式。此时 WARP 会在本地开启一个 SOCKS5 代理端口（默认端口为 40000），而不会接管整个系统的网络流量，从而确保 SSH 连接安全。

warp-cli mode proxy

第六步：连接 WARP 与状态验证

1. 启动连接

确认已经切换到代理模式后，即可安全地启动 WARP 连接：

warp-cli connect

2. 验证连接状态

使用 curl 命令通过 WARP 的官方测试接口查看代理是否生效（这里通过本地代理端口 40000 进行测试）：

curl --socks5-hostname 127.0.0.1:40000 https://www.cloudflare.com/cdn-cgi/trace

在输出的内容中，查找并确认包含以下字段，即代表 WARP 代理已成功开启并生效：

warp=on