Repository files navigation

SOCKS 5

Report Bug |Request Feature

A fully featured implementation of the SOCKS 5 protocol in golang.

CONNECT	BIND	UDP ASSOCIATE
✅ - implemented	🛠 - in progress	✅ - implemented

go get github.com/ezh0v/socks5

Create your.go file. For example:main.go.

package mainimport ("context""log""os/signal""syscall""github.com/ezh0v/socks5")funcmain() {ctx,stop:=signal.NotifyContext(context.Background(),syscall.SIGINT,syscall.SIGTERM)deferstop()srv:=socks5.New()gofunc() {iferr:=srv.ListenAndServe();err!=nil {log.Fatal(err)}}()<-ctx.Done()iferr:=srv.Shutdown();err!=nil {log.Fatal(err)}}

Run your server:

go run main.go

The following curl example shows how to use the proxy server:

curl -x socks5://127.0.0.1:1080 http://example.com

See thetests andexamples for more information about package.

• Why can't connect to socks proxy server?

  Not all applications and browsers support socks authentication or socks protocol. You may needextension for Chrome or another browser.

If you have any questions, you can ask inGitHub Discussions.

• The proof of work for the UDP association was done usingqBittorrent - a BitTorrent client.

Feel free to open tickets or send pull requests with improvements. Thanks in advance for your help!

Please follow thecontribution guidelines.

• RFC 1928 SOCKS Protocol Version 5
• RFC 1929 Username/Password Authentication for SOCKS V5

• All source code is licensed under theMIT License.

• Logo is based on the Go Gopher mascot originally designed byEgon Elbre and which is also licensed under theCC0 1.0 Universal License.