🚀 Proxine

_{🇬🇧 English ·
🇹🇷 Türkçe ·
🇷🇺 Русский ·
🇩🇪 Deutsch ·
🇯🇵 日本語 ·
🇪🇸 Español ·
🇸🇦 العربية ·
🇨🇳 中文}

🚀 Proxine

Open-source proxy list aggregator. A single command fetches HTTP / HTTPS / SOCKS4 / SOCKS5 proxies from dozens of public sources in parallel, automatically drops stale sources, deduplicates, validates, and emits a clean sorted IP:PORT list.

86 unique sources · 220 endpoints
HTTP: 72 · HTTPS: 48 · SOCKS4: 49 · SOCKS5: 51

Proxine is an aggregator, not a quality checker. For working, truly elite proxies, pipe its output into a tester like Proxy Profiler.

Features

86 distinct sources, 220 endpoints — GitHub raw lists + 8 dynamic API/HTML feeds.
Parallel HTTP fetch — default is polite (-c 1); raise to -c 20+ for ~10× speedup.
Per-source timeout + retry — a slow host can't stall the whole run.
Freshness tracking. Each source's last update is reported; GitHub commit times are resolved via the API. -F SECONDS filters out stale sources (default 24 h).
Strict validation. IPv4 octets (0–255) and ports (1–65535) checked with a hardened regex.
Smart output. TTY progress bar; silent in pipes; ASCII status tables; -s for full quiet; -o to write a file.
Zero dependencies. Python ≥ 3.10 stdlib only.

Installation

git clone https://github.com/enseitankado/proxine.git
cd proxine
chmod +x proxine.py
./proxine.py --help

Requirement: Python ≥ 3.10. Optional: gh CLI or a GitHub personal access token (to resolve source ages — see below).

Usage

./proxine.py -p <http|https|socks4|socks5> [options]

Flags

Long	Short	Default	Description
`--protocol`	`-p`	—	Required. Protocol to collect: `http`, `https`, `socks4`, `socks5`.
`--format`	`-f`	`ip-port`	Output format. `url` produces `<proto>://IP:PORT`.
`--timeout`	`-t`	`15`	Per-source HTTP timeout (seconds).
`--concurrency`	`-c`	`1`	Number of parallel requests. Higher = faster + more sockets.
`--retries`	`-r`	`2`	Retry attempts per failed source.
`--max-ports`	`-m`	`5`	Drop an IP entirely if it appears on more than N distinct ports (port-scanner/honeypot filter). `0` disables.
`--fresh`	`-F`	`86400`	Drop sources older than this many seconds. `0` disables the filter.
`--github-token`	`-g`	—	GitHub PAT. Falls back to `$GITHUB_TOKEN`, then `gh auth token`.
`--output`	`-o`	—	Write the proxy list to FILE; stdout stays empty.
`--lang`	`-L`	auto	UI language: `tr`, `en`, `de`, `es`, `ru`, `zh`. Otherwise auto-detected from `$PROXINE_LANG`/`$LANG`/locale.
`--strict-ports` / `--no-strict-ports`	—	on	Drop proxies whose port doesn't match the declared protocol family (e.g. a SOCKS-declared proxy on port 80 is dropped).
`--silent`	`-s`	—	Suppress all stderr output.

Examples

# HTTPS proxies to stdout (default freshness filter: 24h)
./proxine.py -p https

# SOCKS5 list to a file, faster
./proxine.py -p socks5 -c 32 -o socks5.lst

# Only sources updated in the last hour
./proxine.py -p http -F 3600

# URL-style output: socks5://1.2.3.4:1080
./proxine.py -p socks5 -f url

# Silent mode — ideal for pipelines
./proxine.py -p http -s | grep '^192\.'

# Chain with Proxy Profiler — 3 examples
# 1) Extract Elite (L1) anonymous HTTP proxies
./proxine.py -p http -s | python3 ~/proxy-profiler/proxyprof.py -p http -l 1 -o elite_http.lst

# 2) SOCKS5 — skip judge (fast), keep only Cloudflare-WAF-bypassing live proxies
./proxine.py -p socks5 -s | python3 ~/proxy-profiler/proxyprof.py -p socks5 --no-judge --access-test cloudflare -o cf_socks5.lst

# 3) HTTPS — elite + country filter (US/DE/JP) + Google access test
./proxine.py -p https -s | python3 ~/proxy-profiler/proxyprof.py -p https -l 1 --country US,DE,JP --access-test google -o elite_us_de_jp_https.lst

GitHub token (optional but recommended)

GitHub raw URLs don't expose Last-Modified, so source ages are resolved via the GitHub API. The anonymous limit is 60 requests/hour; one run hits 50+ GitHub URLs, so without a token most ages show as "LIVE". With a token the limit is 5,000 requests/hour — no repo scope needed, public read is enough.

Three ways — Proxine picks the first available:

# 1) Explicit flag
./proxine.py -p socks5 -g ghp_xxx

# 2) Environment variable
export GITHUB_TOKEN=ghp_xxx
./proxine.py -p socks5

# 3) Nothing — if `gh` CLI is installed and authenticated
./proxine.py -p socks5

If the token is rate-limited or invalid, a clear warning is shown at the end.

Output

1. Progress bar

During the run, two phases on stderr:

[████████████░░░░░░░░]  60%  24/43  fetching  ✓ github.com/komutan234/Proxy-List-Free  +10,794  total 69,749
[██████████████████░░]  90%  18/20  enriching ✓ github.com/Mohammedcha/ProxRipper                total 309,478

20-character █/░ bar, percentage, done/total
Phase label: fetching (HTTP) or enriching (GitHub commit API)
✓ success, x failure
+N new proxies from this source
total N accumulated unique total

