Auto-curated top 3 fastest proxy keys per country, refreshed automatically. Multi-protocol: VLESS / VMess / Trojan / Shadowsocks.
Pick the protocol your client supports best. Each has its own subscription URLs:
All VLESS countries (single subscription):
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/vless/all.txt
Specific country:
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/vless/<CC>.txt
Rotating exits: subs/vless/rotating.txt (0 configs)
All VMESS countries (single subscription):
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/vmess/all.txt
Specific country:
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/vmess/<CC>.txt
Rotating exits: subs/vmess/rotating.txt (0 configs)
All TROJAN countries (single subscription):
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/trojan/all.txt
Specific country:
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/trojan/<CC>.txt
Rotating exits: subs/trojan/rotating.txt (0 configs)
All SS countries (single subscription):
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/ss/all.txt
Specific country:
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/ss/<CC>.txt
Rotating exits: subs/ss/rotating.txt (0 configs)
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/all.txt
Specific country across all protocols:
https://raw.githubusercontent.com/trikiman/vlessfilter/main/subs/<CC>.txt
Rotating exits (all protocols): subs/rotating.txt
Many public configs route through proxy chains, load balancers, or Cloudflare Workers — these have rotating exit countries (e.g., one connection lands in Sweden, the next in India). Tagging them with a single country would be misleading.
Each config's full test history is checked:
- Stable (always exits same country) → published in
subs/<protocol>/<CC>.txtwith that country code - Rotating (varies across tests, OR is a
*.workers.dev/*.pages.devhost) → published insubs/<protocol>/rotating.txtwith🌐 ROTATINGlabel - Dead → not published
VlessFilter is a single Go binary. Two install paths, pick whichever:
go install github.com/trikiman/vlessfilter/cmd/vlessfilter@latestBinary lands in $GOPATH/bin (or $HOME/go/bin). Make sure that's on your $PATH.
git clone https://github.com/trikiman/vlessfilter.git
cd vlessfilter
go build -o bin/vlessfilter ./cmd/vlessfiltervlessfilter --help
# Quick smoke run against the default sources (writes ./subs/ + ./README.md):
vlessfilter run --threads1 50 --threads2 5 --limit 30 --budget-min 5
ls subs/Edit sources.yaml to add or remove subscription sources. See comments in the file for the schema.
Run the pipeline without using your own computer. The primary, recommended path is GitHub Actions (Option A) — free, fully automated, always-on, and already shipped in this repo (.github/workflows/refresh.yml). The other options are optional manual fallbacks.
- Stage 1 — alive/handshake check. High-concurrency TLS handshake against the pool; dead keys are dropped.
- Stage 2 — speed connection test. Survivors get a real-proxy speedtest, run 3 separate times, to measure throughput (Mbps) and latency (ms).
- Pre-publish probe. Top-3-per-country selections are re-tested right before publishing so stale/dead keys never reach the results.
Results appear in README.md (per-country latency + median speed table) and all-results.csv (full raw results).
Cost: $0 (public repos get unlimited Actions minutes). Setup: ~5 min. Always-on: yes.
- Create a GitHub account (any throwaway email; no card needed for free-tier Actions on public repos).
- Fork
https://github.com/trikiman/vlessfilter. - Generate a PAT (Settings → Developer settings → Fine-grained tokens): repository access = your results repo, Permissions → Contents = Read and write.
- In the repo: Settings → Secrets and variables → Actions → new secret
PUSH_TOKEN= the PAT. - Enable Actions: Settings → Actions → General → Allow all.
- Trigger the first run: Actions tab → refresh workflow → Run workflow.
refresh.yml runs every 4 hours, does the full alive-check + speed test, and commits fresh results — no involvement from your machine.
Free 15-min VPS (4 CPU / 8 GB / 1 Gbps), no account. Generate a PAT (as in Option A), open https://h2.nexus/cli, pick Debian 11, then in the web console run:
curl -sSL https://raw.githubusercontent.com/trikiman/vlessfilter/main/scripts/h2-quick.sh | bash -s -- ghp_xxxResults push automatically; the VM auto-deletes at 15 min. Manual trigger only (no schedule), reduced run scope to fit the window.
Install Termux from F-Droid, then:
pkg update && pkg upgrade -y
pkg install -y golang git curl
curl -sSL https://raw.githubusercontent.com/trikiman/vlessfilter/main/scripts/install-always-on.sh | bash -s -- github_pat_xxxcron may fail under Termux — use termux-job-scheduler --period-ms 21600000 --script $HOME/.vlessfilter/refresh.sh (6h). Keep the phone charging and out of deep sleep for a full run.
| Your situation | Pick |
|---|---|
| Fully autonomous, always-on, zero maintenance | Option A (GitHub Actions) — default |
| One-off manual refresh, no account | Option B (h2.nexus) |
| Only a phone available | Option C (Termux) |
Note: the earlier 2Z2 Cloud Labs VPS runbook is retired (the service shut down). GitHub Actions is the recommended replacement.
| Country | Top latency (ms) | Median speed (Mbps) | Keys |
|---|---|---|---|
| 🇦🇺 AU | 1147 | 15.6 | 1 |
| 🇧🇾 BY | 586 | 22.3 | 1 |
| 🇨🇿 CZ | 461 | 41.9 | 3 |
| 🇩🇪 DE | 298 | 57.8 | 3 |
| 🇪🇪 EE | 473 | 45.3 | 2 |
| 🇪🇸 ES | 688 | 35.8 | 1 |
| 🇫🇮 FI | 474 | 43.7 | 3 |
| 🇫🇷 FR | 335 | 45.7 | 3 |
| 🇬🇧 GB | 352 | 62.3 | 1 |
| 🇭🇰 HK | 1227 | 19.4 | 1 |
| 🇮🇳 IN | 820 | 19.2 | 2 |
| 🇮🇷 IR | 1059 | 27.3 | 1 |
| 🇯🇵 JP | 586 | 38.2 | 1 |
| 🇰🇷 KR | 772 | 21.7 | 1 |
| 🇰🇿 KZ | 1436 | 25.6 | 1 |
| 🇳🇱 NL | 365 | 64.2 | 3 |
| 🇵🇱 PL | 437 | 49.2 | 3 |
| 🇷🇺 RU | 478 | 50.1 | 2 |
| 🇸🇪 SE | 450 | 47.5 | 3 |
| 🇸🇬 SG | 943 | 22.0 | 3 |
| 🇸🇰 SK | 472 | 47.8 | 1 |
| 🇹🇷 TR | 678 | 33.7 | 1 |
| 🇺🇦 UA | 589 | 41.3 | 1 |
| 🇺🇸 US | 32 | 357.0 | 3 |
Rotating-exit pool: 0 configs in subs/vless/rotating.txt
| Country | Top latency (ms) | Median speed (Mbps) | Keys |
|---|---|---|---|
| 🇧🇷 BR | 803 | 29.1 | 2 |
| 🇨🇦 CA | 247 | 81.9 | 2 |
| 🇩🇪 DE | 570 | 41.0 | 3 |
| 🇫🇷 FR | 629 | 37.3 | 3 |
| 🇬🇧 GB | 563 | 41.9 | 2 |
| 🇭🇰 HK | 120 | 54.0 | 2 |
| 🇮🇪 IE | 364 | 48.0 | 1 |
| 🇰🇷 KR | 388 | 21.1 | 3 |
| 🇲🇾 MY | 2532 | 17.2 | 1 |
| 🇳🇱 NL | 662 | 34.9 | 2 |
| 🇵🇱 PL | 1143 | 14.0 | 1 |
| 🇸🇪 SE | 692 | 32.2 | 1 |
| 🇸🇬 SG | 817 | 28.4 | 1 |
| 🇹🇭 TH | 778 | 23.6 | 1 |
| 🇺🇸 US | 97 | 169.5 | 3 |
Rotating-exit pool: 0 configs in subs/vmess/rotating.txt
| Country | Top latency (ms) | Median speed (Mbps) | Keys |
|---|---|---|---|
| 🇨🇦 CA | 184 | 59.1 | 2 |
| 🇨🇭 CH | 541 | 21.3 | 3 |
| 🇩🇪 DE | 543 | 22.6 | 3 |
| 🇪🇸 ES | 524 | 23.4 | 3 |
| 🇳🇱 NL | 467 | 25.2 | 3 |
| 🇺🇸 US | 86 | 131.2 | 3 |
| 🇿🇦 ZA | 1028 | 23.7 | 1 |
Rotating-exit pool: 0 configs in subs/trojan/rotating.txt
| Country | Top latency (ms) | Median speed (Mbps) | Keys |
|---|---|---|---|
| 🇦🇹 AT | 319 | 57.2 | 1 |
| 🇨🇦 CA | 60 | 120.8 | 3 |
| 🇨🇭 CH | 328 | 50.4 | 3 |
| 🇩🇪 DE | 267 | 67.2 | 3 |
| 🇪🇸 ES | 265 | 64.4 | 3 |
| 🇫🇷 FR | 259 | 68.6 | 3 |
| 🇬🇧 GB | 235 | 73.5 | 3 |
| 🇳🇱 NL | 261 | 65.9 | 3 |
| 🇳🇴 NO | 424 | 13.6 | 1 |
| 🇵🇱 PL | 364 | 49.7 | 1 |
| 🇸🇪 SE | 287 | 49.2 | 3 |
| 🇸🇬 SG | 692 | 25.2 | 3 |
| 🇺🇸 US | 13 | 744.8 | 3 |
Rotating-exit pool: 0 configs in subs/ss/rotating.txt
Generated by vlessfilter. Source list: sources.yaml.