Skip to content

Latest commit

ย 

History

7,639 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ OpenRay

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

Stars Forks Python Contributors

Free, tested, and reliable proxy lists for everyone

๐Ÿš€ Quick Start โ€ข ๐Ÿ“‹ Proxy Lists โ€ข ๐Ÿค Contributing โ€ข โญ Star Growth


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

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

Bounded asynchronous processing with authenticated, end-to-end protocol validation

๐Ÿ“Š Intelligent Organization

Protocol categorization, geographic grouping, and stability tracking

๐ŸŽฏ Iran Optimization

Specialized filtering and top 100 reliability ranking for Iranian networks

๐Ÿš€ Core Capabilities

  • โœ… 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

SQLite is authoritative for connection health and historical counters. This compatibility JSON is a materialized export, not a database checkpoint:

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

๐ŸŒŸ 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
Measured checks and remaining acceptance gates

โš ๏ธ 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 collections of free proxy servers, running hourly pipelines to ensure high-quality lists by protocol and country, promoting open and unrestricted internet access for everyone worldwide.

Topics

Resources

Stars

246 stars

Watchers

2 watching

Forks

Packages

Contributors

Languages