README
¶
go-transproxy-light
Transparent proxy servers for HTTP, HTTPS, SSH etc. with some limitation. This repository is heavily under development.
Description
go-transproxy-light provides transparent proxy servers for HTTP, HTTPS, SSH etc. with single binary.
This is not true transparent proxy becasuse you need to change your DNS server setting.
However, it works not only on Linux but also on Windows because it doesn't use iptables.
Limitation
There are some limitation compared to go-transporxy.
- Direct access with IP address cannot be proxied transparently. It supports FQDN access only!
- Your proxy server needs to support CONNECT method for any ports.
- Application which has own DNS cache might cause trouble.
Install
Binary install
Download from Releases page.
Source install
Use Go 1.9 and dep.
dep ensure
go build -o transproxy-light cmd/transproxy-light/main.go
chmod +x transproxy-light
Usage
Usage:
transproxy-light [options]
Options:
-dns string
DNS servers for no_proxy targets (IP[:port],IP[:port],...)
-loglevel string
Log level, one of: debug, info, warn, error, fatal, panic (default "info")
-loopback-address-range 127.0.1.0-127.0.255.255
Range of local IP address, as 127.0.1.0-127.0.255.255 (default "127.0.1.0-127.0.255.255")
-port port1,port2,...
Listen ports for transparent proxy, as port1,port2,... (default "80,443,22")
Proxy configuration is used from standard environment variables, http_proxy and no_proxy.
Note: You can contain Suffix or Full Domain Name only in no_proxy.
Also, it supports TOML config too. You need to create a config file as config.toml into the directory which contains transproxy-light binary. Please see examples.
Examples
Linux
# Set your proxy environment
export http_proxy=http://foo:bar@yourproxy.example.org:3128
# Set no_proxy if you need to access directly for internal
export no_proxy=.example.org
# Start go-transproxy-light with admin privileges(sudo)
sudo -E transproxy-light -dns 192.168.0.100
Or, create config.toml as follows into the transproxy-light's directory and execute transproxy-light simply.
ProxyURL = "http://foo:bar@yourproxy.example.org:3128"
NoProxy = [
".example.org",
]
Port = [
22,
80,
443,
]
LogLevel = "error"
DNS = [
"192.168.0.100"
]
Then, you need to change your DNS server for using DNS proxy server of the transproxy-light.
For example, change your /etc/resolv.conf as follows.
nameserver 127.0.0.1
Now, you can access to 80, 443 and 22 port transparently.
curl http://www.google.com
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>302 Moved</TITLE></HEAD><BODY>
<H1>302 Moved</H1>
The document has moved
<A HREF="http://www.google.co.jp/?gfe_rd=cr&dcr=0&ei=GCKtWbD0AaLEXuTmr7gK">here</A>.
</BODY></HTML>
Windows
# Set your proxy environment
set http_proxy=http://foo:bar@yourproxy.example.org:3128
# Set no_proxy if you need to access directly for internal
set no_proxy=.example.org
# Start go-transproxy-light
transproxy-light.exe
Or, create config.toml as follows into the transproxy-light's directory and execute transproxy-light.exe simply.
ProxyURL = "http://foo:bar@yourproxy.example.org:3128"
NoProxy = [
".example.org",
]
Port = [
22,
80,
443,
]
LogLevel = "error"
Note: You don't need to set -dns or DNS on windows because it is resolved by transparent-light (Windows only).
Also, you don't need to change your DNS server on Windows because transproxy-light set 127.0.0.1 as DNS server in your network config.
Caution: Unfortunately the DNS server setting remains if you stop transproxy-light by closig the CMD window or killing the process. If you stop it by CTRL + c, the DNS server setting will be restored.
Now, you can access to 80, 443 and 22 port transparently.
Licence
Licensed under the MIT license.
Author
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DNSProxy ¶
type DNSProxy struct {
DNSProxyConfig
// contains filtered or unexported fields
}
func NewDNSProxy ¶
func NewDNSProxy(c DNSProxyConfig) *DNSProxy
type DNSProxyConfig ¶
type PassThroughProxy ¶
type PassThroughProxy struct {
PassThroughProxyConfig
}
func NewPassThroughProxy ¶
func NewPassThroughProxy(c PassThroughProxyConfig) *PassThroughProxy
func (*PassThroughProxy) GetListenPort ¶
func (s *PassThroughProxy) GetListenPort() int
func (*PassThroughProxy) GetType ¶
func (s *PassThroughProxy) GetType() string
func (*PassThroughProxy) Start ¶
func (s *PassThroughProxy) Start() error
func (*PassThroughProxy) Stop ¶
func (s *PassThroughProxy) Stop()
type PassThroughProxyConfig ¶
type Transproxy ¶
type Transproxy struct {
TransproxyConfig
// contains filtered or unexported fields
}
func NewTransproxy ¶
func NewTransproxy(c TransproxyConfig) *Transproxy
func (*Transproxy) Start ¶
func (s *Transproxy) Start() error
func (*Transproxy) Stop ¶
func (s *Transproxy) Stop()
Source Files
Directories