Automatically silent off-TTY (won't pollute redirected output).

2. Source status table

At the end, on stderr:

┌────────┬──────┬─────────┬─────────────────────────────────────────────────┐
│ STATUS │  AGE │ PROXIES │ SOURCE                                          │
├────────┼──────┼─────────┼─────────────────────────────────────────────────┤
│ OK     │  26s │  24,769 │ github.com/ebrasha/abdal-proxy-hub              │
│ OK     │  88s │   9,322 │ api.proxyscrape.com                             │
│ ...                                                                       │
│ LIVE   │    — │       2 │ pubproxy.com                                    │
│ STALE  │  47w │  89,708 │ github.com/MuRongPIG/Proxy-Master               │
│ FAIL   │    — │       — │ www.socks-proxy.net                             │
└────────┴──────┴─────────┴─────────────────────────────────────────────────┘
  OK     fresh within `--fresh` window; proxies kept
  LIVE   no age info (dynamic API); proxies kept
  STALE  older than `--fresh`; proxies dropped from output
  FAIL   fetch error; no contribution

Sort order: OK (freshest first) → LIVE → STALE → FAIL.

3. Summary box

┌──────────┬─────────────────────────────────────────────┐
│ protocol │ socks5                                      │
│ proxies  │ 205,978 unique  →  /tmp/p.lst               │
│ sources  │ 43 total  (30 ok, 1 live, 12 stale, 0 fail) │
│ elapsed  │ 33.8s                                       │
└──────────┴─────────────────────────────────────────────┘

Output mode matrix

Command	stdout	stderr
`proxine -p http`	proxy list	per-source log + progress → status table → summary
`proxine -p http -o f.lst`	(empty)	per-source log + progress → tables
`proxine -p http -s`	proxy list	(empty)
`proxine -p http -o f.lst -s`	(empty)	(empty)

Sources

A total of 86 unique sources, 220 protocol endpoints. All defined in sources.py; adding a new source is a one-line change.

GitHub raw lists (77 repos)

Repo	Protocols
`abusaeeidx/TazaProxy-Troxy`	https
`adasd223/global-proxy-list`	socks5
`ahahaabas/anonymous-proxy-list-free`	http, socks4, socks5
`ahahaabas/global-proxy-list`	socks5
`ALIILAPRO/Proxy`	http, socks4, socks5
`alphaa1111/proxyscraper`	http, socks4, socks5
`Anonym0usWork1221/Free-Proxies`	http, https, socks5
`anutmagang/Free-HighQuality-Proxy-Socks`	http
`Argh94/Proxy-List`	http, socks4
`Argh94/ProxyProwler`	socks4, socks5
`arunsakthivel96/proxyBEE`	http, https
`b4mbo-o/Check-Free-Proxy`	socks4
`berkay-digital/Proxy-Scraper`	http
`CB-X2-Jun/proxy-lists`	http, https, socks4, socks5
`Cheagjihvg/simple-proxylist`	http, https, socks4, socks5
`claude89757/free_https_proxies`	https
`databay-labs/free-proxy-list`	http, socks4, socks5
`dpangestuw/Free-Proxy`	http
`elliottophellia/yakumo`	socks4, socks5
`ErcinDedeoglu/proxies`	https
`fate0/proxylist`	http, https
`Firmfox/Proxify`	socks5
`gitrecon1455/fresh-proxy-list`	https, socks4, socks5
`HankNovic/ProxyClean`	socks5
`hookzof/socks5_list`	socks5
`i-am-unbekannt/BLITZPROXY`	http, socks4, socks5
`iplocate/free-proxy-list`	http, https, socks4
`IPParrot/proxy_ips`	http, https, socks4, socks5
`ItzRazvyy/ProxyList`	http, https, socks4, socks5
`jetkai/proxy-list`	http, https, socks4, socks5
`LoneKingCode/free-proxy-db`	http, https, socks4
`mauricegift/free-proxies`	http, https, socks5
`mertguvencli/http-proxy-list`	http, https
`MohammadKobirShah/ProxyScraper-Pro`	http, socks4, socks5
`monosans/proxy-list`	http, https, socks4, socks5
`MrMarble/proxy-list`	https
`Munachukwuw/Best-Free-Proxys`	http, socks4, socks5
`mzyui/proxy-list`	http
`naravid19/checked-proxies`	http, socks4, socks5
`NikolaiT/free-proxy-list`	http, https, socks4, socks5
`noctiro/getproxy`	socks4
`officialputuid/ProxyForEveryone`	http, socks4, socks5
`openproxyhub/proxy-exports`	socks5
`parserpp/ip_ports`	http, https
`proxifly/free-proxy-list`	http, https, socks4, socks5
`proxygenerator1/ProxyGenerator`	http, https, socks4, socks5
`prxchk/proxy-list`	http, socks4, socks5
`r00tee/Proxy-List`	https, socks4
`rdavydov/proxy-list`	http, socks4, socks5
`RioMMO/ProxyFree`	http
`roosterkid/openproxylist`	https, socks4, socks5
`RX4096/proxy-list`	http, https
`rx443/proxy-list`	http, https
`saisuiu/uiu`	http
`Seeh-Saah/awesome-free-proxy-list`	http, socks4, socks5
`SevenworksDev/proxy-list`	https, socks4
`shiftytr/proxy-list`	https
`shubhamshendre/Free-Proxies`	http
`shulganovo/Proxylists`	socks5
`Skillter/ProxyGather`	http, socks4, socks5
`SoliSpirit/proxy-list`	socks4
`stamparm/aux`	http
`sunny9577/proxy-scraper`	http, https
`themiralay/Proxy-List-World`	http
`theriturajps/proxy-list`	https, socks4, socks5
`TheSpeedX/PROXY-List`	http, socks4, socks5
`Thordata/awesome-free-proxy-list`	http, socks4, socks5
`Tsprnay/Proxy-lists`	http, https, socks4, socks5
`TuanMinPay/live-proxy`	https
`vakhov/fresh-proxy-list`	https, socks4, socks5
`Vann-Dev/proxy-list`	socks4, socks5
`VPSLabCloud/VPSLab-Free-Proxy-List`	http, https, socks4, socks5
`watchttvv/free-proxy-list`	http, https
`yemixzy/free-proxy-list`	http, socks4, socks5
`Zaeem20/FREE_PROXIES_LIST`	http, https, socks4, socks5
`zevtyardt/proxy-list`	socks4, socks5
`zloi-user/hideip.me`	http, https, socks4, socks5

GitLab lists (1 repo)

Repo	Protocols
`gitlab.com/syedusama5556/auto-proxy-list-generator`	http

Dynamic API and HTML sources (8 endpoints)

Endpoint	Kind	Protocols
`api.proxyscrape.com`	Public API	http, https, socks4, socks5
`free-proxy-list.net`	HTML scraper	http
`proxyspace.pro`	Plain-text list	https, socks5
`pubproxy.com`	Public API	http, https, socks4, socks5
`www.google-proxy.net`	HTML scraper	http, https
`www.ipaddress.com`	HTML scraper	http, https
`www.socks-proxy.net`	HTML scraper	socks4
`www.sslproxies.org`	HTML scraper	https

Automation

Proxine is designed for one-shot runs; wrap it with cron / systemd-timer / GitHub Actions for scheduled updates. For pipelines, -s and -o are recommended:

# Cron: update the SOCKS5 list every hour
0 * * * * cd ~/proxine && ./proxine.py -p socks5 -s -o /var/lib/proxies/socks5.lst

# Nightly elite-HTTP build (proxine + profiler chain)
0 3 * * * cd ~/proxine && ./proxine.py -p http -s | python3 ~/proxy-profiler/proxyprof.py -p http -l 1 -o /var/lib/proxies/elite_http.lst

Related tools

Proxy Profiler — multi-threaded tester for liveness, anonymity (Elite/Anonymous/Transparent), CloudFlare and Google pass-through.
EliteProxySwitcher — GUI proxy rotator for Windows.
Open Proxy Checker — Windows list verifier.

License

Open source. You may redistribute, modify, and use it commercially or privately. Keep the original author attribution (Özgür Koca) in derivative work. Software is provided "as is"; all usage risk is on the user.

Author

Özgür Koca — teacher at a vocational school. GitHub: enseitankado · Blog: tankado.com

Support

If you find this useful, leave a ⭐. Want to buy me a coffee? Here you go.

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.gitignore		.gitignore
README.ar.md		README.ar.md
README.de.md		README.de.md
README.es.md		README.es.md
README.ja.md		README.ja.md
README.md		README.md
README.ru.md		README.ru.md
README.tr.md		README.tr.md
README.zh.md		README.zh.md
http.lst		http.lst
https.lst		https.lst
i18n.py		i18n.py
proxine.py		proxine.py
pyproject.toml		pyproject.toml
socks4.lst		socks4.lst
socks5.lst		socks5.lst
sources.py		sources.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🚀 Proxine

Features

Installation

Usage

Flags

Examples

GitHub token (optional but recommended)

Output

1. Progress bar

2. Source status table

3. Summary box

Output mode matrix

Sources

GitHub raw lists (77 repos)

GitLab lists (1 repo)

Dynamic API and HTML sources (8 endpoints)

Automation

Related tools

License

Author

Support

About

Uh oh!

Releases

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

🚀 Proxine

Features

Installation

Usage

Flags

Examples

GitHub token (optional but recommended)

Output

1. Progress bar

2. Source status table

3. Summary box

Output mode matrix

Sources

GitHub raw lists (77 repos)

GitLab lists (1 repo)

Dynamic API and HTML sources (8 endpoints)

Automation

Related tools

License

Author

Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages