1 # Public Domain SOCKS proxy protocol implementation
2 # Adapted from https://gist.github.com/bluec0re/cafd3764412967417fd3
4 from __future__ import unicode_literals
14 __author__ = 'Timo Schmid <coding@timoschmid.de>'
17 class ProxyError(IOError):
21 class Socks4Error(ProxyError):
23 0x5B: 'request rejected or failed',
24 0x5C: 'request rejected becasue SOCKS server cannot connect to identd on the client',
25 0x5D: 'request rejected because the client program and identd report different user-ids'
28 def __init__(self, code=None, msg=None):
29 if code is not None and msg is None:
30 msg = self.CODES.get(code)
33 super(Socks4Error, self).__init__(code, msg)
36 class Socks5Error(Socks4Error):
38 0x01: 'general SOCKS server failure',
39 0x02: 'connection not allowed by ruleset',
40 0x03: 'Network unreachable',
41 0x04: 'Host unreachable',
42 0x05: 'Connection refused',
44 0x07: 'Command not supported',
45 0x08: 'Address type not supported',
46 0xFE: 'unknown username or invalid password',
47 0xFF: 'all offered authentication methods were rejected'
51 class ProxyType(object):
56 Proxy = collections.namedtuple('Proxy', ('type', 'host', 'port', 'username', 'password', 'remote_dns'))
59 class sockssocket(socket.socket):
65 def _proxy_port(self):
68 return self._proxy.port
72 def setproxy(self, proxytype=None, addr=None, port=None, rdns=True, username=None, password=None):
76 self.__proxy = Proxy(proxytype, addr, port, username, password, rdns)
78 def recvall(self, cnt):
80 while len(data) < cnt:
81 cur = self.recv(cnt - len(data))
83 raise IOError('{0} bytes missing'.format(cnt - len(data)))
87 def _setup_socks4(self, address, is_4a=False):
88 destaddr, port = address
91 ipaddr = socket.inet_aton(destaddr)
93 if is_4a and self._proxy.remote_dns:
94 ipaddr = struct_pack('!BBBB', 0, 0, 0, 0xFF)
96 ipaddr = socket.inet_aton(socket.gethostbyname(destaddr))
98 packet = struct_pack('!BBH', 0x4, 0x1, port) + ipaddr
99 if self._proxy.username:
100 username = self._proxy.username
101 if hasattr(username, 'encode'):
102 username = username.encode()
103 packet += struct_pack('!{0}s'.format(len(username) + 1), username)
107 if is_4a and self._proxy.remote_dns:
108 if hasattr(destaddr, 'encode'):
109 destaddr = destaddr.encode()
110 packet += struct_pack('!{0}s'.format(len(destaddr) + 1), destaddr)
114 packet = self.recvall(8)
115 nbyte, resp_code, dstport, dsthost = struct_unpack('!BBHI', packet)
117 # check valid response
121 0, 'Invalid response from server. Expected {0:02x} got {1:02x}'.format(0, nbyte))
124 if resp_code != 0x5a:
126 raise Socks4Error(resp_code)
128 return (dsthost, dstport)
130 def _setup_socks5(self, address):
131 destaddr, port = address
134 ipaddr = socket.inet_aton(destaddr)
136 if self._proxy.remote_dns:
139 ipaddr = socket.inet_aton(socket.gethostbyname(destaddr))
142 if self._proxy.username and self._proxy.password:
143 # two auth methods available
145 packet = struct_pack('!BBB', 0x5, auth_methods, 0x00) # no auth
146 if self._proxy.username and self._proxy.password:
147 packet += struct_pack('!B', 0x02) # user/pass auth
151 packet = self.recvall(2)
152 version, method = struct_unpack('!BB', packet)
154 # check valid response
158 0, 'Invalid response from server. Expected {0:02x} got {1:02x}'.format(5, version))
163 raise Socks5Error(method)
167 username = self._proxy.username
168 if hasattr(username, 'encode'):
169 username = username.encode()
170 password = self._proxy.password
171 if hasattr(password, 'encode'):
172 password = password.encode()
173 packet = struct_pack('!BB', 1, len(username)) + username
174 packet += struct_pack('!B', len(password)) + password
177 packet = self.recvall(2)
178 version, status = struct_unpack('!BB', packet)
183 0, 'Invalid response from server. Expected {0:02x} got {1:02x}'.format(1, version))
188 elif method == 0x00: # no auth
191 packet = struct_pack('!BBB', 5, 1, 0)
193 if hasattr(destaddr, 'encode'):
194 destaddr = destaddr.encode()
195 packet += struct_pack('!BB', 3, len(destaddr)) + destaddr
197 packet += struct_pack('!B', 1) + ipaddr
198 packet += struct_pack('!H', port)
202 packet = self.recvall(4)
203 version, status, _, atype = struct_unpack('!BBBB', packet)
208 0, 'Invalid response from server. Expected {0:02x} got {1:02x}'.format(5, version))
212 raise Socks5Error(status)
215 destaddr = self.recvall(4)
217 alen = struct_unpack('!B', self.recv(1))[0]
218 destaddr = self.recvall(alen)
220 destaddr = self.recvall(16)
221 destport = struct_unpack('!H', self.recvall(2))[0]
223 return (destaddr, destport)
225 def _make_proxy(self, connect_func, address):
226 if self._proxy.type == ProxyType.SOCKS4:
227 result = connect_func(self, (self._proxy.host, self._proxy_port))
228 if result != 0 and result is not None:
230 self._setup_socks4(address)
231 elif self._proxy.type == ProxyType.SOCKS4A:
232 result = connect_func(self, (self._proxy.host, self._proxy_port))
233 if result != 0 and result is not None:
235 self._setup_socks4(address, is_4a=True)
236 elif self._proxy.type == ProxyType.SOCKS5:
237 result = connect_func(self, (self._proxy.host, self._proxy_port))
238 if result != 0 and result is not None:
240 self._setup_socks5(address)
242 return connect_func(self, address)
244 def connect(self, address):
245 self._make_proxy(socket.socket.connect, address)
247 def connect_ex(self, address):
248 return self._make_proxy(socket.socket.connect_ex, address)