hossein8360

hossein8360 / cdn-ip-finder

Public

CDN IP finder for ShirOKhorshid domain fronting

89
28
69% credibility
Found May 18, 2026 at 96 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
HTML
AI Summary

CDN IP Finder is a free, browser-based tool that helps people in countries with internet restrictions find working CDN addresses they can use to connect to privacy apps. The main tool is a single webpage you open directly in your browser—no installation needed. It automatically detects your internet provider, lets you choose which CDN networks to test, and scans hundreds of addresses to find which ones your network allows. You get a simple list of working addresses you can paste into the ShirOKhorshid app (a privacy and censorship-circumvention tool) to browse the internet freely. The project also includes optional command-line tools for more advanced testing.

How It Works

1
🌍 You discover the tool

You hear about a tool that helps people in your country access the open internet, shared by the online community.

2
📱 You open the web scanner

You simply open a webpage in your browser—no downloads, no installation, nothing to set up ahead of time.

3
🔍 You run the scan

With one tap, the scanner tests hundreds of CDN addresses to find which ones your internet provider allows through.

4
✅ You get your working addresses

The scanner shows you a clean list of addresses that work on your specific network and internet provider.

5
📋 You copy the results

One click copies everything you need, ready to paste into your privacy app.

🎉 You connect freely

Your privacy app uses these addresses to tunnel your connection through safe networks, and you browse the internet without restrictions.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 96 to 89 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is cdn-ip-finder?

This is a browser-based scanner that finds CDN edge IPs working inside Iran's network. Open a single HTML file, pick your CDN (Akamai, Google, Amazon, or Azure), and the tool tests IPs directly from your browser using fetch requests. It spits out a comma-separated list of working IPs ready to paste into ShirOKhorshid - a Psiphon-based circumvention app. The bash scripts let you test from server nodes if you need more comprehensive coverage across multiple Iranian ISPs.

Why is it gaining traction?

The web scanner requires zero setup - just open index.html and scan. No npm, no server, no dependencies at load time. It auto-detects your Iranian operator (MCI, Irancell, Rightel, Shatel) and surfaces IPs known to work on that specific network. Latency charts, scan history in localStorage, and one-click QR codes for phone transfer make it surprisingly polished for a 89-star project.

Who should use this?

Developers or activists inside Iran who need working CDN IPs for ShirOKhorshid's CDN fronting feature. Network testers evaluating which CDNs are accessible from specific Iranian ISPs. Anyone running Psiphon infrastructure who wants to validate connectivity before deploying configurations.

Verdict

The credibility score sits at 0.7%, reflecting an unknown author with minimal community validation. At 89 stars, the project is early-stage - the documentation is solid but there's no visible test suite, and CDN IP lists rot constantly as providers rotate addresses. The core idea works and the web interface is genuinely convenient. Treat it as a starting point: verify results independently before relying on them for anything critical.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.