{"record":{"id":"d36aa634603c5c00","repo":"XX-net/XX-Net","slug":"request-address-type-unknown-d-d36aa6","errorCode":null,"errorMessage":"request address type unknown:%d","messagePattern":"request address type unknown:(.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"code/default/smart_router/local/proxy_handler.py","lineNumber":282,"sourceCode":"            return\n\n        command = ord(data[1:2])\n        addrtype_pack = data[3:4]\n        addrtype = ord(addrtype_pack)\n        if addrtype == 1:  # IPv4\n            addr_pack = self.read_bytes(4)\n            addr = socket.inet_ntoa(addr_pack)\n        elif addrtype == 3:  # Domain name\n            domain_len_pack = self.read_bytes(1)[0:1]\n            domain_len = ord(domain_len_pack)\n            domain = self.read_bytes(domain_len)\n            addr_pack = domain_len_pack + domain\n            addr = domain\n        elif addrtype == 4:  # IPv6\n            addr_pack = self.read_bytes(16)\n            addr = socket.inet_ntop(socket.AF_INET6, addr_pack)\n        else:\n            xlog.warn(\"request address type unknown:%d\", addrtype)\n            sock.send(b\"\\x05\\x07\\x00\\x01\")  # Command not supported\n            return\n        port = struct.unpack('>H', self.rfile.read(2))[0]\n\n        if command == 3:  # 3. UDP associate\n            return self.handle_udp_associate(sock, addr, port, addrtype_pack, addr_pack)\n\n        if command != 1:  # 1. Tcp connect\n            xlog.warn(\"request not supported command mode:%d\", command)\n            sock.send(b\"\\x05\\x07\\x00\\x01\")  # Command not supported\n            return\n\n        # xlog.debug(\"socks5 %r connect to %s:%d\", self.client_address, addr, port)\n        reply = b\"\\x05\\x00\\x00\" + addrtype_pack + addr_pack + struct.pack(\">H\", port)\n        sock.send(reply)\n\n        if addrtype in [1, 4]:\n            handle_ip_proxy(sock, addr, port, self.client_address)","sourceCodeStart":264,"sourceCodeEnd":300,"githubUrl":"https://github.com/XX-net/XX-Net/blob/cfa5bc17b67676e467f37ec50766127e0ab5f0aa/code/default/smart_router/local/proxy_handler.py#L264-L300","documentation":"SOCKS5 request used an address type (ATYP) other than 1 (IPv4), 3 (domain), or 4 (IPv6). The proxy replies 0x07 (command not supported) and closes.","triggerScenarios":"A malformed or non-compliant SOCKS5 client sends an unknown ATYP byte in the request packet.","commonSituations":"Corrupted handshake bytes, a client speaking a different protocol on the SOCKS port, or buggy SOCKS implementations.","solutions":["Verify the client emits a valid SOCKS5 request: VER CMD RSV ATYP ADDR PORT","Capture the bytes with tcpdump/wireshark to spot protocol corruption","Ensure no TLS/other framing is applied before the SOCKS handshake","Switch to a well-tested SOCKS client library"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if atyp not in (1,3,4): raise MalformedSocksRequest","typeGuard":"def valid_atyp(t): return t in (0x01, 0x03, 0x04)","tryCatchPattern":null,"preventionTips":["Use standards-compliant SOCKS5 client libraries","Validate handshake bytes before use"],"tags":["socks5","protocol","address-type","malformed-request"],"backgroundTag":"socks-address-type-invalid","analyzedSha":"cfa5bc17b67676e467f37ec50766127e0ab5f0aa","analyzedAt":"2026-08-27T19:28:28.225Z","schemaVersion":2},"datasetVersion":"2026-08-28T00:17:15.603Z"}