ErrLookup › XTLS/Xray-core
XTLS/Xray-core
Xray, Penetrates Everything. Also the best v2ray-core. Where the magic happens. An open platform for various uses. · Go · 721 source files
Analyzed at cd4ce973e9 on 2026-09-04. 782 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| failed to resolve ip for target | exception | error | go, xray, dns, outbound, resolution |
| VLESS users: unsupported "encryption | validation | error | vless, encryption, post-quantum, config, validation, xray |
| connection ends | exception | error | network, socks, proxy, timeout, xray |
| err.Error() | http | warning | metrics, json, expvar, http-handler, observability |
| tries to resolve itself! | validation | error | padding, variants, validation, index, xmc |
| UplinkDataPlacement can be only in packet-up mode | validation | error | config, splithttp, mode, uplink |
| VLESS fallbacks: please fill in a valid value for every… | validation | error | vless, config, fallbacks, dest, validation, xray |
| unexpected query strategy | validation | error | padding, delay, crypto-rand, xmc |
| failed to build IPv4 set | exception | error | geodata, geoip, netip, routing, xray |
| BurstObservatory requires a valid pingConfig | validation | error | xray, config, observatory, burst, health-check, validation |
| prefix length splits chunk | validation | error | go, configuration, padding, protocol-framing |
| VLESS settings: "vnext" should have one and only one… | validation | error | vless, outbound, vnext, balancer, config, validation, xray |
| maxConnections cannot be specified together with… | validation | error | config, splithttp, xmux, multiplexing |
| failed to create portal worker | exception | error | go, xray, reverse-proxy, mux, control-channel |
| Failed to convert address to Net IP. | validation | error | padding, config, validation, variants, prefix, xmc |
| unknown config id: | validation | error | xray, config, loader, protocol, registry |
| sessionIDTable or sessionIDLength is too small | validation | error | config, splithttp, session, entropy, validation |
| XUDP rejected UDP/443 traffic | exception | info | go, xray, quic, udp, mux, policy |
| invalid TCP header config | validation | error | config, tcp, json, header-obfuscation |
| unable to dispatch control connection | exception | error | go, xray, reverse-proxy, mux, control-channel |
| failed to create client | exception | error | padding, crypto-rand, entropy, xmc |
| Failed to unmarshal "extra". | validation | error | config, splithttp, json, validation |
| metrics must have a tag or listen address | validation | error | go, xray, configuration, metrics |
| brutal | panic | critical | quic, congestion-control, panic, config, splithttp |
| VLESS users: please use simplified outbound's config style… | validation | error | vless, reverse, outbound, config, xray |
| unable to get destination | exception | error | go, xray, dokodemo, transparent-proxy, iptables, network |
| unable to select outbounds | exception | warning | go, xray, routing, balancer, api |
| please fill in a valid value for "target" | validation | error | config, reality, tls, target, validation, go |
| invalid fakeDNS setting | validation | error | padding, variants, validation, xmc |
| failed to parse HTTP user | validation | error | xray, config, http, json, parsing |
| Cannot get depended features | exception | error | go, xray, dependency-injection, configuration |
| unsupported domain strategy: | validation | error | config, dns, domain-strategy, socket |
| unsupported GetPrincipleTarget | exception | warning | go, xray, routing, balancer, api |
| new crypto reader | exception | error | crypto, aes, internal, go |
| Unable to parse CIDR for Fake DNS IP assignment | validation | error | padding, delay, crypto-rand, xmc |
| VLESS settings: please add/set "decryption":"none" to every… | validation | error | config, vless, outbound, decryption |
| VMess settings: "vnext" should have one and only one… | validation | error | vmess, outbound, vnext, balancer, config, validation, xray |
| failed to process mux outbound traffic | exception | error | go, xray, mux, xudp, outbound |
| failed to get outbound handler with tag | exception | error | go, xray, outbound, tag, config |
| run startup padding | exception | error | handshake, padding, version-mismatch, network, go |
| unknown format of a string list: | validation | error | config, json, validation, xray |
| failed to produce report | console | warning | go, xray, observatory, diagnostics, tls |
| invalid port range: | validation | info | config, port, dead-code, validation, xray |
| `scMaxEachPostBytes` should be bigger than 0 | panic | critical | splithttp, xhttp, panic, config, upload |
| new crypto writer | exception | error | crypto, aes, stream-cipher, unreachable-in-practice |
| Rejected by Postprocessing Stage | validation | error | xray, config, lint, postprocessing, extensibility |
| failed to parse yaml config | validation | error | config, yaml, xray, startup |
| failed to write request | exception | error | shadowsocks, network, outbound, tcp, connection-reset |
| failed to parse user | exception | error | go, xray, api, users, validation |
| Unable to create Fake Dns Engine | exception | warning | padding, chunks, validation, xmc |
| parse server public key | exception | critical | crypto, x509, rsa, config, go |
| failed to write A request payload | exception | warning | shadowsocks, network, tcp, first-payload, cipher-mismatch |
| Failed to build "downloadSettings". | validation | error | config, splithttp, download-settings, nested-config |
| failed to build IPv6 set | exception | error | geodata, ipv6, ipset, xray |
| unsupported address and port strategy: | validation | error | config, dns, srv, socket |
| invalid version component | validation | error | version, config-validation, parsing, xray |
| not a Service. | validation | error | padding, config, validation, xmc |
| unknown action | validation | error | go, xray, dns, config, validation |
| Dispatcher: Invalid destination. | validation | error | padding, config, validation, range, xmc |
| failed to create request from | exception | error | trojan, protocol, inbound, tls |
| invalid xray.tun.fd: file descriptor is not a TUN device | validation | error | tun, linux, ioctl, config, fd |
| prefix length leaves no padding record | validation | error | go, configuration, padding, protocol-framing |
| set deadline | exception | warning | go, network, deadline, handshake, xmc |
| sessionIDLength.from must be greater than 0 | validation | error | config, splithttp, session, validation |
| unsupported mode: | validation | error | config, splithttp, mode, validation |
| unknown domain type: | validation | error | geodata, protobuf, routing, enum, xray |
| failed to parse address and port | exception | error | mux, protocol, parsing, xray |
| verify token mismatch | validation | error | crypto, anti-replay, authentication, protocol-violation |
| failed to load config files: [ | console | critical | go, xray, startup, config, boot-failure |
| failed to transport all UDP request | exception | warning | shadowsocks, network, udp, relay, quic |
| invalid sudoku ascii mode | validation | error | config, validation, finalmask, sudoku |
| unable to set ips | exception | error | tun, windows, winipcfg, address, permissions |
| Number of subscribers has reached limit | exception | error | stats, pubsub, resource-limit, xray |
| Cannot start all fake dns pools | exception | warning | padding, invariant, defensive, xmc |
| failed to decode config: | validation | error | go, xray, json, config, parsing |
| read login finished | exception | error | crypto, handshake, password, network, go |
| failed to check code | exception | error | geodata, routing, config, xray |
| Metrics must have a tag or listen address. | validation | error | xray, config, metrics, observability, validation |
| can't get inbound proxy from handler. | exception | error | go, xray, api, type-assertion, inbound |
| cannot understand address | console | error | go, xray, observatory, address-parsing |
| empty balancer tag | validation | error | xray, config, routing, balancer, validation |
| empty worker list | exception | error | go, xray, reverse-proxy, mux, availability |
| failed to compute mod inverse | exception | error | go, crypto, rsa, math, invariant |
| outbound metadata not found | exception | error | go, xray, reverse-proxy, session, internal |
| unexpected HTTP status code: | http | error | go, xray, http, status-code, config |
| failed to build sniffing config | validation | error | xray, config, loopback, sniffing, wrapper-error |
| failed to create mux client worker | exception | warning | go, xray, reverse-proxy, mux, reliability |
| failed to read config: | validation | error | go, xray, config, filesystem, json |
| failed to set PROXY protocol v | exception | error | freedom, proxy-protocol, haproxy, xray |
| HTTP settings: "servers" should have one and only one… | validation | error | xray, config, http, outbound, balancing, validation |
| decode key collision for byte | exception | critical | finalmask, sudoku, internal-invariant, config |
| Failed to build Hysteria config. | validation | error | go, xray, config, hysteria, validation |
| failed to transport all UDP response | exception | warning | shadowsocks, network, udp, decryption, relay |
| failed to create hosts | exception | error | padding, validation, variants, prefix, xmc |
| generate shared secret | exception | error | crypto, entropy, sandbox, environment, go |
| Unable to locate a fake DNS Engine | exception | error | dns, fake-dns, feature-registration, config |
| failed to load code | exception | error | geodata, corruption, download, routing, xray |
| authentication rejected | validation | error | auth, handshake, password, protocol, go |
| failed to get IP address for domain | exception | error | freedom, dns, domain-strategy, xray |
| Config: unknown transport protocol: + p | validation | error | go, xray, config, validation, transport |