Skip to content

A powerful tool to automatically download, parse, and organize VPN configurations (VLESS, VMess, Shadowsocks, etc.) and push updates to GitHub.

License

Notifications You must be signed in to change notification settings

ShatakVPN/ConfigForge-V2Ray

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 Available in: English | فارسی | Русский | 中文

🌍 ConfigForge V2Ray

ConfigForge V2Ray is an advanced open-source platform that aggregates and optimizes V2Ray VPN configurations from multiple sources.
It automatically detects your country and suggests the fastest configurations, verified through Check-Host API latency testing, to ensure the best connection speed and reliability.


🌐 Access the Web Interface

Quick Global Subscriptions (Direct Links)

Use these global subscription URLs in any V2Ray-compatible client (v2rayNG, V2RayN, Shadowrocket, etc.).
Click a link and copy the URL into your client’s Subscriptions section.

File Description Direct
all.txt Full global list (ranked by average latency) Open · Mirror
light.txt Top 30 fastest global configs Open · Mirror
vless.txt Global VLESS-only list Open · Mirror
vmess.txt Global VMess-only list Open · Mirror
shadowsocks.txt Global Shadowsocks-only list Open · Mirror
trojan.txt Global Trojan-only list Open · Mirror
unknown.txt Other/unknown protocols Open · Mirror
Show raw URLs (copy/paste)
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/all.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/light.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/vless.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/vmess.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/shadowsocks.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/trojan.txt
https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/unknown.txt

Mirrors (jsDelivr):

https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/all.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/light.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/vless.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/vmess.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/shadowsocks.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/trojan.txt
https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/unknown.txt

For the easiest experience, use our modern multi-language web interface:
➡️ https://shatakvpn.github.io/ConfigForge-V2Ray/


🚀 Why ConfigForge?

Unlike basic config repositories, ConfigForge V2Ray:

  • ✅ Continuously fetches configs from multiple sources
  • Tests latency for each country using Check-Host API
  • ✅ Suggests the fastest servers for your location
  • ✅ Provides aggregated, lightweight, and categorized configs (VLESS, VMess, Shadowsocks, Trojan)
  • ✅ Runs automatically with GitHub Actions – no server required!

✨ Features

  • 🌍 Country-based selection – Automatically detect your location or choose manually
  • 🔍 Latency-tested recommendations – Get only the fastest working configs for your country
  • 🌐 Multi-language support – Dynamic translation of the entire interface
  • 📂 Subscription files available:
    • all.txt → Full list of configs
    • light.txt → Top 30 fastest configs
    • Individual files for each protocol (VLESS, VMess, Shadowsocks, Trojan)
  • 🔄 Auto-updates via GitHub Actions
  • Optimized for speed and simplicity
  • 🛠 Easy to extend for new protocols or sources

✅ Additional Features:

  • Download VPN config lists from multiple sources
  • Parse and categorize configs by protocol
  • Generate aggregated and lightweight subscription files
  • Auto commit and push updates to GitHub
  • Fully customizable structure for advanced users

🛠 How to Use

✅ Option 1: Run Locally

Clone the repository:

git clone https://github.com/ShatakVPN/ConfigForge.git
cd ConfigForge

Install dependencies:

pip install -r source/requirements.txt

Run the main script:

python source/main.py

✅ Option 2: Run Automatically on GitHub (Serverless)

You can fork this repository and let GitHub Actions handle everything for you!

  1. Fork this repository to your own GitHub account.
  2. Create a Personal Access Token (PAT) and add it as a secret:
    • Go to Settings → Secrets → Actions
    • Add a new secret named PAT_TOKEN with your token value.
  3. Enable the included workflow:
.github/workflows/update.yml
  1. Done! The workflow will automatically:
    • Download and update VPN configs
    • Commit changes to your forked repo
    • Run on a schedule — completely serverless!

⭐ Repository Popularity

Stargazers over time

Stars Forks Last Commit License Top Language


This project is licensed under the GPL-3.0 License.

❤️ Built with love by ShatakVPN

About

A powerful tool to automatically download, parse, and organize VPN configurations (VLESS, VMess, Shadowsocks, etc.) and push updates to GitHub.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages