SIMORGH

Project Url: rezakhosh78/SIMORGH
Introduction: #SIMORGH_VPN
More: Author   ReportBugs   OfficialWebsite   
Tags:

SIMORGH VPN is a multi-engine Android VPN client designed for normal connectivity, restricted networks, Iran national intranet conditions, international internet outages, RKh-MSP Engine, XRAY configs, Fragment mode, NipoVPN profiles, and DNS/MasterDNS routing.

⚠️ Donate

USDT BEP20:

0xeaA77532878d92b2218690605DebD192cd4f018f

This README is based on the latest provided project version:

Version Name: 1.2.1
Version Code: 1202
Application ID: com.rkh.simorgh
Minimum SDK: 29
Target SDK: 36

⚠️ Important: if there is no active network at all, no app can connect. However, when Iran's national intranet / local network / domestic routes are still available while international internet access is blocked or heavily restricted, the MSP page is designed to scan routes, find clean IPs, and provide a method for accessing websites.

✨ Quick Overview

SIMORGH has five main pages:

Page Main Purpose
🛰️ MSP RKh-MSP Engine, Iran national intranet, international outage conditions, IP scanning, Proxy/VPN, and CF Config
🚀 Simple Fast one-click XRAY config connection
🧩 Fragment Cloudflare Dirty IP Recovery using VLESS/Trojan conversion, final JSON generation, Address override, and Xray-based Ping
🟣 NipoVPN nipovpn:// profile support powered by the NipoVPN core
🧠 DNS (MasterDNS) DNS-focused routing with MasterDNS client profiles, resolver profiles, logs, and SOCKS bridge support

🔥 Main Features in Version 1.2.1

  • 🛰️ MSP mode for Iran national intranet and international internet outage conditions
  • 🚀 Fast connection through the Simple page
  • 🧩 Fragment mode for Cloudflare Dirty IP Recovery
  • 🔁 Automatic vless:// and trojan:// conversion into valid Xray JSON
  • 🧱 Automatic Fragment/finalmask injection into the final generated JSON
  • ✏️ Editable Fragment parameters: packets, lengths, delays, and maxSplit
  • 🌐 Fragment Address override for replacing the outbound address inside the final JSON
  • 📡 Real Xray-based Ping for Fragment using the final generated JSON
  • 🟣 Full NipoVPN support
  • 🧠 DNS (MasterDNS) support
  • 📥 nipovpn:// profile import
  • 🧾 Save, select, edit, delete, and export NipoVPN profiles
  • 📡 Real Xray ping for Simple configs
  • 🧪 Stable 3x Xray Ping validation
  • 🧯 Crash Guard for Ping All, background ping scan, and Connect Scan
  • 🧹 Clear Cache without deleting configs
  • 📶 Ping All for Simple configs
  • 🇮🇷 ServerLess (Patterniha)🇮🇷 / IRAN IPS mode
  • 🌐 Google DNS for Simple Normal mode
  • 🧠 Health and latency cache
  • 📶 Background ping refresh after connection
  • 🔎 ISP and SNI based IP scanning
  • 🧱 MSP Proxy Mode and MSP VPN Mode
  • 🔌 Local SOCKS5 and HTTP proxy support
  • ☁️ CF Config for VLESS WS TLS
  • 🧹 Clear IPs button inside the MSP Route card
  • 🧭 Routing Strategy selection
  • 📊 Live download/upload speed
  • 🛡️ SIMORGH app is excluded from its own VPN tunnel to prevent loops and improve scanning

📱 Main App Pages

1. 🚀 Simple

The Simple page is designed for fast connection using XRAY configs.

The user does not need to manage complex settings. The app downloads configs from the internal subscription, tests them, and connects to a reachable healthy config.

Simple Features

  • One-click connection
  • Internal subscription source
  • Update button
  • Clear Cache button
  • Config count display
  • Selected config display
  • Ping display
  • Connection timer
  • Config list opens by tapping the Config area
  • Ping All button
  • Connect to a specific config from the list
  • ServerLess support
  • Stable real Xray Ping scan

Simple Subscription

In the Simple page, XRAY configs are received and managed through the app's internal system.

Simple Normal Mode

In Normal mode, Simple uses XRAY configs from the subscription.

Normal mode features:

  • Downloads configs from the subscription
  • Tests configs using Xray Ping
  • Connects to the first reachable config
  • Continues scanning after connecting
  • Uses Google DNS:
