🌐 OpenRay

Collector runtime

The collector uses Python 3.13+, transactional SQLite, bounded asynchronous queues and pinned Xray, sing-box and mihomo cores. Subscription paths and URLs remain available. New candidates require an end-to-end successful check; infrastructure failures preserve existing connection health.

python -m pip install -r requirements.lock
python -m pip install --no-deps --no-build-isolation -e .
python tools/install_cores.py
python -m openray migrate
python -m openray run --report .state/latest-run.json

The run stages an immutable snapshot. Installation and publishing are separate commands with client validation gates. Read the implementation evidence, operations and recovery guide, compatibility contract, and protocol matrix before a production cutover. The 24-hour endurance and representative week of network canaries remain deployment acceptance gates.

✨ Our Story

The journey began when free proxies in Iran kept disconnecting almost hourly, forcing users to pay exorbitant prices for premium services. Frustrated by this cycle, I built an automated pipeline that:

• 🔍 Fetches proxies from trusted sources across the internet
• ⚡ Tests each proxy for reliability and speed
• 🧹 Filters out dead or low-quality connections
• 📦 Curates only the best working proxies

"Breaking the cycle of expensive internet access, one proxy at a time."

🚀 Quick Start

For Immediate Use

🌍 Global Users:

# Download all tested proxies
curl -s https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/all_valid_proxies.txt

🇮🇷 Iran Users (Optimized):

# get the endpoints verified from Iranian subscriber networks
curl -s https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/site_access/aistudio_iran_verified.txt

📱 Popular Clients

Clash Verge Rev 📥 Download Windows/macOS/Linux

v2rayNG 📥 Download Android

v2rayN 📥 Download Multi-platform GUI

Hiddify App 📥 Download All Platforms

📋 Proxy Collections

🌍 Global Collection

📦 Complete Collection

⚙️ Ready-to-Use Configs

📱 Clash Format

🚀 Singbox Format

🇮🇷 Iran-Optimized Collection

• ✅ Protocol-aware validation and exports: see the capability matrix, including explicit unsupported outcomes
• ✅ End-to-end validation: supervised protocol cores, authenticated loopback probes, deadlines and target policies
• ✅ Geographic Intelligence: 50+ countries with flag indicators and regional optimization
• ✅ Auto-Generated Configs: Ready-to-use Clash and Singbox configurations
• ✅ Stability Tracking: Persistent monitoring with reliability streaks
• ✅ Auto-Core Detection: Automatic Xray/V2Ray core detection and integration
• ✅ Operator-Specific Tracking: Detailed Iran carrier analytics (MCI, Irancell, TCI, Others)

📊 Data Structure & Analytics

Exported score structure:

{
  "vless://uuid@server:port": {
    "global": 17,
    "iran": {
      "total": 5,
      "operators": {
        "mci": 1,
        "irancell": 3,
        "tci": 1,
        "others": 0
      }
    }
  }
}

Iran Carrier-Specific CLI Commands:

# Track MCI (Iran Cell) optimized proxies
python3 -m src.main_for_iran --mci

Track Irancell optimized proxies
python3 -m src.main_for_iran --irancell
Track TCI (Telecom) optimized proxies
python3 -m src.main_for_iran --tci
Default: Track "others" category
python3 -m src.main_for_iran

🤝 Contributing

# Add to these files:
sources.txt         # Global sources

Then: Open an issue or submit a PR!

🐛 Report & Fix Issues

• 🐛 Found a bug? → Create an issue
• 💡 Have an idea? → Start a discussion
• 📚 Need help? → Check discussions

⭐ Show Your Support

• ⭐ Star this repo to help others discover it
• 🔄 Share with friends and communities
• 💻 Contribute code improvements and features
• 📝 Improve documentation and guides

📝 Code Standards

• ✅ Follow PEP 8 style guidelines
• ✅ Add docstrings to new functions
• ✅ Test thoroughly before submitting
• ✅ Update docs as needed

🎯 Proxy Source Guidelines

📊 Project Statistics

🌐 Global Reach

🔄 Auto Updates

⚡ Protocols

✅ Success Rate Measured checks and remaining acceptance gates