A set of tools to find, test, and export CDN edge IPs that are not blocked in Iran, for use in the CDN Fronting feature of ShirOKhorshid — a community fork of the Psiphon Android client.

Supports: Akamai · Google CDN · Amazon CloudFront · Microsoft Azure CDN

Header and CDN selector

Full scanner with IP ranges and settings

Results table with working IPs and copy bar

Dashboard — latency chart and CDN health bars

Scan history saved in browser

The most important file in this project. Open it directly in your browser inside Iran — no installation needed.

index.html is a fully serverless, single-file web application that scans CDN IPs directly from your browser. Because the test runs inside your own browser, the results are 100% accurate for your specific ISP and network — no proxy, no middleman.

Option A — GitHub Pages (recommended):

https://YOUR_USERNAME.github.io/cdn-ip-finder/

Open this URL inside Iran without VPN for accurate results.

Option B — Local file:

# Just download index.html and open it
open index.html       # Mac
xdg-open index.html   # Linux
# Or double-click the file on Windows

No server, no npm, no installation. Pure HTML + JS.

Iranian user opens index.html in browser
        ↓
Browser sends HEAD request to each CDN IP:
  fetch(`https://${ip}/`, { mode: 'no-cors' })
        ↓
Fast response (< 85% of timeout)
  → TCP connected → IP is REACHABLE on your ISP ✅
Slow / no response (≥ 85% of timeout)
  → Connection timed out → IP is BLOCKED on your ISP ❌

Even a TLS or CORS error counts as reachable — it means the IP responded.

• No external dependencies at load time — Chart.js loads lazily only when Dashboard tab is opened
• QR code generated via api.qrserver.com (free, no API key)
• History stored in browser localStorage — private, never sent anywhere
• ISP detection via ipapi.co/json/ — only used to show your operator name
• Works as a static file — can be served from GitHub Pages, any web host, or opened locally

For testing via real Iranian network nodes, run these on a Linux server outside Iran.

Resolves 20+ major Akamai-hosted domains and tests IPs from your machine.

chmod +x scripts/akamai_finder.sh
./scripts/akamai_finder.sh

• ✅ Fast (~2 minutes)
• ✅ Good for a quick initial list
• ❌ Tests from your machine, not from inside Iran

Tests Akamai IPs from real Iranian nodes via check-host.net API.

chmod +x scripts/akamai_iran_checker.sh
./scripts/akamai_iran_checker.sh

• ✅ Uses ir1, ir2, ir3, ir4 Iranian nodes (Tehran, Isfahan, Mashhad)
• ✅ More accurate for Iran
• ❌ Slower (~10–15 min)

Tests all CDNs from Iranian nodes. Most comprehensive tool.

chmod +x scripts/cdn_iran_checker.sh
./scripts/cdn_iran_checker.sh

• ✅ Tests Akamai, Google, Amazon, Azure
• ✅ First checks which CDNs are accessible in Iran
• ✅ Tests each IP from 4 Iranian nodes
• ✅ Outputs comma-separated list ready for ShirOKhorshid
• ❌ Takes 15–30 minutes

1. Run the web scanner (index.html) or a bash script
2. Copy the comma-separated IP list
3. Open ShirOKhorshid → Settings → CDN Fronting
4. Tap CDN edge IPs → paste the list
5. Tap CDN SNI hostname → enter one of:

Akamai  →  a248.e.akamai.net
Google  →  fonts.googleapis.com
Amazon  →  d1.cloudfront.net
Azure   →  ajax.aspnetcdn.com

6. Set Connection Protocol → CDN Fronting → Connect! 🎉

[User in Iran]
      ↓  connects to CDN IP (not blocked)
[CDN Edge IP]  ← firewall sees safe SNI, allows it
      ↓  CDN forwards traffic internally (Host header is encrypted)
[Psiphon Server]
      ↓
[Free Internet 🌍]

Iran's firewall cannot block Akamai or Google without also breaking thousands of Iranian banking, news, and government websites.

cdn-ip-finder/
├── index.html                    # ⭐ Web scanner — open in browser
├── scripts/
│   ├── akamai_finder.sh          # Quick Akamai IP finder
│   ├── akamai_iran_checker.sh    # Akamai tester via Iranian nodes
│   └── cdn_iran_checker.sh       # Full CDN checker ⭐
├── docs/
│   └── how-it-works.md           # Technical explanation
├── results/
│   └── .gitkeep                  # Save your results here
├── README.md
└── LICENSE

