Go to file
2022-05-22 18:21:57 -07:00
.github Create dependabot.yml 2021-11-16 22:09:49 -08:00
example Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
.gitignore Update .gitignore 2022-05-10 23:17:21 -07:00
conductor.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
daemons.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
debug.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
defs.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
dispense.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
getters.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
go.mod Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
go.sum Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
LICENSE Add: SetStaleTime, GetStaleTime, GetMaxWorkers 2021-09-13 09:32:07 -07:00
list_management.go Name change 2022-05-22 18:05:50 -07:00
mr_worldwide.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
mystery_dialer.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
Prox5.gif Fix gif 2021-10-09 10:50:17 -07:00
proxy_server.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
README.md Update badges 2022-05-22 18:21:36 -07:00
setters.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
socks5_server.go Name change 2022-05-22 18:05:50 -07:00
stats.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00
util.go Name change 2022-05-22 18:05:50 -07:00
validator_engine.go Bring back dev changes from repo mishap 2022-05-22 18:20:40 -07:00

Prox5

GoDoc Go Report Card IRC

SOCKS5/4/4a validating proxy pool + server

Prox5 is a golang library for managing, validating, and accessing thousands upon thousands of arbitrary SOCKS proxies.

Notably it features interface compatible dialer functions that dial out from different proxies for every connection, and a SOCKS5 server that utilizes those functions.


Initial validation sequence

  • TCP Dial to the endpoint
  • HTTPS GET request to a list of IP echo endpoints

Prox5 will then store the endpoint's outward appearing IP address and mark it as valid for use.

Accessing validated proxies

  • Retrieve validated 4/4a/5 proxies as simple strings for generic use
  • Use one of the dialer functions with any golang code that calls for a net.Dialer
  • Spin up a SOCKS5 server that will then make rotating use of your validated proxies

The way you choose to use this lib is yours. The API is fairly extensive for you to be able to customize runtime configuration without having to do any surgery.

Things like the amount of validation workers that are concurrently operating, timeouts, and proxy re-use policies may be tuned in real-time. please read the docs.


This project is in development.

It "works" and has been used in "production", but still needs some love.

Please break it and let me know what broke.

See the docs and the example for more details.