https://github.com/getlantern/enproxy
Chained HTTP proxy that supports arbitrary TCP traffic tunneled over HTTP proxies using encapsulated HTTP requests
https://github.com/getlantern/enproxy
Last synced: 8 months ago
JSON representation
Chained HTTP proxy that supports arbitrary TCP traffic tunneled over HTTP proxies using encapsulated HTTP requests
- Host: GitHub
- URL: https://github.com/getlantern/enproxy
- Owner: getlantern
- License: apache-2.0
- Created: 2014-06-01T13:47:57.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2018-09-13T19:17:38.000Z (almost 8 years ago)
- Last Synced: 2024-10-29T09:02:48.729Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 238 KB
- Stars: 49
- Watchers: 22
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
enproxy [](https://travis-ci.org/getlantern/enproxy) [](https://coveralls.io/r/getlantern/enproxy) [](http://godoc.org/github.com/getlantern/enproxy)
==========
enproxy provides an implementation of net.Conn that sends and receives data to/
from a proxy using HTTP request/response pairs that encapsulate the data. This
is useful when you need to tunnel arbitrary protocols over an HTTP proxy that
doesn't support HTTP CONNECT. Content distribution networks are one example of
such a proxy.
To open such a connection:
```go
conn := &enproxy.Conn{
Addr: addr,
Config: &enproxy.Config{
DialProxy: func(addr string) (net.Conn, error) {
// This opens a TCP connection to the proxy
return net.Dial("tcp", proxyAddress)
},
NewRequest: func(method string, body io.Reader) (req *http.Request, err error) {
// This is called for every request from enproxy.Conn to the proxy
return http.NewRequest(method, "http://"+proxyAddress+"/", body)
},
},
}
err := conn.Connect()
if err == nil {
// start using conn as any other net.Conn
}
```
To start the corresponding proxy server:
```go
proxy := &enproxy.Proxy{}
err := proxy.ListenAndServe(proxyAddress)
if err != nil {
log.Fatalf("Unable to listen and serve: %s", err)
}
```
## Debugging
enproxy allows tracing various global metrics about connections, which can be
useful when debugging issues like file descriptor leaks. To enable this tracing,
just set the environment variable `TRACE_CONN_STATE=true`. This will cause the
program to output information like the below every 5 seconds:
```
---- Enproxy Connections----
Open: 34
Closing: 0
Blocked on Closing: 0
Blocked on Read: 33
Reading: 33
Reading Finishing: 0
Blocked on Write: 0
Writing: 33
Selecting: 33
Writing: 0
Write Pipe Open: 0
Request Pending: 0
Submitting Req.: 0
Processing Req.: 1
Posting Req. Fin: 0
Posting Resp: 0
Dialing First: 0
Redialing: 0
Doing Write: 0
Posting Response: 0
Writing Empty: 0
Finishing Body: 0
Finishing: 0
Requesting: 33
Requesting Finishing: 0
```