8.8.8.8
8.8.4.4

Simple ServerLess Mode

Simple includes a dropdown for ServerLess.

Display name:

ServerLess(Patterniha) 🇮🇷
IRAN IPS

ServerLess usage:

  • Designed for special Iran-related routes
  • Uses the bundled internal ServerLess config
  • Runs Xray with a TUN/tun2socks compatible structure
  • Useful when the ServerLess config works better than normal subscription configs

ServerLess usually has only one config and is intended for direct ServerLess connection mode.

2. 🛰️ MSP

The MSP page is the key section for special Iran network conditions.

It is designed for cases where international internet access is blocked, heavily restricted, or unstable, while Iran's national intranet / domestic network / local routes are still available. In such cases, MSP uses the RKh-MSP engine, IP scanning, SNI selection, and route building to provide a method for accessing websites.

✅ MSP is suitable for Iran national intranet conditions, full international internet outages, and severe internet restrictions, as long as the local network or required route is still available.

MSP Features

  • RKh-MSP engine
  • ISP selection
  • SNI selection
  • IP scan on port 443
  • Manual IP support
  • Scan speed selection
  • Max IP count selection
  • Proxy Mode
  • VPN Mode
  • Internal SOCKS5 proxy
  • Internal HTTP proxy
  • saved clean IPs
  • Next IP
  • Ping All for clean IPs
  • Routing Strategy
  • CF Config for VLESS
  • Active route display
  • Scanned / Clean / Saved counters
  • Live speed display
  • Background scanning
  • SIMORGH is excluded from its own VPN tunnel for more accurate scanning

Proxy Mode in MSP

In Proxy Mode, the app only starts the local proxy.

Ports:

SOCKS5: 127.0.0.1:9990
HTTP:   127.0.0.1:9991

Proxy Mode is useful for:

  • Using SIMORGH with apps like v2rayNG
  • Testing the RKh-MSP route without starting a full Android VPN
  • Debugging
  • Cases where only a local proxy is needed

VPN Mode in MSP

In VPN Mode, all Android traffic is routed through SIMORGH.

General flow:

Android TUN
   ↓
tun2socks
   ↓
Xray
   ↓
Local RKh-MSP Proxy
   ↓
Clean IP Pool

VPN Mode is useful for:

  • Full-device tunneling
  • Connecting directly from SIMORGH
  • Using discovered clean IPs
  • Easier usage compared to Proxy Mode

MSP Settings

Settings are available from the Settings icon.

ISP

Select the ISP used for IP scanning.

Default:

AbrArvan CDN and IaaS

SNI

Select SNI values for TLS testing.

Default:

chatgpt.com

Manual IP

You can manually paste IPs, CIDR ranges, or IP ranges.

When Manual IP mode is enabled:

  • ISP range scanning is skipped
  • Manual IPs are tested by the app
  • The app tests only the provided manual IPs

Scan

Scan options:

  • Slow
  • Normal
  • Fast
  • Max IPs

Default maximum:

33000

Proxy

Choose the local proxy protocol:

  • SOCKS5
  • HTTP

Route

Available routing strategies:

Option Description
Default Tries clean/saved IPs for the requested host and keeps the working route
Random Random selection from healthy IPs
Round Robin Rotates through healthy IPs
Least Loss Chooses the route with lower failure rate
Lowest Latency Chooses the route with the lowest latency
Hybrid Score Combines quality, latency, and failures for better route selection

3. 🧩 Fragment

The Fragment page is designed for Cloudflare Dirty IP Recovery using plain VLESS or Trojan configs.

The user can paste a simple vless:// or trojan:// link. SIMORGH converts it into valid Xray JSON, applies the optional Address override, injects Fragment/finalmask settings, validates the final JSON, and then starts Xray with the generated configuration.

Displayed subtitle:

Cloudflare Dirty IP Recovery

Fragment Features

  • Dedicated Fragment tab
  • Supports plain vless:// links
  • Supports plain trojan:// links
  • Converts VLESS/Trojan links into valid Xray JSON
  • Injects Fragment/finalmask settings into the final generated JSON
  • Keeps JSON parsing safe by using structured JSON generation instead of manual text concatenation
  • Address override field for replacing the outbound address inside the final JSON
  • Effective Address display from the generated JSON
  • Ping display
  • Real Xray-based Ping using the final generated JSON
  • Large Connect/Disconnect button
  • Fragment connection status in the header
  • Hidden/expandable Fragment Setting panel
  • Editable Fragment parameters

