🌐 OpenRay

---

✨ 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

The result? Free, high-quality proxy lists that anyone can use, completely open-source and community-driven.

"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 just the top 100 most reliable
curl -s https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output_iran/iran_top100_checked.txt

📱 Popular Clients

---

📋 Proxy Collections

🌍 Global Collection

🔧 By Protocol Type

🌎 By Country/Region

🌍 Popular Locations (Click to expand)

🌎 Americas	🌍 Europe	🌏 Asia Pacific	🕌 Middle East
🇺🇸 United States 🇨🇦 Canada 🇧🇷 Brazil 🇦🇺 Australia	🇩🇪 Germany 🇬🇧 United Kingdom 🇫🇷 France 🇳🇱 Netherlands	🇯🇵 Japan 🇸🇬 Singapore 🇰🇷 South Korea 🇭🇰 Hong Kong	🇮🇷 Iran 🇹🇷 Turkey 🇦🇪 UAE 🇸🇦 Saudi Arabia

More: 🇷🇺 Russia • 🇨🇳 China • 🇮🇳 India • 🇮🇹 Italy • 🇪🇸 Spain • 🌐 All Others

---

🇮🇷 Iran-Optimized Collection

---

✈️ Telegram Proxies Collection

---

⚡ Features

🚀 Core Capabilities

• ✅ 8+ Proxy Protocols: VMess, VLess, Trojan, Shadowsocks, SSR, Hysteria, TUIC, Juicity
• ✅ 3-Stage Validation: ICMP ping → TCP connect → Protocol verification
• ✅ 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

The system tracks proxy reliability using a sophisticated scoring system:

New JSON Structure:

{
  "vless://uuid@server:port": {
    "global": 17,
    "iran": {
      "total": 5,
      "operators": {
        "mci": 1,
        "irancell": 3,
        "tci": 1,
        "others": 0
      }
    },
    "consecutive_failures": 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

💡 Ways to Help

🔍 Add New Proxy Sources

Found a reliable proxy source? Help expand our network!

# 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

---