YGGverse/psocks
1
0
Fork 0
mirror of https://codeberg.org/YGGverse/psocks.git synced 2026-03-31 16:35:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
psocks/README.md
postscriptum 0b6b0ebd0e update api cmd example
2026-03-22 09:20:10 +02:00

1.1 KiB
Raw Blame History

psocks

Experimental async SOCKS5 (TCP/UDP) proxy server based on fast-socks5, featuring allowlist-based access control (drop everything but allowed by user) with JSON/API based on Rocket framework.

Roadmap

  • Range support
  • Local Web-API
    • Block stats
    • In-memory list update (without server restart)
      • Persist changes option
    • Performance optimization

Usage

RUST_LOG=psocks=trace cargo run -- -a=/path/to/allow1.txt \
                                   -a=http://localhost/allow2.txt \
                                   no-auth
  • set socks5://127.0.0.1:1080 proxy in your application
  • open http://127.0.0.1:8010 in browser for global stats:
    • /allow/domain.com - add rule to the current session
    • /block/domain.com - delete rule from the current session

Allow list example

# /path/to/allow1.txt

// exact match
duckduckgo.com

// google.com with subdomains
.google.com

// IP resolved
1.2.3.4