Editable Fragment Parameters

Inside Fragment Setting, these values can be edited:

  • packets
  • lengths
  • delays
  • maxSplit

Fragment Final JSON Behavior

Fragment mode builds the final Xray JSON in this order:

VLESS/Trojan link
   ↓
Convert to valid Xray JSON
   ↓
Apply Address override if provided
   ↓
Inject Fragment/finalmask settings
   ↓
Validate final JSON
   ↓
Run Xray

Fragment Ping

The Ping button does not test the raw VLESS/Trojan link directly.

Instead, SIMORGH builds the final JSON, starts a temporary Xray process with it, sends test traffic through Xray, and shows the final route latency.

4. 🟣 NipoVPN

The NipoVPN page is one of the most important additions in the latest SIMORGH version.

It supports nipovpn:// profiles and uses the native NipoVPN core.

The NipoVPN core is bundled internally with the app, and its default config is managed inside SIMORGH.

NipoVPN Traffic Flow

Android VPN TUN
   ↓
tun2socks
   ↓
Xray local SOCKS inbound
   ↓
Xray SOCKS outbound
   ↓
NipoVPN SOCKS5 Agent

Internal NipoVPN port:

127.0.0.1:9992

Displayed in the UI as:

SOCKS5 9992 → XRAY

NipoVPN Features

  • Dedicated NipoVPN tab
  • NipoVPN Agent connection
  • nipovpn:// link import
  • Add Profile button
  • Profile list
  • Profile selection
  • Profile editing with the pencil icon
  • Profile export/copy with the copy icon
  • Profile delete
  • Profile save
  • NipoVPN server test
  • Config reset
  • Ping display
  • Nipo Server display
  • Local SOCKS5 display
  • NipoVPN connected status
  • Google DNS
  • App excluded from VPN loop

Editable NipoVPN Fields

After importing a profile, these fields can be edited:

  • Name
  • Token
  • Protocol
  • Fake URLs
  • Methods
  • Endpoints
  • Timeout
  • Pull Timeout
  • Tunnel Enable
  • Connection Reuse
  • TLS Enable
  • TLS Verify Peer
  • TLS Cert File
  • TLS Key File
  • TLS CA File
  • Log Level
  • Server IP
  • Server Port
  • HTTP Version
  • User Agent

5. 🧠 DNS (MasterDNS)

The DNS (MasterDNS) page provides DNS-focused routing and resolver profile management.

It is designed for cases where DNS behavior, resolver selection, DNS bridge behavior, or DNS-related routing needs to be controlled separately from the main MSP, Simple, Fragment, and NipoVPN modes.

DNS (MasterDNS) Features

  • Dedicated DNS tab
  • MasterDNS client profile management
  • Resolver profile management
  • Import resolver list
  • Save resolver profile
  • Add resolver profile
  • Select resolver profile
  • Delete resolver profile
  • Refresh logs
  • Clear logs
  • SOCKS bridge support
  • DNS status display
  • Connection state display in the header
  • Safer service lifecycle handling during Stop/Destroy

MasterDNS Modes

MasterDNS can be used as a DNS-focused helper mode for routing and resolver testing.

Typical usage includes:

  • Testing resolver behavior
  • Managing resolver profiles
  • Checking DNS logs
  • Using DNS bridge behavior with local SOCKS routing
  • Troubleshooting DNS-related connection problems

☁️ CF Config

CF Config is available inside the Advance page.

It is designed for Cloudflare VLESS WS TLS configs.

Displayed title:

CF Config
Cloudflare VLESS WS TLS Config

CF Config Features

  • Enable/disable CF Config
  • Paste VLESS config
  • Use clean IPs from MSP scan results
  • Test latency for IPs
  • Latency All button
  • Connect button
  • Sort by Latency
  • Replace only the VLESS address with the selected clean IP

In CF Config, only the VLESS address is replaced by the clean IP. SNI, Host, and Path remain from the original config.

📊 Live Speed

SIMORGH displays live traffic speed:

↓ Download
↑ Upload

This is used in:

  • Simple XRAY
  • MSP VPN / Proxy
  • Fragment
  • NipoVPN
  • DNS (MasterDNS)

🧪 Simple Stability Improvements