For index.html: just a browser — no installation needed.

For bash scripts:

# Ubuntu / Debian
sudo apt install curl dnsutils python3 -y

# CentOS / RHEL
sudo yum install curl bind-utils python3 -y

If you have tested IPs from inside Iran, open an Issue and share:

• Which ISP (MCI / Irancell / Rightel / Shatel / other)
• Which IPs worked
• Date of testing (IPs rotate frequently!)
• Your city (filtering can differ by region)

• ShirOKhorshid Android
• Psiphon

GPL-3.0 — same as ShirOKhorshid and Psiphon

مجموعه‌ای از ابزارها برای پیدا کردن، تست و خروجی گرفتن از آی‌پی‌های CDN که در ایران فیلتر نشده‌اند، جهت استفاده در قابلیت CDN Fronting اپلیکیشن شیروخورشید.

پشتیبانی از: Akamai · Google CDN · Amazon CloudFront · Microsoft Azure CDN

هدر و انتخاب CDN

اسکنر کامل با رنج‌های IP و تنظیمات

جدول نتایج با آی‌پی‌های زنده و کپی بار

داشبورد — نمودار تأخیر و سلامت CDN

تاریخچه اسکن‌ها در مرورگر

مهم‌ترین فایل این پروژه. مستقیماً در مرورگر خود داخل ایران باز کنید — نیازی به نصب ندارد.

index.html یک وب‌اپلیکیشن تک‌فایلی و بدون سرور است که آی‌پی‌های CDN را مستقیماً از مرورگر شما اسکن می‌کند. چون تست داخل مرورگر خود شما اجرا می‌شود، نتایج دقیقاً بر اساس اپراتور و شبکه شما است — بدون پروکسی، بدون واسطه.

روش الف — GitHub Pages (توصیه‌شده):

https://YOUR_USERNAME.github.io/cdn-ip-finder/

این لینک را از داخل ایران و بدون VPN باز کنید تا نتایج دقیق باشد.

روش ب — فایل محلی:

# فقط index.html را دانلود کنید و باز کنید
open index.html       # Mac
xdg-open index.html   # Linux
# یا روی ویندوز دابل‌کلیک کنید

بدون سرور، بدون npm، بدون نصب. فقط HTML + JS خالص.

برای تست دقیق‌تر از طریق نودهای ایرانی، این اسکریپت‌ها را روی یک سرور لینوکس خارج از ایران اجرا کنید.

chmod +x scripts/akamai_finder.sh
./scripts/akamai_finder.sh

chmod +x scripts/akamai_iran_checker.sh
./scripts/akamai_iran_checker.sh

chmod +x scripts/cdn_iran_checker.sh
./scripts/cdn_iran_checker.sh

۱. اسکنر وب یا اسکریپت bash را اجرا کنید ۲. لیست آی‌پی‌های comma-separated را کپی کنید ۳. شیروخورشید → تنظیمات → CDN Fronting ۴. روی CDN edge IPs بزنید → لیست را paste کنید ۵. روی CDN SNI hostname بزنید:

Akamai  →  a248.e.akamai.net
Google  →  fonts.googleapis.com
Amazon  →  d1.cloudfront.net
Azure   →  ajax.aspnetcdn.com

۶. Connection Protocol → CDN Fronting → وصل شوید! 🎉

cdn-ip-finder/
├── index.html                    # ⭐ اسکنر وب — در مرورگر باز کنید
├── scripts/
│   ├── akamai_finder.sh          # جستجوگر سریع Akamai
│   ├── akamai_iran_checker.sh    # تستر از نودهای ایرانی
│   └── cdn_iran_checker.sh       # چکر کامل CDN ⭐
├── docs/
│   └── how-it-works.md           # توضیح فنی
├── results/
│   └── .gitkeep
├── README.md
└── LICENSE

اگر از داخل ایران آی‌پی‌ها را تست کرده‌اید، یک Issue باز کنید:

• کدام اپراتور (همراه اول / ایرانسل / رایتل / شاتل / دیگران)
• کدام آی‌پی‌ها کار کردند
• تاریخ تست
• شهر شما

• شیروخورشید اندروید
• سایفون

GPL-3.0 — مثل شیروخورشید و سایفون