Skip to content

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

VlessFilter Results

Auto-curated top 3 fastest proxy keys per country, refreshed automatically. Multi-protocol: VLESS / VMess / Trojan / Shadowsocks.

How to use

Pick the protocol your client supports best. Each has its own subscription URLs:

VLESS

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)

VMESS

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)

TROJAN

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)

SS

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)

All protocols combined (one URL → everything)

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

Stability filter

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>.txt with that country code
  • Rotating (varies across tests, OR is a *.workers.dev / *.pages.dev host) → published in subs/<protocol>/rotating.txt with 🌐 ROTATING label
  • Dead → not published

Install

VlessFilter is a single Go binary. Two install paths, pick whichever:

Option 1: go install (requires Go 1.26+)

go install github.com/trikiman/vlessfilter/cmd/vlessfilter@latest

Binary lands in $GOPATH/bin (or $HOME/go/bin). Make sure that's on your $PATH.

Option 2: From source

git clone https://github.com/trikiman/vlessfilter.git
cd vlessfilter
go build -o bin/vlessfilter ./cmd/vlessfilter

Verify it works

vlessfilter --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/

Configuration

Edit sources.yaml to add or remove subscription sources. See comments in the file for the schema.

Off-PC Deployment

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.

What each run does

  1. Stage 1 — alive/handshake check. High-concurrency TLS handshake against the pool; dead keys are dropped.
  2. Stage 2 — speed connection test. Survivors get a real-proxy speedtest, run 3 separate times, to measure throughput (Mbps) and latency (ms).
  3. 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).

Option A: GitHub Actions (PRIMARY — recommended)

Cost: $0 (public repos get unlimited Actions minutes). Setup: ~5 min. Always-on: yes.

  1. Create a GitHub account (any throwaway email; no card needed for free-tier Actions on public repos).
  2. Fork https://github.com/trikiman/vlessfilter.
  3. Generate a PAT (Settings → Developer settings → Fine-grained tokens): repository access = your results repo, Permissions → Contents = Read and write.
  4. In the repo: Settings → Secrets and variables → Actions → new secret PUSH_TOKEN = the PAT.
  5. Enable Actions: Settings → Actions → General → Allow all.
  6. 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.

Option B: h2.nexus 15-minute ephemeral VPS (manual fallback, no signup)

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_xxx

Results push automatically; the VM auto-deletes at 15 min. Manual trigger only (no schedule), reduced run scope to fit the window.

Option C: Termux on Android (manual fallback)

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_xxx

cron 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.

Which to pick

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.

VLESS — top 3 per country (stable only)

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

VMESS — top 3 per country (stable only)

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

TROJAN — top 3 per country (stable only)

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

SS — top 3 per country (stable only)

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.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages