465 lines
12 KiB
Markdown
465 lines
12 KiB
Markdown
gost - GO Simple Tunnel
|
||
======
|
||
|
||
### GO语言实现的安全隧道
|
||
|
||
[English README](README_en.md)
|
||
|
||
特性
|
||
------
|
||
* 多端口监听
|
||
* 可设置转发代理，支持多级转发(代理链)
|
||
* 支持标准HTTP/HTTPS/HTTP2/SOCKS4(A)/SOCKS5代理协议
|
||
* SOCKS5代理支持TLS协商加密
|
||
* Tunnel UDP over TCP
|
||
* 权限控制 (2.4+)
|
||
* 本地/远程TCP/UDP端口转发 (2.1+)
|
||
* Shadowsocks协议 (UDP: 2.4+)
|
||
* KCP协议 (2.3+)
|
||
* TCP透明代理 (2.3+)
|
||
* HTTP2通道 (2.4+)
|
||
* SSH通道 (2.4+)
|
||
* QUIC通道 (2.4+)
|
||
* obfs4通道 (2.4+)
|
||
|
||
二进制文件下载：https://github.com/ginuerzh/gost/releases
|
||
|
||
Google讨论组: https://groups.google.com/d/forum/go-gost
|
||
|
||
在gost中，gost与其他代理服务都被看作是代理节点，gost可以自己处理请求，或者将请求转发给任意一个或多个代理节点。
|
||
|
||
|
||
Ubuntu Store
|
||
------
|
||
gost已经上架ubuntu store，在ubuntu 16.04上可以直接通过`snap`来安装：
|
||
|
||
```bash
|
||
$ sudo snap install gost
|
||
```
|
||
|
||
参数说明
|
||
------
|
||
#### 代理及代理链
|
||
|
||
适用于-L和-F参数
|
||
|
||
```bash
|
||
[scheme://][user:pass@host]:port
|
||
```
|
||
scheme分为两部分: protocol+transport
|
||
|
||
protocol: 代理协议类型(http, socks4(a), socks5, ss), transport: 数据传输方式(ws, wss, tls, quic, kcp, ssh, h2, h2c, obfs4), 二者可以任意组合，或单独使用:
|
||
|
||
> http - 标准HTTP代理: http://:8080
|
||
|
||
> https - 标准HTTPS代理(可能需要提供受信任的证书): http+tls://:443或https://:443
|
||
|
||
> http2 - 标准HTTP2代理并向下兼容HTTPS: http2://:443
|
||
|
||
> h2 - HTTP2 h2通道: h2://:443
|
||
|
||
> h2c - HTTP2 h2c通道: h2c://:443
|
||
|
||
> socks4(a) - 标准SOCKS4(A)代理: socks4://:1080或socks4a://:1080
|
||
|
||
> socks5 - 标准SOCKS5代理(支持TLS协商加密): socks5://:1080
|
||
|
||
> socks5+wss - SOCKS5代理，使用websocket传输数据: socks5+wss://:1080
|
||
|
||
> tls - HTTP/SOCKS4/SOCKS5代理，使用TLS传输数据: tls://:443
|
||
|
||
> ss - Shadowsocks代理: ss://chacha20:123456@:8338
|
||
|
||
> ssu - Shadowsocks UDP relay: ssu://chacha20:123456@:8338
|
||
|
||
> quic - QUIC通道: quic://:6121
|
||
|
||
> kcp - KCP通道: kcp://:8388
|
||
|
||
> redirect - 透明代理: redirect://:12345
|
||
|
||
> ssh - SSH代理通道: ssh://:2222，SSH转发通道: forward+ssh://:2222
|
||
|
||
> obfs4 - obfs4通道: obfs4://:8080
|
||
|
||
|
||
#### 端口转发
|
||
|
||
适用于-L参数
|
||
|
||
```bash
|
||
scheme://[bind_address]:port/[host]:hostport
|
||
```
|
||
> scheme - 端口转发模式, 本地端口转发: tcp, udp; 远程端口转发: rtcp, rudp
|
||
|
||
> bind_address:port - 本地/远程绑定地址
|
||
|
||
> host:hostport - 目标访问地址
|
||
|
||
#### 配置文件
|
||
|
||
此功能由[@septs](https://github.com/septs)贡献。
|
||
|
||
> -C : 指定配置文件路径
|
||
|
||
配置文件为标准json格式：
|
||
```json
|
||
{
|
||
"ServeNodes": [
|
||
":8080",
|
||
"ss://chacha20:12345678@:8338"
|
||
],
|
||
"ChainNodes": [
|
||
"http://192.168.1.1:8080",
|
||
"https://10.0.2.1:443"
|
||
]
|
||
}
|
||
```
|
||
|
||
ServeNodes等同于-L参数，ChainNodes等同于-F参数
|
||
|
||
|
||
使用方法
|
||
------
|
||
#### 不设置转发代理
|
||
|
||
<img src="https://ginuerzh.github.io/images/gost_01.png" />
|
||
|
||
* 作为标准HTTP/SOCKS4/SOCKS5代理
|
||
```bash
|
||
gost -L=:8080
|
||
```
|
||
|
||
* 设置代理认证信息
|
||
```bash
|
||
gost -L=admin:123456@localhost:8080
|
||
```
|
||
|
||
* 多组认证信息
|
||
```bash
|
||
gost -L=localhost:8080?secrets=secrets.txt
|
||
```
|
||
|
||
通过secrets参数可以为HTTP/SOCKS5代理设置多组认证信息，格式为：
|
||
```plain
|
||
# username password
|
||
|
||
test001 123456
|
||
test002 12345678
|
||
```
|
||
|
||
* 多端口监听
|
||
```bash
|
||
gost -L=http2://:443 -L=socks5://:1080 -L=ss://aes-128-cfb:123456@:8338
|
||
```
|
||
|
||
#### 设置转发代理
|
||
|
||
<img src="https://ginuerzh.github.io/images/gost_02.png" />
|
||
|
||
```bash
|
||
gost -L=:8080 -F=192.168.1.1:8081
|
||
```
|
||
|
||
* 转发代理认证
|
||
|
||
```bash
|
||
gost -L=:8080 -F=http://admin:123456@192.168.1.1:8081
|
||
```
|
||
|
||
#### 设置多级转发代理(代理链)
|
||
|
||
<img src="https://ginuerzh.github.io/images/gost_03.png" />
|
||
|
||
```bash
|
||
gost -L=:8080 -F=quic://192.168.1.1:6121 -F=socks5+wss://192.168.1.2:1080 -F=http2://192.168.1.3:443 ... -F=a.b.c.d:NNNN
|
||
```
|
||
|
||
gost按照-F设置的顺序通过代理链将请求最终转发给a.b.c.d:NNNN处理，每一个转发代理可以是任意HTTP/HTTPS/HTTP2/SOCKS4/SOCKS5/Shadowsocks类型代理。
|
||
|
||
#### 本地端口转发(TCP)
|
||
|
||
```bash
|
||
gost -L=tcp://:2222/192.168.1.1:22 [-F=...]
|
||
```
|
||
|
||
将本地TCP端口2222上的数据(通过代理链)转发到192.168.1.1:22上。当代理链末端(最后一个-F参数)为SSH转发通道类型时，gost会直接使用SSH的本地端口转发功能:
|
||
|
||
```bash
|
||
gost -L=tcp://:2222/192.168.1.1:22 -F forward+ssh://:2222
|
||
```
|
||
|
||
#### 本地端口转发(UDP)
|
||
|
||
```bash
|
||
gost -L=udp://:5353/192.168.1.1:53?ttl=60 [-F=...]
|
||
```
|
||
|
||
将本地UDP端口5353上的数据(通过代理链)转发到192.168.1.1:53上。
|
||
每条转发通道都有超时时间，当超过此时间，且在此时间段内无任何数据交互，则此通道将关闭。可以通过`ttl`参数来设置超时时间，默认值为60秒。
|
||
|
||
**注:** 转发UDP数据时，如果有代理链，则代理链的末端(最后一个-F参数)必须是gost SOCKS5类型代理，gost会使用UDP over TCP方式进行转发。
|
||
|
||
#### 远程端口转发(TCP)
|
||
|
||
```bash
|
||
gost -L=rtcp://:2222/192.168.1.1:22 [-F=...]
|
||
```
|
||
将172.24.10.1:2222上的数据(通过代理链)转发到192.168.1.1:22上。当代理链末端(最后一个-F参数)为SSH转发通道类型时，gost会直接使用SSH的远程端口转发功能:
|
||
|
||
```bash
|
||
gost -L=rtcp://:2222/192.168.1.1:22 -F forward+ssh://:2222
|
||
```
|
||
|
||
#### 远程端口转发(UDP)
|
||
|
||
```bash
|
||
gost -L=rudp://:5353/192.168.1.1:53 [-F=...]
|
||
```
|
||
将172.24.10.1:5353上的数据(通过代理链)转发到192.168.1.1:53上。
|
||
每条转发通道都有超时时间，当超过此时间，且在此时间段内无任何数据交互，则此通道将关闭。可以通过`ttl`参数来设置超时时间，默认值为60秒。
|
||
|
||
**注:** 转发UDP数据时，如果有代理链，则代理链的末端(最后一个-F参数)必须是gost SOCKS5类型代理，gost会使用UDP over TCP方式进行转发。
|
||
|
||
#### HTTP2
|
||
|
||
gost的HTTP2支持两种模式：
|
||
* 作为标准的HTTP2代理，并向下兼容HTTPS代理。
|
||
* 作为通道传输其他协议。
|
||
|
||
##### 代理模式
|
||
服务端:
|
||
```bash
|
||
gost -L=http2://:443
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=http2://server_ip:443
|
||
```
|
||
|
||
##### 通道模式
|
||
服务端:
|
||
```bash
|
||
gost -L=h2://:443
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=h2://server_ip:443
|
||
```
|
||
|
||
#### QUIC
|
||
gost对QUIC的支持是基于[quic-go](https://github.com/lucas-clemente/quic-go)库。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=quic://:6121
|
||
```
|
||
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=quic://server_ip:6121
|
||
```
|
||
|
||
**注：** QUIC模式只能作为代理链的第一个节点。
|
||
|
||
#### KCP
|
||
gost对KCP的支持是基于[kcp-go](https://github.com/xtaci/kcp-go)和[kcptun](https://github.com/xtaci/kcptun)库。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=kcp://:8388
|
||
```
|
||
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=kcp://server_ip:8388
|
||
```
|
||
|
||
gost会自动加载当前工作目录中的kcp.json(如果存在)配置文件，或者可以手动通过参数指定配置文件路径：
|
||
```bash
|
||
gost -L=kcp://:8388?c=/path/to/conf/file
|
||
```
|
||
|
||
**注：** KCP模式只能作为代理链的第一个节点。
|
||
|
||
#### SSH
|
||
|
||
gost的SSH支持两种模式：
|
||
* 作为转发通道，配合本地/远程TCP端口转发使用。
|
||
* 作为通道传输其他协议。
|
||
|
||
##### 转发模式
|
||
服务端:
|
||
```bash
|
||
gost -L=forward+ssh://:2222
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=rtcp://:1222/:22 -F=forward+ssh://server_ip:2222
|
||
```
|
||
|
||
##### 通道模式
|
||
服务端:
|
||
```bash
|
||
gost -L=ssh://:2222
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=ssh://server_ip:2222?ping=60
|
||
```
|
||
|
||
可以通过`ping`参数设置心跳包发送周期，单位为秒。默认不发送心跳包。
|
||
|
||
|
||
#### 透明代理
|
||
基于iptables的透明代理。
|
||
|
||
```bash
|
||
gost -L=redirect://:12345 -F=http2://server_ip:443
|
||
```
|
||
|
||
#### obfs4
|
||
此功能由[@isofew](https://github.com/isofew)贡献。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=obfs4://:443
|
||
```
|
||
|
||
当服务端运行后会在控制台打印出连接地址供客户端使用:
|
||
```
|
||
obfs4://:443/?cert=4UbQjIfjJEQHPOs8vs5sagrSXx1gfrDCGdVh2hpIPSKH0nklv1e4f29r7jb91VIrq4q5Jw&iat-mode=0
|
||
```
|
||
|
||
客户端:
|
||
```
|
||
gost -L=:8888 -F='obfs4://server_ip:443?cert=4UbQjIfjJEQHPOs8vs5sagrSXx1gfrDCGdVh2hpIPSKH0nklv1e4f29r7jb91VIrq4q5Jw&iat-mode=0'
|
||
```
|
||
|
||
加密机制
|
||
------
|
||
#### HTTP
|
||
对于HTTP可以使用TLS加密整个通讯过程，即HTTPS代理：
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=https://:443
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=http+tls://server_ip:443
|
||
```
|
||
|
||
#### HTTP2
|
||
gost的HTTP2代理模式仅支持使用TLS加密的HTTP2协议，不支持明文HTTP2传输。
|
||
|
||
gost的HTTP2通道模式支持加密(h2)和明文(h2c)两种模式。
|
||
|
||
#### SOCKS5
|
||
gost支持标准SOCKS5协议的no-auth(0x00)和user/pass(0x02)方法，并在此基础上扩展了两个：tls(0x80)和tls-auth(0x82)，用于数据加密。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=socks5://:1080
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=socks5://server_ip:1080
|
||
```
|
||
|
||
如果两端都是gost(如上)则数据传输会被加密(协商使用tls或tls-auth方法)，否则使用标准SOCKS5进行通讯(no-auth或user/pass方法)。
|
||
|
||
#### Shadowsocks
|
||
gost对shadowsocks的支持是基于[shadowsocks-go](https://github.com/shadowsocks/shadowsocks-go)库。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=ss://chacha20:123456@:8338
|
||
```
|
||
客户端:
|
||
```bash
|
||
gost -L=:8080 -F=ss://chacha20:123456@server_ip:8338
|
||
```
|
||
|
||
##### Shadowsocks UDP relay
|
||
|
||
目前仅服务端支持UDP Relay。
|
||
|
||
服务端:
|
||
```bash
|
||
gost -L=ssu://chacha20:123456@:8338
|
||
```
|
||
|
||
#### TLS
|
||
gost内置了TLS证书，如果需要使用其他TLS证书，有两种方法：
|
||
* 在gost运行目录放置cert.pem(公钥)和key.pem(私钥)两个文件即可，gost会自动加载运行目录下的cert.pem和key.pem文件。
|
||
* 使用参数指定证书文件路径：
|
||
```bash
|
||
gost -L="http2://:443?cert=/path/to/my/cert/file&key=/path/to/my/key/file"
|
||
```
|
||
|
||
对于客户端可以指定CA证书进行[证书锁定](https://en.wikipedia.org/wiki/Transport_Layer_Security#Certificate_pinning)(Certificate Pinning):
|
||
```bash
|
||
gost -L=:8080 -F="http2://:443?ca=ca.pem"
|
||
```
|
||
证书锁定功能由[@sheerun](https://github.com/sheerun)贡献
|
||
|
||
SOCKS5 UDP数据处理
|
||
------
|
||
#### 不设置转发代理
|
||
|
||
<img src="https://ginuerzh.github.io/images/udp01.png" height=100 />
|
||
|
||
gost作为标准SOCKS5代理处理UDP数据
|
||
|
||
#### 设置转发代理
|
||
|
||
<img src="https://ginuerzh.github.io/images/udp02.png" height=100 />
|
||
|
||
#### 设置多个转发代理(代理链)
|
||
|
||
<img src="https://ginuerzh.github.io/images/udp03.png" height=200 />
|
||
|
||
当设置转发代理时，gost会使用UDP-over-TCP方式转发UDP数据。proxy1 - proxyN可以为任意HTTP/HTTPS/HTTP2/SOCKS5/Shadowsocks类型代理。
|
||
|
||
权限控制
|
||
------
|
||
此功能由[@sheerun](https://github.com/sheerun)贡献。
|
||
|
||
服务端可以通过白名单(`whitelist`参数)和黑名单(`blacklist`参数)来控制客户端的请求是否允许被处理。
|
||
参数格式为: `[actions]:[hosts]:[ports]`
|
||
|
||
`[actions]`是一个由`,`分割的动作列表，可选值有: `tcp`(TCP转发), `udp`(UDP转发), `rtcp`(TCP远程转发), `rudp`(UDP远程转发), 或 `*`(所有动作)。
|
||
|
||
`[hosts]`是一个由`,`分割的Host列表，代表可以绑定到(rtcp,rudp)或转发到(tcp,udp)的目的主机，支持通配符(*.google.com)和`*`(所有主机)。
|
||
|
||
`[ports]`是一个由`,`分割的端口列表，代表可以绑定到(rtcp,rudp)或转发到(tcp,udp)的目的端口，可以是`*`(所有端口)。
|
||
|
||
多组权限可以通过`+`进行连接:
|
||
|
||
`whitelist=rtcp,rudp:localhost,127.0.0.1:2222,8000-9000+udp:8.8.8.8,8.8.4.4:53`(允许TCP/UDP远程端口转发绑定到localhost,127.0.0.1的2222端口和8000-9000端口范围，同时允许UDP转发到8.8.8.8:53和8.8.4.4:53)。
|
||
|
||
SSH远程端口转发只能绑定到127.0.0.1:8000
|
||
```bash
|
||
gost -L=forward+ssh://localhost:8389?whitelist=rtcp:127.0.0.1:8000
|
||
```
|
||
|
||
SOCKS5的TCP/UDP远程端口转发只允许绑定到大于1000的端口
|
||
```bash
|
||
gost -L=socks://localhost:8389?blacklist=rtcp,rudp:*:0-1000
|
||
```
|
||
|
||
SOCKS5的UDP转发只能转发到8.8.8.8:53
|
||
```bash
|
||
gost -L=socks://localhost:8389?whitelist=udp:8.8.8.8:53
|
||
```
|
||
|
||
限制条件
|
||
------
|
||
代理链中的HTTP代理节点必须支持CONNECT方法。
|
||
|
||
如果要转发SOCKS5的BIND和UDP请求，代理链的末端(最后一个-F参数)必须支持gost SOCKS5类型代理。
|
||
|
||
|
||
|