https://github.com/armon/go-proxyproto

Golang package to handle HAProxy Proxy Protocol
https://github.com/armon/go-proxyproto

Last synced: 3 days ago
JSON representation

Golang package to handle HAProxy Proxy Protocol

• Host: GitHub
• URL: https://github.com/armon/go-proxyproto
• Owner: armon
• License: mit
• Created: 2014-03-08T00:43:46.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2023-11-06T17:55:38.000Z (about 1 year ago)
• Last Synced: 2025-01-05T08:10:18.514Z (10 days ago)
• Language: Go
• Size: 14.6 KB
• Stars: 199
• Watchers: 9
• Forks: 53
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-network-stuff - **161**星

README

        
# proxyproto

This library provides the `proxyproto` package which can be used for servers

listening behind HAProxy of Amazon ELB load balancers. Those load balancers

support the use of a proxy protocol (http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt),

which provides a simple mechansim for the server to get the address of the client

instead of the load balancer.

This library provides both a net.Listener and net.Conn implementation that

can be used to handle situation in which you may be using the proxy protocol.

Only proxy protocol version 1, the human-readable form, is understood.

The only caveat is that we check for the "PROXY " prefix to determine if the protocol

is being used. If that string may occur as part of your input, then it is ambiguous

if the protocol is being used and you may have problems.

# Documentation

Full documentation can be found [here](http://godoc.org/github.com/armon/go-proxyproto).

# Examples

Using the library is very simple:

```

// Create a listener

list, err := net.Listen("tcp", "...")

// Wrap listener in a proxyproto listener

proxyList := &proxyproto.Listener{Listener: list}

conn, err :=proxyList.Accept()

...

```