ErrLookup › MHSanaei/3x-ui
MHSanaei/3x-ui
Xray panel supporting multi-protocol multi-user expire day & traffic & IP limit (Vmess, Vless, Trojan, ShadowSocks, Wireguard, Hysteria, Tunnel, Mixed, HTTP, Tun, MTProto) · Go · 596 source files
Analyzed at ad32144c42 on 2026-08-15. 144 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Request failed with status ${status} | http | error | http, frontend, typescript, api-client |
| XUI_DB_TYPE=postgres but XUI_DB_DSN is empty | console | critical | database, postgres, configuration, startup |
| sqlite backup is unavailable for PostgreSQL | http | warning | database, backup, postgres, sqlite |
| database is not initialized | http | error | database, initialization, backup, sqlite |
| sqlite integrity check failed: %s | http | critical | database, sqlite, corruption, recovery |
| destination DSN is required | http | error | database, migration, postgres, configuration |
| source DSN is required | http | error | database, migration, export, configuration |
| The current username or password is invalid | validation | warning | authentication, settings, i18n, api |
| The new username and password are empty | validation | warning | validation, settings, api, authentication |
| email service not available | http | warning | email, smtp, settings, initialization |
| telegram bot disabled | http | warning | telegram, settings, bot, api |
| bot not started | http | warning | telegram, initialization, settings, bot |
| ❌ Failed to get inbounds. | exception | warning | telegram, bot, client, validation |
| tg_id must be a positive integer | validation | warning | validation, telegram, database, api |
| token not found | http | warning | api-token, validation, concurrency, api |
| node port must be 1-65535 | validation | error | node, validation, network, sync |
| HTTP %d from remote panel | http | error | node, network, http, health-check |
| remote returned success=false: {msg} | http | error | node, sync, authentication, health-check |
| node {name} is disabled | exception | warning | node, runtime, policy, api |
| node has no API token configured | exception | error | node, authentication, configuration, runtime |
| local xray is not running | exception | error | xray, runtime, startup-order, grpc |
| remote response exceeds size limit | http | error | network, size-limit, multi-node, memory-safety |
| outbound subscription response body exceeds size limit | http | error | network, size-limit, subscription, outbound |
| username can not be empty | console | warning | validation, admin, user-management |
| password can not be empty | console | warning | validation, auth, admin, user-management |
| traffic writer queue full | exception | error | concurrency, backpressure, database, sqlite, postgres |
| traffic writer stopped before write completed | exception | warning | concurrency, shutdown, lifecycle, database |
| xray is not running | exception | warning | xray, process, grpc, lifecycle |
| xray is already running | exception | warning | xray, lifecycle, concurrency |
| xray is not running | exception | info | xray, lifecycle, shutdown |
| parse XUI_PORT: %w | console | error | config, environment, startup |
| XUI_PORT must be between 1 and 65535 | console | error | config, environment, validation, startup |
| postgres unreachable after %d attempts: %w | console | critical | database, postgres, connection, startup, retry |
| sqlite backup destination already exists: %s | exception | error | database, sqlite, backup, filesystem |
| source sqlite not found at %s: %w | exception | error | database, sqlite, dump, filesystem |
| destination already exists: %s | exception | error | database, sqlite, restore, filesystem |
| restore failed: %w | exception | error | database, sqlite, restore, corruption |
| source sqlite not found at %s: %w | exception | error | database, sqlite, postgres, migration |
| open sqlite source: %w | exception | error | database, sqlite, migration, corruption, filesystem |
| open postgres destination: %w | exception | error | database, postgres, connection, migration |
| AutoMigrate %T: %w | exception | error | database, postgres, migration, schema, permissions |
| drop legacy foreign key: %w | exception | critical | database, postgres, migration, ddl, gorm |
| clear destination tables: %w | exception | critical | database, postgres, migration, truncate, locking, gorm |
| copy %T: %w | exception | critical | database, postgres, sqlite, migration, constraints, gorm |
| open postgres source: %w | console | error | database, postgres, dsn, connection, gorm |
| open sqlite destination: %w | console | error | database, sqlite, filesystem, migration |
| not a 3x-ui panel database: required table %q is missing | console | error | database, sqlite, migration, validation, file-path |
| upgrade panel schema for %T: %w | console | critical | database, sqlite, automigrate, migration, schema-upgrade |
| unsupported link scheme | validation | warning | parsing, proxy-links, validation, outbound |
| vmess decode: %w | validation | warning | parsing, proxy-links, vmess, base64 |
| vmess json: %w | validation | warning | parsing, proxy-links, vmess, json |
| not vless | validation | warning | parsing, proxy-links, vless, invariant |
| not trojan | validation | warning | parsing, proxy-links, trojan, invariant |
| bad ss host:port | validation | warning | parsing, proxy-links, shadowsocks, sip002, validation |
| bad ss port %q: %w | validation | warning | parsing, proxy-links, shadowsocks, port, validation |
| bad legacy ss | validation | warning | parsing, proxy-links, shadowsocks, legacy, base64 |
| bad legacy ss hp | validation | warning | parsing, proxy-links, shadowsocks, legacy, port |
| bad legacy ss port %q: %w | validation | warning | parsing, proxy-links, shadowsocks, legacy, port |
| not hysteria2 | validation | warning | parsing, proxy-links, hysteria2, invariant |
| not wireguard | validation | error | config-parsing, wireguard, url, outbound |
| base64 decode failed | validation | error | base64, config-parsing, subscription, encoding |
| parse proxy url: %w | validation | error | proxy, url, http-client, configuration |
| create socks5 dialer: %w | validation | error | proxy, socks5, http-client, configuration |
| unsupported proxy scheme %q | validation | error | proxy, http-client, configuration, validation |
| blocked private/internal address %s | validation | error | security, ssrf, network, dialer |
| no usable address for %s | validation | error | network, dns, dialer, configuration |
| address is required | validation | error | validation, configuration, nodes |
| invalid host %q | validation | error | validation, hostname, url, configuration |
| somethingWentWrong | http | error | api, json, http-400, nodes |
| invalid metric | http | error | api, http-400, validation, metrics, nodes |
| invalid bucket | http | error | api, http-400, validation, metrics, nodes |
| invalid bucket | http | error | api, http-400, validation, metrics |
| invalid metric | http | error | api, http-400, validation, metrics |
| invalid metric (unknown metric) | http | error | api, http-400, validation, metrics, xray |
| invalid tag (unknown observatory tag) | http | error | api, http-400, validation, xray, observatory |
| invalid filename: contains unsafe characters or path travers | validation | error | api, security, path-traversal, validation, geofile |
| invalid filename | http | error | api, http-400, security, header-injection, backup |
| invalid node port %d | validation | error | nodes, validation, multi-node, configuration |
| %s %s: %w | exception | error | network, http, node-sync, runtime, remote |
| %s %s: HTTP %d: %q | exception | error | http, auth, version-mismatch, node-sync, remote |
| %s %s: HTTP %d | exception | error | http, proxy, infrastructure, node-sync, remote |
| %s %s: %w (content-length %d, cap %d) | exception | error | http, resource-limits, node-sync, remote, payload-size |
| %s %s: %w (cap %d bytes) | exception | error | http, resource-limits, decompression, remote, payload-size |
| read body: %w | exception | error | network, io, transient, remote, timeout |
| decode envelope: %w | exception | error | json, protocol, auth, proxy, remote |
| remote inbound with tag %q not found on node %s | exception | error | node-sync, tag-mismatch, runtime, remote, reconcile |
| decode inbound list: %w | exception | error | json, version-mismatch, node-sync, remote |
| remote AddClient: resolve tag %q: %w | exception | error | node-sync, client-management, tag-mismatch, remote |
| remote DeleteUser: resolve tag %q: %w | exception | error | node-sync, client-management, reconcile, remote |
| decode web cert files: %w | exception | error | json, tls, version-mismatch, node-sync, remote |
| inbound %d: %w | exception | error | database, gorm, client-management, sqlite |
| %w for email: %s | exception | warning | client-management, idempotency, data-drift, validation |
| runtime manager not initialised | exception | error | initialization, runtime, testing, bootstrap |
| node not found | exception | error | validation, node-management, api, stale-reference |
| node is disabled | exception | error | node-management, validation, lifecycle, api |
| runtime manager unavailable | exception | error | runtime, initialization, multi-node, certificates |
| invalid outbounds JSON: %w | validation | error | json, validation, outbounds, api |
| too many outbounds in one request (max %d) | validation | warning | limits, outbounds, batching, api |
| Failed to reserve test ports: %w | exception | error | network, ports, file-descriptors, outbounds, environment |
| Failed to create test config path: %w | exception | error | filesystem, permissions, disk-full, outbounds, environment |
| Failed to start test xray instance: %w | exception | error | xray, binary, filesystem, outbounds, environment |
| outbound subscription response body exceeds size limit (limi | exception | warning | limits, subscriptions, outbounds, network |
| stopped after 10 redirects | exception | warning | network, redirects, subscriptions, ssrf |
| http %d | http | warning | http-status, network, subscriptions, authentication |
| dev release commit is unknown | exception | warning | updates, github-api, dev-channel, external-dependency |
| a panel update is already in progress | exception | warning | updates, concurrency, locking, panel-update |
| panel web update is supported only on Linux installations | exception | warning | platform, updates, panel-update, linux |
| bash is required to run the panel updater: %w | exception | error | environment, updates, bash, containers, panel-update |
| failed to start panel update job: %w: %s | exception | error | systemd, updates, panel-update, environment, linux |
| failed to start panel update job: %w | exception | error | updates, panel-update, resources, process, linux |
| download panel updater: %w | exception | error | updates, url-parsing, internal, panel-update |
| download panel updater: unexpected HTTP %d | http | error | http-status, updates, download, external-dependency, panel-update |
| write panel updater: %w | exception | error | io, download, updater, filesystem |
| panel updater download is empty | exception | error | download, updater, integrity |
| panel updater exceeds %d bytes | exception | error | download, size-limit, updater, security |
| latest panel release tag is empty | exception | error | github-api, updater, validation |
| GitHub API returned status %d: %s | http | error | github-api, rate-limit, network |
| connection has no TCP addresses | exception | warning | proxy-protocol, reality-scan, network, type-assertion |
| GitHub API error: %s | http | error | github-api, rate-limit, xray-update |
| GitHub API returned status %d: %s | http | error | github-api, network, xray-update |
| download xray: unexpected HTTP %d | http | error | xray-update, download, github-api |
| download xray: archive exceeds %d bytes | exception | error | xray-update, size-limit, download |
| Xray update aborted: the downloaded archive does not match t | exception | critical | xray-update, integrity, checksum, security |
| download xray checksum: %w | exception | error | xray-update, url, validation |
| download xray checksum: unexpected HTTP %d | exception | error | xray-update, checksum, github-api |
| xray checksum: malformed SHA2-256 entry in digest | exception | error | xray-update, checksum, parsing |
| xray checksum: no SHA2-256 entry in digest | exception | error | xray-update, checksum, parsing |
| xray version %q is not in the fetched release list | validation | error | xray-update, validation, github-api |
| xray binary exceeds %d bytes | exception | critical | xray-update, security, zip, size-limit |
| failed to generate UUID: %w | exception | error | crypto, entropy, uuid, server |
| bot not initialized | exception | error | telegram, bot, initialization |
| API unreachable: %w | exception | error | telegram, network, api |
| unsupported URL scheme %q | validation | warning | url, ssrf, validation |
| URL host is required | validation | warning | url, validation, ssrf |
| blocked private/internal address %s | validation | warning | ssrf, network, security, url |
| cannot resolve host %s: %w | validation | error | dns, network, ssrf, url |
| host %s has no IP addresses | validation | error | dns, network, ssrf |
| host %s resolves to blocked private/internal address %s | validation | warning | ssrf, dns-rebinding, security, network |
| telegram bot is not running (check token and chat ID) | exception | error | telegram, configuration, bot |
| telegram API test failed: %w | exception | error | telegram, network, wrapper |
| missing required user field %q | validation | error | xray, grpc, validation, user-management |
| invalid type for user field %q: %T | validation | error | xray, type-guard, serialization |
| wireguard publicKey: %w | validation | error | wireguard, xray, crypto, validation |
| wireguard preSharedKey: %w | validation | error | wireguard, xray, crypto, validation |