vernette /warpscout

🛰️ Cloudflare WARP endpoint scanner - find working endpoints over wg/awg/masque and see the exit region and edge node they land on

★ 660⑂ 61👁 11⑃ 6● 22▤ 24
GoMITCreated 2026-07-21
下载:v0.16.1v0.16.1 ↓0.16.12026-10-24
+5
日增长
660
stars
61
forks
11
watchers
6
prs
22
issues
24
releases

README

WARPSCOUT

!WARPSCOUT multi-node

Find Cloudflare WARP endpoints that work from your network, and see where they exit.


  
  
  
  
  
  


Documentation: 🇬🇧 English · 🇷🇺 Русский

 Contents

- What it is
- Installation
- Quick start
- Reading the table
- If nothing works
- Commands
- Useful flags
- Going further
- Credits
- Support the author

 What it is

Cloudflare WARP has thousands of endpoint addresses, and the one you connect to decides which Cloudflare edge node (colo) your tunnel lands on. That matters: since April 2026 traffic through the Moscow node DME is filtered by DPI, and some sites simply do not open through it even though WARP itself connects fine. The same config pointed at an endpoint on a foreign node works without that problem.

The official WARP client gives you no way to pick the node. WARPSCOUT walks the endpoint addresses, shows the node and exit region for each one, and writes a ready-to-import config for the best of them.

- A single file, nothing to install
- No admin rights and no TUN device
- Windows, Linux, macOS, Android and Docker
- A live table while scanning, plus a report file on disk

 Installation

 Windows

1. Open the releases page and download warpscout_..._windows_amd64.zip.
2. Unpack it anywhere, for example into C:\warpscout.
3. Open that folder, hold Shift and right-click empty space → Open PowerShell window here (on Windows 11 - Open in Terminal).
4. Check that it runs:

powershell
.\warpscout.exe version


Every command below goes into that same window.

 [!NOTE]
 If Windows complains about the downloaded file, right-click warpscout.exe → Properties → tick Unblock at the bottom

 Android

The easiest way is the ready-made app openwarpkit/warpscout-android by OpenWarpKit. Grab the APK for your architecture from its releases page.

In Termux the one-line install below works as it does on Linux.

 Linux, macOS, OpenWrt, Termux

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


If there is no curl (OpenWrt routers, for one):

sh
wget -qO- https://raw.githubusercontent.com/vernette/warpscout/master/install.sh | sh


The script picks the right archive for your system and puts warpscout into ~/.local/bin, on OpenWrt into /usr/bin, in Termux into $PREFIX/bin. Run it again to update.

 [!NOTE]
 macOS only. The first run is blocked because the file came from the internet. Clear the flag once: xattr -d com.apple.quarantine warpscout

 Other ways

Arch Linux (AUR, packaged by Nebulosa, not maintained by this repository):

sh
paru -S warpscout       build from source
paru -S warpscout-bin   prebuilt release binary


Docker - see running in Docker.

From source, Go 1.25 or newer:

sh
go install github.com/vernette/warpscout@latest


Installer options go after sh -s --, and INSTALL_DIR picks another directory:

sh
INSTALL_DIR=/usr/local/bin sh -c "$(curl -fsSL https://raw.githubusercontent.com/vernette/warpscout/master/install.sh)"

curl -fsSL https://raw.githubuser

Top issues

Latest release

v0.16.1 v0.16.1 2026-10-24
Fixed an error in register. Thanks to @eleutherifer for the fix.

 Commits

- fix: register through another API host (3ab7525)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON