vernette/warpscout

项目介绍

Cloudflare WARP 有大量端点地址，连到哪个地址决定了隧道落在哪个 Cloudflare 边缘节点，而这会影响是否被 DPI 过滤。官方客户端不提供选节点能力，WARPSCOUT 遍历端点地址，报告每个端点的出口地区（SEEN AS）和边缘节点（NODE），并能针对最优端点写出配置。

它以单文件二进制运行，不需要管理员权限和 TUN 设备，覆盖 Windows、Linux、macOS、Android/Termux、路由器固件和 Docker，扫描时显示实时表格，同时在磁盘生成报告文件。扫描协议包括 wg（WireGuard）、awg（AmneziaWG）、masque 和 masque-h2。

快速使用

Windows 用户从发布页下载 windows_amd64.zip，解压后在所在目录打开终端，先确认程序可运行：

.\warpscout.exe version

Linux、macOS、OpenWrt 和 Termux 可以用提供的安装脚本，它会把二进制放进各平台对应的目录：

curl -fsSL https://raw.githubusercontent.com/vernette/warpscout/master/install.sh | sh

也可以使用 Go 1.25 或更高版本：go install github.com/vernette/warpscout@latest。

接着执行一次注册，会在二进制旁边生成 warpscout-account.json，没有该文件扫描无法开始：

.\warpscout.exe register

使用 AmneziaWG 并开启隧道内延迟和丢包测量进行扫描：

.\warpscout.exe scan -p awg -P

挑出节点不是 DME、LOSS 为 0% 且延迟较低的行，或让工具选择最优端点并直接生成配置：

.\warpscout.exe scan -p awg -P -exclude-node DME -conf warp.conf

把生成的 .conf 导入 AmneziaWG 客户端。使用 -p wg 时得到的是普通 WireGuard 配置。macOS 首次运行下载的二进制会被拦截，需要执行 xattr -d com.apple.quarantine warpscout 清除隔离标记。

使用约束

• 任何扫描前都需要 WARP 账户文件，注册是独立的第一步。
• -P 会增加隧道内延迟与丢包测量，耗时更长，但这是识别「连上后中途被切断」（torn down）端点的唯一方式。
• 在过滤网络上 -p wg 可能什么都找不到，文档建议直接从 -p awg 开始。
• -speed 列会执行下载测速，明显拖慢扫描。
• Android 用户被引导到独立的 APK 项目；AUR 包由仓库外的人维护。
• 项目使用 MIT 许可证。README 说明若干协议实现来自第三方项目。

HotRepo 点评

在 2026-11-13 的 Go 日榜记录中，项目新增 12 Star，在该语言榜排第 12，总 Star 为 643。这只是单日快照，只能说明当天位置，不足以判断趋势。README 把选节点的必要性建立在特定 Cloudflare 节点存在 DPI 过滤这一具体问题上，与工具「扫描—报告—出配置」的设计相符；榜单记录本身信息有限，无法补充更多观察。