README
¶
kahlys/proxy
Simple tcp proxy package and executable binary in Golang.
⚠ This code is for test purpose, it is sometimes ugly, it is not production ready, and the API will probably change. ⚠
Installation
With a correctly configured Go toolchain:
$ git clone github.com/kahlys/proxy/
$ cd proxy
$ go install cmd/tcpproxy/*.go
Example
The example executable provides both TCP and TCP/TLS connection: cmd/tcpproxy/main.go
By default, the proxy address is localhost:4444 and the target address is localhost:80.
$ tcpproxy
2018/12/13 17:10:25 Proxying from :4444 to :80
You can specify some options.
$ tcpproxy -help
Usage of tcpproxy:
-lcert string
certificate file for proxy server side
-lhost string
proxy local address (default ":4444")
-lkey string
key x509 file for proxy server side
-ltls
tls/ssl between client and proxy, you must set 'lcert' and 'lkey'
-rcert string
certificate file for proxy client side
-rhost string
proxy remote address (default ":80")
-rkey string
key x509 file for proxy client side
-rtls
tls/ssl between proxy and target, you must set 'rcert' and 'rkey'
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Server ¶
type Server struct {
// TCP address to listen on
Addr string
// TCP address of target server
Target string
// ModifyRequest is an optional function that modifies the request from a client to the target server.
ModifyRequest func(b *[]byte)
// ModifyResponse is an optional function that modifies the response from the target server.
ModifyResponse func(b *[]byte)
// TLS configuration to listen on.
TLSConfig *tls.Config
// TLS configuration for the proxy if needed to connect to the target server with TLS protocol.
// If nil, TCP protocol is used.
TLSConfigTarget *tls.Config
}
Server is a TCP server that takes an incoming request and sends it to another server, proxying the response back to the client.
func (*Server) ListenAndServe ¶
ListenAndServe listens on the TCP network address laddr and then handle packets on incoming connections.
func (*Server) ListenAndServeTLS ¶
ListenAndServeTLS acts identically to ListenAndServe, except that it uses TLS protocol. Additionally, files containing a certificate and matching private key for the server must be provided if neither the Server's TLSConfig.Certificates nor TLSConfig.GetCertificate are populated.
Source Files
Directories