For better Simple stability, this README includes the following improvements:

  • Crash guards around Ping All
  • Crash guards around background ping scan
  • Crash guards around shuffled Connect Scan
  • Reduced strict 3x Xray ping concurrency to avoid native process/OOM restarts
  • Timeout around each 3x Xray ping validation
  • Cancels the previous Simple background ping scan before starting a new Connect scan
  • Guards latency-cache writes
  • Guards worker channel sends
  • Safer Simple Connect/Disconnect state handling
  • ServerLess Disconnect crash protection

📘 How to Use

🚀 How to Use Simple

  1. Open the app.
  2. Go to the Simple tab.
  3. If this is your first run, tap Update.
  4. Tap the Config area to open the config list.
  5. Tap Ping All to test all configs.
  6. Tap the big Connect button.
  7. The app tests configs using real Xray Ping.
  8. The first reachable config is selected.
  9. After connection, background scanning continues.

Using Clear Cache in Simple

When ping results look wrong or a config has ping but does not connect:

  1. Tap Clear Cache.
  2. Only health and ping memory are cleared.
  3. Configs are not deleted.
  4. Run Ping All or Connect again.

🇮🇷 How to Use ServerLess in Simple

  1. Open the Simple tab.
  2. Turn ServerLess ON.
  3. IRAN IPS is displayed.
  4. Tap Connect.
  5. The app runs the bundled internal ServerLess config.

ServerLess usually has one config and is intended for direct ServerLess connection mode.

🧩 How to Use Fragment

  1. Open the Fragment tab.
  2. Paste a vless:// or trojan:// config.
  3. Optional: enter an IP or domain in the Address field.
  4. Tap Ping to test the final generated JSON through Xray.
  5. Open Fragment Setting only if you want to edit fragment values.
  6. Tap the big Connect button.
  7. The app converts the config, injects Fragment/finalmask settings, validates the final JSON, and starts Xray.
  8. The header should show:
Fragment Connected

🛰️ How to Use MSP During Iran National Intranet / International Internet Outage

Use this method when international internet access is blocked or heavily restricted, but Iran national intranet / local network is still available.

  1. Open the MSP tab.
  2. Open Settings.
  3. Choose an ISP from the ISP section.
  4. Choose one or more SNI values from the SNI section.
  5. If needed, add manual IPs in the Manual section.
  6. Choose scan speed from the Scan section.
  7. Choose the proxy protocol from the Proxy section:
    • SOCKS5 for 127.0.0.1:9990
    • HTTP for 127.0.0.1:9991
  8. Select Proxy Mode if you only need a local proxy.
  9. Select VPN Mode if you want the whole phone to be tunneled.
  10. Tap the big Connect button.
  11. The app starts scanning.
  12. The first clean IP is added to the route.
  13. Scanning continues in the background.
  14. Use Next IP to switch routes.

🔌 How to Use Proxy Mode with v2rayNG

  1. Open MSP in SIMORGH.
  2. Select Proxy mode.
  3. Go to Settings > Proxy and choose:
    • SOCKS5
    • HTTP
  4. Tap Connect.
  5. In v2rayNG, create a local proxy:
SOCKS5: 127.0.0.1:9990
HTTP:   127.0.0.1:9991
  1. If v2rayNG works with this proxy, the RKh-MSP route and IP pool are working.

🧩 How to Use NipoVPN

  1. Open the NipoVPN tab.
  2. Paste your profile link into the field:
nipovpn://
  1. Tap Add Profile.
  2. Tap Show Profiles.
  3. Select the profile you want.
  4. Tap the pencil icon ✎ to edit.
  5. Tap the copy icon ⧉ to export/copy the profile.
  6. Tap Test if you want to test the server.
  7. If you changed fields, tap Save Profile.
  8. Tap Connect.
  9. The status should become:
NipoVPN connected

🧠 How to Use DNS (MasterDNS)

  1. Open the DNS tab.
  2. Select or create a MasterDNS profile.
  3. Import or select resolver profiles if needed.
  4. Save the profile after editing values.
  5. Tap Connect.
  6. Use Refresh Logs to check runtime status.
  7. Use Clear Logs when you want a clean log view.
  8. Disconnect when DNS/MasterDNS testing is finished.

☁️ How to Use CF Config

  1. First run MSP scanning so clean IPs are available.
  2. Open CF Config.
  3. Enable CF Config.
  4. Paste your VLESS WS TLS config.
  5. Tap Latency All.
  6. Choose the IP with better latency.
  7. Tap Connect.

Only the VLESS address is replaced with the clean IP. SNI, Host, and Path remain unchanged.

