Skip to content

OpenRay is one of the largest open-source systems for collecting, validating, and curating free proxy servers. It runs hourly through a three-stage pipeline to remove dead proxies and maintain high-quality lists by protocol and country. Originally built for Iran, it now serves users worldwide.

Notifications You must be signed in to change notification settings

sakha1370/OpenRay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4,999 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 OpenRay

A community-driven attempt to keep the internet open and affordable

Stars Forks License Python Contributors

Free, tested, and reliable proxy lists for everyone

🚀 Quick Start📋 Proxy Lists🤝 Contributing⭐ Star Growth


✨ 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

Clash Verge
Clash Verge Rev
📥 Download
Windows/macOS/Linux
v2rayNG
v2rayNG
📥 Download
Android
v2rayN
v2rayN
📥 Download
Multi-platform GUI
Hiddify
Hiddify App
📥 Download
All Platforms

📋 Proxy Collections

🌍 Global Collection

📦 Complete Collection

Download All

⚙️ Ready-to-Use Configs

📱 Clash Format
Clash Config
🚀 Singbox Format
Singbox Config

🔧 By Protocol Type

🔵 VMess
Download
Versatile V2Ray
🟢 VLess
Download
Lightweight V2Ray
🔒 Trojan
Download
TLS-based protocol
⚡ Shadowsocks
Download
Fast SOCKS5
🔑 ShadowsocksR
Download
Extended SS
🌐 Hysteria
Download
High-performance UDP
🚀 TUIC
Download
QUIC-based
🧃 Juicity
Download
Modern QUIC

🌎 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

🏆 Top 100 Most Reliable

Top 100

📊 Operator-Specific Rankings & Configurations

Carrier 📋 Raw Proxies 📱 Clash Config 🚀 Singbox Config Description
📱 MCI Download Clash MCI Singbox MCI Iran Cell (Hamrah-e-Aval) optimized proxies
📶 Irancell Download Clash Irancell Singbox Irancell Irancell (MTN IranCell) optimized proxies
🌐 TCI Download Clash TCI Singbox TCI Telecommunication Company of Iran optimized proxies
🌍 Others Download Clash Others Singbox Others Other carriers and general Iran-optimized proxies

🏆 General Iran-Optimized Configs

Format 🏆 Top 100 📦 Full Collection
📱 Clash Clash Top 100 Clash All
🚀 Singbox Singbox Top 100 Singbox All

✈️ Telegram Proxies Collection

📦 Complete Telegram Collection

Download All


⚡ Features

🔍 Smart Discovery

Multi-source fetching from raw pages and base64 subscriptions with 50+ countries coverage

⚡ Lightning Testing

Parallel processing with multi-stage validation: ICMP → TCP → TLS → Protocol

📊 Intelligent Organization

Protocol categorization, geographic grouping, and stability tracking

🎯 Iran Optimization

Specialized filtering and top 100 reliability ranking for Iranian networks

🚀 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

🌟 Join Our Growing Community!

Contributors Issues Pull Requests

💡 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

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

✅ Include ❌ Avoid
• Reliable sources with consistent uptime
• Legal and ethical proxy providers
• Diverse protocols and locations
• Well-maintained repositories
• Potentially malicious sources
• Compromised or suspicious providers
• Sources with frequent downtime
• Illegal or questionable services

📊 Project Statistics

🌐 Global Reach
🔄 Auto Updates
⚡ Protocols
✅ Success Rate

⚠️ Important Disclaimer

📚 Educational & Research Use Only
This project is intended for educational and research purposes.
You are solely responsible for how you use the provided connections.

Please use responsibly and in accordance with your local laws.

🌟 Made with ❤️ for the Open Internet Community

Keeping the internet accessible, one proxy at a time

Star History Chart

⭐ Star this project🔄 Share with friends🤝 Contribute

⬆️ Back to Top

About

OpenRay is one of the largest open-source systems for collecting, validating, and curating free proxy servers. It runs hourly through a three-stage pipeline to remove dead proxies and maintain high-quality lists by protocol and country. Originally built for Iran, it now serves users worldwide.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •