explaingit

matinsenpai/senpaiscanner

Analysis updated 2026-05-18

637GoAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A terminal tool that scans Cloudflare IP ranges to find fast, working endpoints for VLESS or Trojan proxy configs.

Mindmap

mindmap
  root((SenPai Scanner))
    What it does
      Finds working Cloudflare IPs
      Tests VLESS Trojan configs
    Tech stack
      Go
      xray
    Use cases
      Bypass unstable networks
      Export working IPs
      Shortlist testing
    Audience
      Proxy users
      Restricted networks
    Setup
      Prebuilt binaries
      Go install

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find Cloudflare IP addresses that give stable, low latency connections through a VLESS or Trojan proxy.

USE CASE 2

Test a batch of candidate IPs and export the ones that actually work to a text file.

USE CASE 3

Re-scan a shortlist of known IPs on multiple ports to find the best combination for a restricted network.

What is it built with?

Goxray

How does it compare?

matinsenpai/senpaiscannermeesho/bharatmlstackkubernetes/apiserver
Stars637693721
LanguageGoGoGo
Last pushed2026-07-10
MaintenanceActive
Setup difficultyeasyhardhard
Complexity2/55/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a VLESS or Trojan config URL to unlock full Phase 2 validation.

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

SenPai Scanner is a tool for finding Cloudflare IP addresses that actually work well on your network. Cloudflare operates a large global network with many IP addresses, and on some internet connections, particularly in regions where traffic is filtered or monitored, certain IPs work reliably while others are slow or blocked. This tool helps you find the good ones by testing a large batch of candidate IPs and ranking them by speed and reliability through your own proxy configuration. The tool is built around a two-phase approach. In the first phase it probes thousands of Cloudflare IP addresses in parallel, checking basic connectivity and whether each IP can establish the kind of connection your proxy uses. In the second phase it takes the best results from phase one and runs them through an actual end-to-end test using your proxy configuration, measuring real download speed and latency through the proxy path. The whole process runs through a terminal interface that you navigate with arrow keys, so there are no command-line flags to memorize. To use it, you paste a proxy configuration URL in the VLESS or Trojan format, set how many IPs to test and how many parallel workers to use, and start the scan. The results show each tested IP address, what transport type it used, measured download speed in megabits per second, latency to first byte, and whether it passed. When the scan finishes you press a key to copy the working IP addresses to your clipboard and save them to a file. The README includes practical advice for restricted networks: start with conservative settings, test multiple ports since Cloudflare's CDN ports behave differently under filtering systems, and re-run tests with a curated list after an initial scan. The tool handles network instability by retrying and by keeping a live results file that updates throughout the scan. Pre-built binaries are available for Linux, macOS, and Windows. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Explain how the two scanning phases in SenPai Scanner work and what each one checks.
Prompt 2
Walk me through installing SenPai Scanner on Linux and running my first IP scan.
Prompt 3
What settings should I use with SenPai Scanner on a slow or heavily filtered internet connection?
Prompt 4
Help me interpret the SPEED, LATENCY, and STATUS columns in the Phase 2 results table.

Frequently asked questions

What is senpaiscanner?

A terminal tool that scans Cloudflare IP ranges to find fast, working endpoints for VLESS or Trojan proxy configs.

What language is senpaiscanner written in?

Mainly Go. The stack also includes Go, xray.

What license does senpaiscanner use?

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is senpaiscanner to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is senpaiscanner for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.