🛠️ Troubleshooting

Simple does not connect

  • Tap Update
  • Tap Ping All
  • Tap Clear Cache
  • Try Connect again
  • Test ServerLess ON/OFF

ServerLess does not connect

  • Toggle ServerLess OFF and ON
  • Clear Cache
  • Run Connect again
  • Remember that ServerLess usually has only one config

Fragment does not connect

  • Make sure the config starts with vless:// or trojan://
  • Check the Address field if you are overriding the outbound address
  • Tap Ping first to test the final generated JSON
  • Open Fragment Setting and reset values if you changed them
  • Try another IP or domain in the Address field
  • Disconnect and connect again

MSP does not work during Iran national intranet conditions

  • Change ISP
  • Change SNI
  • Try Manual IPs
  • Change Scan Speed
  • Test Proxy Mode separately with v2rayNG
  • Change Route Strategy
  • Clear saved clean IPs and scan again

NipoVPN does not connect

  • Make sure the link starts with nipovpn://
  • Tap Add Profile
  • Select the profile
  • Check Server IP and Server Port
  • Run Test
  • Tap Save Profile
  • Connect again

DNS (MasterDNS) does not connect

  • Check the selected MasterDNS profile
  • Check resolver profiles
  • Refresh logs and review the latest error
  • Try another resolver profile
  • Clear logs and connect again
  • Disconnect and restart the DNS mode if the runtime state looks stuck

CF Config does not work

  • Fill saved clean IPs through Advance first
  • Make sure the config starts with vless://
  • Tap Latency All
  • Choose a healthier IP
  • Check SNI / Host / Path in the original config

🧱 Technical Structure

Important Internal Data

SIMORGH manages the required IP scan, SNI, ServerLess, and NipoVPN data internally, so source file paths are not exposed in this README.

Traffic Flows

Simple Normal

Android TUN
   ↓
tun2socks
   ↓
Xray SOCKS
   ↓
Selected XRAY Config

Simple ServerLess

Android TUN
   ↓
tun2socks
   ↓
Xray mixed inbound
   ↓
ServerLess routing

Fragment

VLESS / Trojan link
   ↓
Generated Xray JSON
   ↓
Address override
   ↓
Fragment/finalmask settings
   ↓
Xray
   ↓
Android TUN / tun2socks

MSP VPN Mode

Android TUN
   ↓
tun2socks
   ↓
Xray
   ↓
RKh-MSP Local Proxy
   ↓
Clean IP Pool

MSP Proxy Mode

Local App / v2rayNG
   ↓
127.0.0.1:9990 SOCKS5
or
127.0.0.1:9991 HTTP
   ↓
RKh-MSP Clean IP Pool

DNS (MasterDNS)

MasterDNS profile
   ↓
Resolver profile
   ↓
MasterDNS runtime
   ↓
Local SOCKS / DNS bridge
   ↓
Xray bridge when needed

NipoVPN

Android TUN
   ↓
tun2socks
   ↓
Xray 127.0.0.1:10808
   ↓
NipoVPN SOCKS5 127.0.0.1:9992
   ↓
NipoVPN Agent

📦 Installation

  1. Install the APK.
  2. Grant VPN permission.
  3. Use MSP for Iran national intranet and international internet outage conditions.
  4. Use Simple for fast XRAY connection.
  5. Use Fragment for Cloudflare Dirty IP Recovery with VLESS/Trojan configs.
  6. Use NipoVPN for nipovpn:// profiles.
  7. Use DNS (MasterDNS) for DNS-focused routing and resolver profile testing.

🔐 Required Permissions

  • Internet access
  • VPN permission
  • Network state access
  • Foreground Service for stable connection

👨‍💻 Made By

Made By RKh!
Telegram: @pingplas_channel

⚠️ Disclaimer

This project is provided for educational, research, and legal use only. Users are responsible for how they use the app. Please use this tool according to the laws of your region.

⭐ Support

If SIMORGH is useful to you, please give the project a ⭐ on GitHub.

SIMORGH VPN
Fast. Smart. MSP. Fragment, DNS, and NipoVPN Ready.

Highly Recommended：Google Play 4.7 Star Android Developer Tools, Decompile, View Manifest, Open Debug Options Quickly

Apps
Android Developer Tools
Android Developer Tools Pro
About Me
Tools: TimeShining
GitHub: Trinea
Facebook: Dev Tools
AI Daily Digest
Daily AI News & Insights