explaingit

hossein8360/cdn-ip-finder

126HTML

TLDR

This project is a set of tools that look for content delivery network edge servers whose IP addresses are still reachable from inside Iran.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

In plain English

This project is a set of tools that look for content delivery network edge servers whose IP addresses are still reachable from inside Iran. The intended user is someone running ShirOKhorshid, a community fork of the Psiphon Android app, which has a feature called CDN Fronting that needs a list of working IPs for major CDN providers. The README covers Akamai, Google CDN, Amazon CloudFront, and Microsoft Azure CDN. The main piece is index.html, a single-file web app that runs entirely in the browser with no server, no install, and no dependencies fetched at load time. The user opens it from GitHub Pages or as a local file. It then sends fetch requests in no-cors mode to each candidate IP and times how long they take, treating a fast TCP response as reachable and a timeout as blocked. Even a TLS or CORS error counts as reachable because it means the IP responded. The page tries to detect which Iranian operator the user is on through ipapi.co and offers preset IP lists per operator. Features listed include scan presets of 50, 250, or 1000 IPs, picking which CDN to test, selecting an SNI hostname from a per-CDN list, adding extra ranges as CIDR blocks, a dashboard tab with a latency chart powered by Chart.js loaded only when opened, a scan history kept in browser localStorage, a stability score that runs each IP multiple times, copy-to-clipboard formatted for ShirOKhorshid, QR code transfer to a phone, and TXT or CSV export. For users who prefer server-side testing, the scripts folder has three bash scripts. One does a quick local Akamai test, one checks Akamai IPs through Iranian network nodes via the check-host.net API, and the third does the same broader sweep for all four CDNs. The README then explains how to paste the resulting list into ShirOKhorshid settings. License is GPL-3.0.

Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.