golang 代理客户端,和 net 标准库一致的 API 。 支持嵌套代理,支持 socks4、socks4a、socks5、http、https 等代理协议。其中 socks5 支持用户名、密码认证,http、https支持用户名、密码基本认证。
socks5 例子,其他例子请参考 example 目录。
package main import ( "fmt" "github.com/gamexg/proxyclient" "io" "io/ioutil" ) func main() { p, err := proxyclient.NewProxyClient("socks5://user1:[email protected]:6789") if err != nil { panic(err) } c, err := p.Dial("tcp", "www.163.com:80") if err != nil { panic(err) } io.WriteString(c, "GET / HTTP/1.0\r\nHOST:www.163.com\r\n\r\n") b, err := ioutil.ReadAll(c) if err != nil { panic(err) } fmt.Print(string(b)) }
API
// Conn 用来表示连接 type Conn interface { net.Conn } // TCPConn 用来表示 TCP 连接 // 提供 net.TcpConn 结构的全部方法 // 但是部分方法由于代理协议的限制可能不能获得正确的结果。例如:LocalAddr 、RemoteAddr 方法不被很多代理协议支持。 type TCPConn interface { Conn /* SetLinger设定当连接中仍有数据等待发送或接受时的Close方法的行为。 如果sec < 0(默认),Close方法立即返回,操作系统停止后台数据发送;如果 sec == 0,Close立刻返回,操作系统丢弃任何未发送或未接收的数据;如果sec > 0,Close方法阻塞最多sec秒,等待数据发送或者接收,在一些操作系统中,在超时后,任何未发送的数据会被丢弃。 */ SetLinger(sec int) error // SetNoDelay设定操作系统是否应该延迟数据包传递,以便发送更少的数据包(Nagle's算法)。默认为真,即数据应该在Write方法后立刻发送。 SetNoDelay(noDelay bool) error //SetReadBuffer设置该连接的系统接收缓冲 SetReadBuffer(bytes int) error //SetWriteBuffer设置该连接的系统发送缓冲 SetWriteBuffer(bytes int) error } // ProxyTCPConn 用来表示通过代理访问的TCP连接 type ProxyTCPConn interface { TCPConn ProxyClient() ProxyClient // 获得所属的代理 } // UDPConn 表示 UDP 连接 type UDPConn interface { Conn } // ProxyUDPConn 用来表示通过代理访问的TCP连接 type ProxyUDPConn interface { UDPConn ProxyClient() ProxyClient // 获得所属的代理 } // ProxyClient 仿 net 库接口的代理客户端 // 支持级联代理功能,可以通过 SetUpProxy 设置上级代理。 type ProxyClient interface { // 返回本代理的上层级联代理 UpProxy() ProxyClient // 设置本代理的上层代理 SetUpProxy(upProxy ProxyClient) error // Dial 在网络network上连接地址address,并返回一个Conn接口。可用的网络类型有: // "tcp"、"tcp4"、"tcp6"、"udp"、"udp4"、"udp6" // 对TCP和UDP网络,地址格式是host:port或[host]:port,参见函数JoinHostPort和SplitHostPort。 // 如果代理服务器支持远端DNS解析,那么会使用远端DNS解析。 Dial(network, address string) (net.Conn, error) DialTimeout(network, address string, timeout time.Duration) (net.Conn, error) // DialTCP在网络协议net上连接本地地址laddr和远端地址raddr。net必须是"tcp"、"tcp4"、"tcp6";如果laddr不是nil,将使用它作为本地地址,否则自动选择一个本地地址。 // 由于 net.TCPAddr 内部保存的是IP地址及端口,所以使用本函数无法使用远端DNS解析,要想使用远端DNS解析,请使用 Dial 或 DialTCPSAddr 函数。 DialTCP(net string, laddr, raddr *net.TCPAddr) (net.Conn, error) // DialTCPSAddr 同 DialTCP 函数,主要区别是如果代理支持远端dns解析,那么会使用远端dns解析。 DialTCPSAddr(network string, raddr string) (ProxyTCPConn, error) // DialTCPSAddrTimeout 同 DialTCPSAddr 函数,增加了超时功能 DialTCPSAddrTimeout(network string, raddr string, timeour time.Duration) (ProxyTCPConn, error) //ListenTCP在本地TCP地址laddr上声明并返回一个*TCPListener,net参数必须是"tcp"、"tcp4"、"tcp6",如果laddr的端口字段为0,函数将选择一个当前可用的端口,可以用Listener的Addr方法获得该端口。 //ListenTCP(net string, laddr *TCPAddr) (*TCPListener, error) //DialTCP在网络协议net上连接本地地址laddr和远端地址raddr。net必须是"udp"、"udp4"、"udp6";如果laddr不是nil,将使用它作为本地地址,否则自动选择一个本地地址。 DialUDP(net string, laddr, raddr *net.UDPAddr) (net.Conn, error) // 获得 Proxy 代理地址的 Query // 为了大小写兼容,key全部是转换成小写的。 GetProxyAddrQuery() map[string][]string } // NewProxyClient 用来创建代理客户端 // // 参数格式:允许使用 ?参数名1=参数值1&参数名2=参数值2指定参数 // 例如:https://123.123.123.123:8088?insecureskipverify=true // 全体协议可选参数: upProxy=http://145.2.1.3:8080 用于指定代理的上层代理,即代理嵌套。默认值:direct://0.0.0.0:0000 // // http 代理 http://123.123.123.123:8088 // 可选功能: 用户认证功能。格式:http://user:[email protected]:8080 // 可选参数:standardheader=false true表示 CONNNET 请求包含标准的 Accept、Accept-Encoding、Accept-Language、User-Agent等头。默认值:false // // https 代理 https://123.123.123.123:8088 // 可选功能: 用户认证功能,同 http 代理。 // 可选参数:standardheader=false 同上 http 代理 // 可选参数:insecureskipverify=false true表示跳过 https 证书验证。默认false。 // 可选参数:domain=域名 指定https验证证书时使用的域名,默认为 host:port // // socks4 代理 socks4://123.123.123.123:5050 // 注意:socks4 协议不支持远端 dns 解析 // // socks4a 代理 socks4a://123.123.123.123:5050 // // socks5 代理 socks5://123.123.123.123:5050 // 可选功能:用户认证功能。支持无认证、用户名密码认证,格式同 http 代理。 // // // 直连 direct://0.0.0.0:0000 // 可选参数: LocalAddr=0.0.0.0:0 表示tcp连接绑定的本地ip及端口,默认值 0.0.0.0:0。 // 可选参数: SplitHttp=false true 表示拆分 http 请求(分多个tcp包发送),可以解决简单的运营商 http 劫持。默认值:false 。 // 原理是:当发现目标地址为 80 端口,发送的内容包含 GET、POST、HTTP、HOST 等关键字时,会将关键字拆分到两个包在发送出去。 // 注意: Web 防火墙类软件、设备可能会重组 HTTP 包,造成拆分无效。目前已知 ESET Smart Security 会造成这个功能无效,即使暂停防火墙也一样无效。 // G|ET /pa|th H|TTTP/1.0 // HO|ST:www.aa|dd.com // 可选参数: sleep=0 建立连接后延迟多少毫秒发送数据,配合 ttl 反劫持系统时建议设置为10置50。默认值 0 . func NewProxyClient(addr string) (ProxyClient, error)
感谢
- 感谢 zhuhaow 为 http、https 协议添加鉴定功能