https://github.com/shatakvpn/configforge-v2ray

A powerful tool to automatically download, parse, and organize VPN configurations (VLESS, VMess, Shadowsocks, etc.) and push updates to GitHub.
https://github.com/shatakvpn/configforge-v2ray

check-host config shadowsocks trojan v2ray v2ray-config v2ray-subscribe vless vmess

Last synced: 10 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/shatakvpn/configforge-v2ray
Owner: ShatakVPN
License: gpl-3.0
Created: 2025-08-09T20:02:58.000Z (11 months ago)
Default Branch: main
Last Pushed: 2025-08-31T11:00:03.000Z (10 months ago)
Last Synced: 2025-08-31T12:28:04.301Z (10 months ago)
Topics: check-host, config, shadowsocks, trojan, v2ray, v2ray-config, v2ray-subscribe, vless, vmess
Language: Python
Homepage:
Size: 5.6 MB
Stars: 39
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

🌐 Available in: [English](README.md) | [فارسی](README_FA.md) | [Русский](README_ru.md) | [中文](README_zh.md)

# 🌍 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](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/all.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/all.txt) |
| `light.txt` | Top 30 fastest global configs | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/light.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/light.txt) |
| `vless.txt` | Global VLESS-only list | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/vless.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/vless.txt) |
| `vmess.txt` | Global VMess-only list | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/vmess.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/vmess.txt) |
| `shadowsocks.txt` | Global Shadowsocks-only list | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/shadowsocks.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/shadowsocks.txt) |
| `trojan.txt` | Global Trojan-only list | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/trojan.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/trojan.txt) |
| `unknown.txt` | Other/unknown protocols | [Open](https://raw.githubusercontent.com/ShatakVPN/ConfigForge-V2Ray/main/configs/unknown.txt) · [Mirror](https://cdn.jsdelivr.net/gh/ShatakVPN/ConfigForge-V2Ray@main/configs/unknown.txt) |

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/](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](https://check-host.net/)
- ✅ 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:
```bash
git clone https://github.com/ShatakVPN/ConfigForge.git
cd ConfigForge
```

Install dependencies:
```bash
pip install -r source/requirements.txt
```

Run the main script:
```bash
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**:
```bash
.github/workflows/update.yml
```
4. 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](https://starchart.cc/ShatakVPN/ConfigForge-V2Ray.svg?variant=adaptive)](https://starchart.cc/ShatakVPN/ConfigForge-V2Ray)