https://github.com/sakha1370/OpenRay
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.
https://github.com/sakha1370/OpenRay
free-proxies internet-freedom iran proxy shadowsocks trojan v2ray vless vmess vpn xray
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/sakha1370/OpenRay
- Owner: sakha1370
- Created: 2025-08-20T15:31:10.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-05-06T18:26:55.000Z (about 2 months ago)
- Last Synced: 2026-05-06T18:36:43.124Z (about 2 months ago)
- Topics: free-proxies, internet-freedom, iran, proxy, shadowsocks, trojan, v2ray, vless, vmess, vpn, xray
- Language: Python
- Homepage:
- Size: 2.17 GB
- Stars: 183
- Watchers: 2
- Forks: 13
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: change.py
Awesome Lists containing this project
README
# 🌐 OpenRay
**A community-driven attempt to keep the internet open and affordable**
[](https://github.com/sakha1370/OpenRay/stargazers)
[](https://github.com/sakha1370/OpenRay/network/members)
[](https://opensource.org/licenses/MIT)
[](https://python.org)
[](https://github.com/sakha1370/OpenRay/graphs/contributors)
*Free, tested, and reliable proxy lists for everyone*
[🚀 Quick Start](#-quick-start) • [📋 Proxy Lists](#-proxy-collections) • [🤝 Contributing](#-contributing) • [⭐ Star Growth](#-github-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:**
```bash
# Download all tested proxies
curl -s https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/all_valid_proxies.txt
```
**🇮🇷 Iran Users (Optimized):**
```bash
# 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 Rev
📥 Download
Windows/macOS/Linux
v2rayNG
📥 Download
Android
v2rayN
📥 Download
Multi-platform GUI
Hiddify App
📥 Download
All Platforms
---
## 📋 Proxy Collections
### 🌍 Global Collection
#### 📦 Complete Collection
[](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/all_valid_proxies.txt)
#### ⚙️ Ready-to-Use Configs
📱 Clash Format
🚀 Singbox Format
#### 🔧 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](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/RU.txt) • 🇨🇳 [China](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/CN.txt) • 🇮🇳 [India](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/IN.txt) • 🇮🇹 [Italy](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/IT.txt) • 🇪🇸 [Spain](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/ES.txt) • 🌐 [All Others](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output/country/XX.txt)
---
### 🇮🇷 Iran-Optimized Collection
#### 🏆 Top 100 Most Reliable
[](https://raw.githubusercontent.com/sakha1370/OpenRay/refs/heads/main/output_iran/iran_top100_checked.txt)
#### 📊 Operator-Specific Rankings & Configurations
Carrier
📋 Raw Proxies
📱 Clash Config
🚀 Singbox Config
Description
📱 MCI
Download
Iran Cell (Hamrah-e-Aval) optimized proxies
📶 Irancell
Download
Irancell (MTN IranCell) optimized proxies
🌐 TCI
Download
Telecommunication Company of Iran optimized proxies
🌍 Others
Download
Other carriers and general Iran-optimized proxies
#### 🏆 General Iran-Optimized Configs
Format
🏆 Top 100
📦 Full Collection
📱 Clash
🚀 Singbox
---
## ✈️ Telegram Proxies Collection
📦 Complete Telegram Collection
[](https://raw.githubusercontent.com/sakha1370/V2rayCollector/refs/heads/main/active_mtproto_proxies.txt)
---
## ⚡ 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:**
```json
{
"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:**
```bash
# 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!**
[](https://github.com/sakha1370/OpenRay/graphs/contributors)
[](https://github.com/sakha1370/OpenRay/issues)
[](https://github.com/sakha1370/OpenRay/pulls)
### 💡 **Ways to Help**
#### 🔍 **Add New Proxy Sources**
Found a reliable proxy source? Help expand our network!
```bash
# Add to these files:
sources.txt # Global sources
```
**Then:** [Open an issue](https://github.com/sakha1370/OpenRay/issues) or [submit a PR](https://github.com/sakha1370/OpenRay/pulls)!
#### 🐛 **Report & Fix Issues**
- 🐛 **Found a bug?** → [Create an issue](https://github.com/sakha1370/OpenRay/issues/new/choose)
- 💡 **Have an idea?** → [Start a discussion](https://github.com/sakha1370/OpenRay/discussions)
- 📚 **Need help?** → [Check discussions](https://github.com/sakha1370/OpenRay/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**
✅ 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
[](https://star-history.com/#sakha1370/OpenRay&Date)
**[⭐ Star this project](https://github.com/sakha1370/OpenRay)** • **[🔄 Share with friends](https://github.com/sakha1370/OpenRay)** • **[🤝 Contribute](https://github.com/sakha1370/OpenRay#-contributing)**
[⬆️ Back to Top](#-openray)