Go to file
2020-08-06 15:06:33 +08:00
_example fix 2020-08-06 11:11:30 +08:00
_testing fix content 2020-08-06 15:06:33 +08:00
.github/workflows fix ci 2020-08-05 14:47:08 +08:00
bufferpool add associate test 2020-08-06 14:31:36 +08:00
ccsocks5 fix content 2020-08-06 15:06:33 +08:00
statute use buffer pool interface 2020-08-06 10:12:46 +08:00
.gitignore use buffer pool interface 2020-08-06 10:12:46 +08:00
.travis.yml fix ci 2020-08-05 14:47:08 +08:00
auth_test.go add more test 2020-08-05 14:40:07 +08:00
auth.go add more test 2020-08-05 14:40:07 +08:00
credentials_test.go add more test 2020-08-05 14:40:07 +08:00
credentials.go add more test 2020-08-05 14:40:07 +08:00
go.mod add header test 2020-08-05 10:34:29 +08:00
go.sum add header test 2020-08-05 10:34:29 +08:00
handle_test.go add associate test 2020-08-06 14:31:36 +08:00
handle.go fix 2020-08-06 11:11:30 +08:00
LICENSE Initial commit 2014-01-22 15:49:51 -08:00
logger.go add user handle 2020-04-22 10:15:40 +08:00
option.go add associate test 2020-08-06 14:31:36 +08:00
README.md fix 2020-08-06 11:11:30 +08:00
resolver_test.go add more test 2020-08-05 14:40:07 +08:00
resolver.go add user handle 2020-04-22 10:15:40 +08:00
revive.sh revive inspect 2020-04-22 10:32:03 +08:00
revive.toml revive inspect 2020-04-22 10:32:03 +08:00
ruleset_test.go fix request/response statute 2020-08-05 18:10:50 +08:00
ruleset.go add more test 2020-08-05 14:40:07 +08:00
server_test.go add associate test 2020-08-06 14:31:36 +08:00
server.go add associate test 2020-08-06 14:31:36 +08:00

go-socks5

Build Status Go.Dev reference codecov Action Status Go Report Card License Tag

Provides the socks5 package that implements a SOCKS5 server. SOCKS (Secure Sockets) is used to route traffic between a client and server through an intermediate proxy layer. This can be used to bypass firewalls or NATs.

Feature

The package has the following features:

  • Unit tests
  • "No Auth" mode
  • User/Password authentication optional user addr limit
  • Support for the CONNECT command
  • Support for the ASSOCIATE command
  • Rules to do granular filtering of commands
  • Custom DNS resolution
  • Custom goroutine pool
  • buffer pool design and optional custom buffer pool
  • Custom logger

TODO

The package still needs the following:

  • Support for the BIND command

Example

Below is a simple example of usage

// Create a SOCKS5 server
server := socks5.NewServer()

// Create SOCKS5 proxy on localhost port 8000
if err := server.ListenAndServe("tcp", ":8000"); err != nil {
  panic(err)
}

Reference