From b7d1085500843d8f901ec5e74a29e60130d3fded Mon Sep 17 00:00:00 2001 From: "arraykeys@gmail.com" Date: Wed, 27 Sep 2017 17:35:29 +0800 Subject: [PATCH] Signed-off-by: arraykeys@gmail.com --- README.md | 348 +++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 237 insertions(+), 111 deletions(-) diff --git a/README.md b/README.md index b037aee..7f6d4e7 100644 --- a/README.md +++ b/README.md @@ -4,93 +4,19 @@ Proxy是golang实现的高性能http,https,websocket,tcp,udp代理服务器,支 --- [![stable](https://img.shields.io/badge/stable-stable-green.svg)](https://github.com/snail007/goproxy/) [![license](https://img.shields.io/github/license/snail007/goproxy.svg?style=plastic)]() [![download_count](https://img.shields.io/github/downloads/snail007/goproxy/total.svg?style=plastic)](https://github.com/snail007/goproxy/releases) [![download](https://img.shields.io/github/release/snail007/goproxy.svg?style=plastic)](https://github.com/snail007/goproxy/releases) - -### 0.生成加密通讯需要的证书文件 -http,tcp,udp代理过程会和上级通讯,为了安全我们采用加密通讯,当然可以选择不加密通信通讯,本教程所有和上级通讯都采用加密,需要证书文件. -在linux上并安装了openssl命令，可以直接通过下面的命令生成证书和key文件. -`./proxy keygen` -默认会使用程序相同目录下面的证书文件proxy.crt和key文件proxy.key。 -### 1.HTTP代理 -**1.1.普通HTTP代理** -`./proxy http -t tcp -p "0.0.0.0:38080"` -**1.2.普通二级HTTP代理,使用本地端口8090,假设上级HTTP代理是`22.22.22.22:8080`** -`./proxy http -t tcp -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" ` -默认开启了连接池,如果为了网络情况很好,-L可以关闭连接池,0就是连接池大小,0为关闭. -`./proxy http -t tcp -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" -L 0` -我们还可以指定网站域名的黑白名单文件,一行一个域名,怕匹配规则是最右批评匹配,比如:baidu.com,匹配的是*.*.baidu.com,黑名单的域名域名直接走上级代理,白名单的域名不走上级代理. -`./proxy http -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" -b blocked.txt -d direct.txt` -**1.3.HTTP二级代理(加密)** -一级HTTP代理(VPS,IP:22.22.22.22) -`./proxy http -t tls -p ":38080" -C proxy.crt -K proxy.key` -二级HTTP代理(本地) -`./proxy http -t tcp -p ":8080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` -那么访问本地的8080端口就是访问VPS上面的代理端口38080. -**1.4.HTTP三级代理(加密)** -一级HTTP代理VPS_01,IP:22.22.22.22 -`./proxy http -t tls -p ":38080" -C proxy.crt -K proxy.key` -二级HTTP代理VPS_02,IP:33.33.33.33 -`./proxy http -t tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` -三级HTTP代理(本地) -`./proxy http -t tcp -p ":8080" -T tls -P "33.33.33.33:28080" -C proxy.crt -K proxy.key` -那么访问本地的8080端口就是访问一级HTTP代理上面的代理端口38080. -**1.5.Basic认证** -对于代理HTTP协议我们可以basic进行Basic认证,认证的用户名和密码可以在命令行指定 -`./proxy http -t tcp -p ":33080" -a "user1:pass1" -a "user2:pass2"` -多个用户,重复-a参数即可. -也可以放在文件中,格式是一行一个"用户名:密码",然后用-F指定. -`./proxy http -t tcp -p ":33080" -F auth-file.txt` -如果没有-a或-F参数,就是关闭Basic认证. -**1.6.HTTP代理流量强制走上级HTTP代理** -默认情况下,proxy会智能判断一个网站域名是否无法访问,如果无法访问才走上级HTTP代理.通过--always可以使全部HTTP代理流量强制走上级HTTP代理. -`./proxy http --always -t tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` -**1.7.查看帮助** -`./proxy help http` -[图文教程](docs/faststart_v3.md) -### 2.TCP代理 -**1.普通一级TCP代理** -本地执行: -`./proxy tcp -p ":33080" -T tcp -P "192.168.22.33:22" -L 0` -那么访问本地33080端口就是访问192.168.22.33的22端口. -**2.普通二级TCP代理** -VPS(IP:22.22.22.33)执行: -`./proxy tcp -p ":33080" -T tcp -P "127.0.0.1:8080" -L 0` -本地执行: -`./proxy tcp -p ":23080" -T tcp -P "22.22.22.33:33080"` -那么访问本地23080端口就是访问22.22.22.33的8080端口. -**3.普通三级TCP代理** -一级TCP代理VPS_01,IP:22.22.22.22 -`./proxy tcp -p ":38080" -T tcp -P "66.66.66.66:8080"` -二级TCP代理VPS_02,IP:33.33.33.33 -`./proxy tcp -p ":28080" -T tcp -P "22.22.22.22:38080"` -三级TCP代理(本地) -`./proxy tcp -p ":8080" -T tcp -P "33.33.33.33:28080"` -那么访问本地8080端口就是通过加密TCP隧道访问66.66.66.66的8080端口. -**4.加密二级TCP代理** -VPS(IP:22.22.22.33)执行: -`./proxy tcp --tls -p ":33080" -T tcp -P "127.0.0.1:8080" -L 0 -C proxy.crt -K proxy.key` -本地执行: -`./proxy tcp -p ":23080" -T tls -P "22.22.22.33:33080" -C proxy.crt -K proxy.key` -那么访问本地23080端口就是通过加密TCP隧道访问22.22.22.33的8080端口. -**5.加密三级TCP代理** -一级TCP代理VPS_01,IP:22.22.22.22 -`./proxy tcp --tls -p ":38080" -T tcp -P "66.66.66.66:8080" -C proxy.crt -K proxy.key` -二级TCP代理VPS_02,IP:33.33.33.33 -`./proxy tcp --tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` -三级TCP代理(本地) -`./proxy tcp -p ":8080" -T tls -P "33.33.33.33:28080" -C proxy.crt -K proxy.key` -那么访问本地8080端口就是通过加密TCP隧道访问66.66.66.66的8080端口. -**1.x.查看帮助** -`./proxy help tcp` + ### Features -- 程序本身可以作为一级代理,如果设置了上级代理那么可以作为二级代理,乃至N级代理. -- 如果程序不是一级代理,而且上级代理也是本程序,那么可以加密和上级代理之间的通讯,采用底层tls高强度加密,安全无特征. -- 代理时会自动判断访问的网站是否屏蔽,如果被屏蔽那么就会使用上级代理(前提是配置了上级代理)访问网站;如果访问的网站没有被屏蔽,为了加速访问,代理会直接访问网站,不使用上级代理. -- 可以设置域名黑白名单，更加自由的控制网站的访问方式。 +- 链式代理,程序本身可以作为一级代理,如果设置了上级代理那么可以作为二级代理,乃至N级代理. +- 通讯加密,如果程序不是一级代理,而且上级代理也是本程序,那么可以加密和上级代理之间的通讯,采用底层tls高强度加密,安全无特征. +- 智能HTTP代理,会自动判断访问的网站是否屏蔽,如果被屏蔽那么就会使用上级代理(前提是配置了上级代理)访问网站;如果访问的网站没有被屏蔽,为了加速访问,代理会直接访问网站,不使用上级代理. +- 域名黑白名单，更加自由的控制网站的访问方式。 - 跨平台性,无论你是widows,linux,还是mac,甚至是树莓派,都可以很好的运行proxy. - +- 多协议支持,支持HTTP,TCP,UDP,Websocket代理. +- 支持反向代理也就是"内网穿透",协议支持TCP和UDP. + ### Why need these? 当由于安全因素或者限制,我们不能顺畅的访问我们在其它地方的服务,我们可以通过多个相连的proxy节点建立起一个安全的隧道,顺畅的访问我们的服务. - + ### Fast Start 提示:所有操作需要root权限. **0.如果你的VPS是linux64位的系统,那么只需要执行下面一句,就可以完成自动安装和配置.** @@ -122,36 +48,236 @@ wget https://raw.githubusercontent.com/snail007/goproxy/master/install.sh chmod +x install.sh ./install.sh ``` -### More... -**1、作为普通一级代理。** -默认监听0.0.0.0:33080端口，可以使用-p修改端口，-i修改绑定ip。 -默认情况 -`./proxy` -指定ip和端口 -`./proxy -i 192.168.1.100 -p 60080` - -**2、作为普通二级代理。** -可以通过-P指定上级代理，格式是IP:端口 -`./proxy -P "192.168.1.100:60080" -p 33080` - -**3、作为加密一级代理。** -加密模式的一级代理需要和加密的二级代理配合。 -加密模式需要证书和key文件，在linux上并安装了openssl命令，可以直接通过下面的命令生成证书和key文件。 + +## 使用教程 + +**提示** +接下来的教程,默认系统是linux,程序是proxy；所有操作需要root权限； +如果你的是windows,请使用windows版本的proxy.exe即可. + +### 0.生成加密通讯需要的证书文件 + +http,tcp,udp代理过程会和上级通讯,为了安全我们采用加密通讯,当然可以选择不加密通信通讯,本教程所有和上级通讯都采用加密,需要证书文件. +在linux上并安装了openssl命令，可以直接通过下面的命令生成证书和key文件. `./proxy keygen` -会在当前目录下面生成一个证书文件proxy.crt和key文件proxy.key。 -比如在你的vps上运行加密一级代理，使用参数-x即可，默认会使用程序相同目录下面的证书文件proxy.crt和key文件proxy.key。 -`./proxy -x` -或者使用-c和-k指定证书和key文件,ip和端口。 -`./proxy -x -c "proxy.crt" -k "proxy.key" -p 58080` - -**4、作为加密二级代理。** -加密模式的二级代理需要和加密的一级代理配合。加密模式的二级代理和加密模式的一级代理要使用相同的证书和key文件。 默认会使用程序相同目录下面的证书文件proxy.crt和key文件proxy.key。 -比如在你的windows电脑上允许二级加密代理,需要-P指定上级代理，同时设置-X代表是加密的上级代理。 -假设一级代理vps外网IP是：115.34.9.63。   -`./proxy.exe -X -P "115.34.9.63:58080" -c "proxy.crt" -k "proxy.key" -p 18080` -然后设置你的windos系统中，需要通过代理上网的程序的代理为http模式，地址为：127.0.0.1，端口为：18080， -然后程序即可通过加密通道通过vps上网。 + +### 1.HTTP代理 +**1.1.普通HTTP代理** +`./proxy http -t tcp -p "0.0.0.0:38080"` + +**1.2.普通二级HTTP代理** +使用本地端口8090,假设上级HTTP代理是`22.22.22.22:8080` +`./proxy http -t tcp -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" ` +默认开启了连接池,如果为了网络情况很好,-L可以关闭连接池,0就是连接池大小,0为关闭. +`./proxy http -t tcp -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" -L 0` +我们还可以指定网站域名的黑白名单文件,一行一个域名,怕匹配规则是最右批评匹配,比如:baidu.com,匹配的是*.*.baidu.com,黑名单的域名域名直接走上级代理,白名单的域名不走上级代理. +`./proxy http -p "0.0.0.0:8090" -T tcp -P "22.22.22.22:8080" -b blocked.txt -d direct.txt` + +**1.3.HTTP二级代理(加密)** +一级HTTP代理(VPS,IP:22.22.22.22) +`./proxy http -t tls -p ":38080" -C proxy.crt -K proxy.key` + +二级HTTP代理(本地Linux) +`./proxy http -t tcp -p ":8080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` +那么访问本地的8080端口就是访问VPS上面的代理端口38080. + +二级HTTP代理(本地windows) +`./proxy.exe http -t tcp -p ":8080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` +然后设置你的windos系统中，需要通过代理上网的程序的代理为http模式，地址为：127.0.0.1，端口为：8080,程序即可通过加密通道通过vps上网。 + +**1.4.HTTP三级代理(加密)** +一级HTTP代理VPS_01,IP:22.22.22.22 +`./proxy http -t tls -p ":38080" -C proxy.crt -K proxy.key` +二级HTTP代理VPS_02,IP:33.33.33.33 +`./proxy http -t tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` +三级HTTP代理(本地) +`./proxy http -t tcp -p ":8080" -T tls -P "33.33.33.33:28080" -C proxy.crt -K proxy.key` +那么访问本地的8080端口就是访问一级HTTP代理上面的代理端口38080. + +**1.5.Basic认证** +对于代理HTTP协议我们可以basic进行Basic认证,认证的用户名和密码可以在命令行指定 +`./proxy http -t tcp -p ":33080" -a "user1:pass1" -a "user2:pass2"` +多个用户,重复-a参数即可. +也可以放在文件中,格式是一行一个"用户名:密码",然后用-F指定. +`./proxy http -t tcp -p ":33080" -F auth-file.txt` +如果没有-a或-F参数,就是关闭Basic认证. + +**1.6.HTTP代理流量强制走上级HTTP代理** +默认情况下,proxy会智能判断一个网站域名是否无法访问,如果无法访问才走上级HTTP代理.通过--always可以使全部HTTP代理流量强制走上级HTTP代理. +`./proxy http --always -t tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` + +**1.7.查看帮助** +`./proxy help http` +[图文教程](docs/faststart_v3.md) + +### 2.TCP代理 + +**2.1.普通一级TCP代理** +本地执行: +`./proxy tcp -p ":33080" -T tcp -P "192.168.22.33:22" -L 0` +那么访问本地33080端口就是访问192.168.22.33的22端口. + +**2.2.普通二级TCP代理** +VPS(IP:22.22.22.33)执行: +`./proxy tcp -p ":33080" -T tcp -P "127.0.0.1:8080" -L 0` +本地执行: +`./proxy tcp -p ":23080" -T tcp -P "22.22.22.33:33080"` +那么访问本地23080端口就是访问22.22.22.33的8080端口. + +**2.3.普通三级TCP代理** +一级TCP代理VPS_01,IP:22.22.22.22 +`./proxy tcp -p ":38080" -T tcp -P "66.66.66.66:8080" -L 0` +二级TCP代理VPS_02,IP:33.33.33.33 +`./proxy tcp -p ":28080" -T tcp -P "22.22.22.22:38080"` +三级TCP代理(本地) +`./proxy tcp -p ":8080" -T tcp -P "33.33.33.33:28080"` +那么访问本地8080端口就是通过加密TCP隧道访问66.66.66.66的8080端口. + +**2.4.加密二级TCP代理** +VPS(IP:22.22.22.33)执行: +`./proxy tcp --tls -p ":33080" -T tcp -P "127.0.0.1:8080" -L 0 -C proxy.crt -K proxy.key` +本地执行: +`./proxy tcp -p ":23080" -T tls -P "22.22.22.33:33080" -C proxy.crt -K proxy.key` +那么访问本地23080端口就是通过加密TCP隧道访问22.22.22.33的8080端口. + +**2.5.加密三级TCP代理** +一级TCP代理VPS_01,IP:22.22.22.22 +`./proxy tcp --tls -p ":38080" -T tcp -P "66.66.66.66:8080" -C proxy.crt -K proxy.key` +二级TCP代理VPS_02,IP:33.33.33.33 +`./proxy tcp --tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` +三级TCP代理(本地) +`./proxy tcp -p ":8080" -T tls -P "33.33.33.33:28080" -C proxy.crt -K proxy.key` +那么访问本地8080端口就是通过加密TCP隧道访问66.66.66.66的8080端口. + +**2.6.查看帮助** +`./proxy help tcp` + +### 3.UDP代理 + +**3.1.普通一级UDP代理** +本地执行: +`./proxy udp -p ":5353" -T udp -P "8.8.8.8:53"` +那么访问本地UDP:5353端口就是访问8.8.8.8的UDP:53端口. + +**3.2.普通二级UDP代理** +VPS(IP:22.22.22.33)执行: +`./proxy tcp -p ":33080" -T udp -P "8.8.8.8:53"` +本地执行: +`./proxy udp -p ":5353" -T tcp -P "22.22.22.33:33080"` +那么访问本地UDP:5353端口就是通过TCP隧道,通过VPS访问8.8.8.8的UDP:53端口. + +**3.3.普通三级UDP代理** +一级TCP代理VPS_01,IP:22.22.22.22 +`./proxy tcp -p ":38080" -T udp -P "8.8.8.8:53"` +二级TCP代理VPS_02,IP:33.33.33.33 +`./proxy tcp -p ":28080" -T tcp -P "22.22.22.22:38080"` +三级TCP代理(本地) +`./proxy udp -p ":5353" -T tcp -P "33.33.33.33:28080"` +那么访问本地5353端口就是通过TCP隧道,通过VPS访问8.8.8.8的53端口. + +**3.4.加密二级UDP代理** +VPS(IP:22.22.22.33)执行: +`./proxy tcp --tls -p ":33080" -T udp -P "8.8.8.8:53" -C proxy.crt -K proxy.key` +本地执行: +`./proxy udp -p ":5353" -T tls -P "22.22.22.33:33080" -C proxy.crt -K proxy.key` +那么访问本地UDP:5353端口就是通过加密TCP隧道,通过VPS访问8.8.8.8的UDP:53端口. + +**3.5.加密三级UDP代理** +一级TCP代理VPS_01,IP:22.22.22.22 +`./proxy tcp --tls -p ":38080" -T udp -P "8.8.8.8:53" -C proxy.crt -K proxy.key` +二级TCP代理VPS_02,IP:33.33.33.33 +`./proxy tcp --tls -p ":28080" -T tls -P "22.22.22.22:38080" -C proxy.crt -K proxy.key` +三级TCP代理(本地) +`./proxy udp -p ":5353" -T tls -P "33.33.33.33:28080" -C proxy.crt -K proxy.key` +那么访问本地5353端口就是通过加密TCP隧道,通过VPS_01访问8.8.8.8的53端口. + +**3.6.查看帮助** +`./proxy help udp` + +### 4.反向代理(内网穿透) +**4.1、原理说明** +内网穿透,由三部分组成:client端,server端,bridge端；client和server主动连接bridge端进行桥接. +当用户访问server端,流程是: +1. server主动和bridge端建立连接； +1. 然后bridge端通知client端连接bridge端,并连接内网目标端口; +1. 然后绑定client端到bridge端和client端到内网端口的连接； +1. 然后bridge端把client过来的连接与server端过来的连接绑定； +1. 整个通道建立完成； + +**4.2、普通用法** +背景: +- 公司机器A提供了web服务80端口 +- 有VPS一个,公网IP:22.22.22.22 + +需求: +在家里能够通过访问VPS的28080端口访问到公司机器A的80端口 + +步骤: +1. 在vps上执行 +`./proxy tbridge -p ":33080" -C proxy.crt -K proxy.key` + +`./proxy tserver -p ":28080" -P "127.0.0.1:33080" -C proxy.crt -K proxy.key` + +1. 在公司机器A上面执行 +`./proxy tclient -p "127.0.0.1:80" -P "22.22.22.22:33080" -C proxy.crt -K proxy.key` + +1. 完成 + +**4.3、高级用法一** +背景: +- 公司机器A提供了web服务80端口 +- 有VPS一个,公网IP:22.22.22.22 + +需求: +为了安全,不想在VPS上能够访问到公司机器A,在家里能够通过访问本机的28080端口, +通过加密隧道访问到公司机器A的80端口. + +步骤: +1. 在vps上执行 +`./proxy tbridge -p ":33080" -C proxy.crt -K proxy.key` + +1. 在公司机器A上面执行 +`./proxy tclient -p "127.0.0.1:80" -P "22.22.22.22:33080" -C proxy.crt -K proxy.key` + +1. 在家里电脑上执行 +`./proxy tserver -p ":28080" -P "22.22.22.22:33080" -C proxy.crt -K proxy.key` + +1. 完成 +**4.3、高级用法二** +提示: +一个client和一个server是一对,如果要暴露多个端口,需要使用--k参数进行分组, +--k可以是任意唯一字符串,只要多个端口使用一样的即可. + +背景: +- 公司机器A提供了web服务80端口,ftp服务21端口 +- 有VPS一个,公网IP:22.22.22.22 + +需求: +在家里能够通过访问VPS的28080端口访问到公司机器A的80端口 +在家里能够通过访问VPS的29090端口访问到公司机器A的21端口 + +步骤: +1. 在vps上执行 +`./proxy tbridge -p ":33080" -C proxy.crt -K proxy.key` + +`./proxy tserver -p ":28080" --k web -P "127.0.0.1:33080" -C proxy.crt -K proxy.key` + +`./proxy tserver -p ":29090" --k ftp -P "127.0.0.1:33080" -C proxy.crt -K proxy.key` + +1. 在公司机器A上面执行 +`./proxy tclient -p "127.0.0.1:80" --k web -P "22.22.22.22:33080" -C proxy.crt -K proxy.key` + +`./proxy tclient -p "127.0.0.1:21" --k ftp -P "22.22.22.22:33080" -C proxy.crt -K proxy.key` + +1. 完成 + +**3.6.查看帮助** +`./proxy help tbridge` +`./proxy help tserver` +`./proxy help tserver` + + ### TODO - UDP Over TCP,通过tcp代理udp协议. ### License