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. 138 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| traffic writer queue full | exception | error | concurrency, backpressure, database, sqlite, postgres |
| Request failed with status | http | error | http, frontend, typescript, api-client |
| failed to start panel update job | exception | error | systemd, updates, panel-update, environment, linux |
| drop legacy foreign key | exception | critical | database, postgres, migration, ddl, gorm |
| invalid filename | http | error | api, http-400, security, header-injection, backup |
| remote returned success=false | http | error | node, sync, authentication, health-check |
| outbound subscription response body exceeds size limit | http | error | network, size-limit, subscription, outbound |
| outbound subscription response body exceeds size limit | exception | warning | limits, subscriptions, outbounds, network |
| create socks5 dialer | validation | error | proxy, socks5, http-client, configuration |
| parse proxy url | validation | error | proxy, url, http-client, configuration |
| token not found | http | warning | api-token, validation, concurrency, api |
| GitHub API error | http | error | github-api, rate-limit, xray-update |
| local xray is not running | exception | error | xray, runtime, startup-order, grpc |
| no usable address for | validation | error | network, dns, dialer, configuration |
| invalid filename: contains unsafe characters or path… | validation | error | api, security, path-traversal, validation, geofile |
| base64 decode failed | validation | error | base64, config-parsing, subscription, encoding |
| not a 3x-ui panel database: required table | console | error | database, sqlite, migration, validation, file-path |
| copy %T | exception | critical | database, postgres, sqlite, migration, constraints, gorm |
| xray version is not in the fetched release list | validation | error | xray-update, validation, github-api |
| panel updater exceeds | exception | error | download, size-limit, updater, security |
| xray binary exceeds bytes | exception | critical | xray-update, security, zip, size-limit |
| node has no API token configured | exception | error | node, authentication, configuration, runtime |
| host resolves to blocked private/internal address | validation | warning | ssrf, dns-rebinding, security, network |
| %s %s: %w | exception | error | network, http, node-sync, runtime, remote |
| ❌ Failed to get inbounds. | exception | warning | telegram, bot, client, validation |
| not wireguard | validation | error | config-parsing, wireguard, url, outbound |
| download xray: unexpected HTTP | http | error | xray-update, download, github-api |
| clear destination tables | exception | critical | database, postgres, migration, truncate, locking, gorm |
| : HTTP | exception | error | http, auth, version-mismatch, node-sync, remote |
| invalid bucket | http | error | api, http-400, validation, metrics |
| blocked private/internal address | validation | error | security, ssrf, network, dialer |
| remote response exceeds size limit | http | error | network, size-limit, multi-node, memory-safety |
| dev release commit is unknown | exception | warning | updates, github-api, dev-channel, external-dependency |
| download xray checksum | exception | error | xray-update, url, validation |
| latest panel release tag is empty | exception | error | github-api, updater, validation |
| Failed to reserve test ports | exception | error | network, ports, file-descriptors, outbounds, environment |
| somethingWentWrong | http | error | api, json, http-400, nodes |
| sqlite integrity check failed | http | critical | database, sqlite, corruption, recovery |
| traffic writer stopped before write completed | exception | warning | concurrency, shutdown, lifecycle, database |
| Xray update aborted: the downloaded archive does not match… | exception | critical | xray-update, integrity, checksum, security |
| node is disabled | exception | warning | node, runtime, policy, api |
| runtime manager not initialised | exception | error | initialization, runtime, testing, bootstrap |
| xray checksum: no SHA2-256 entry in digest | exception | error | xray-update, checksum, parsing |
| invalid node port | validation | error | nodes, validation, multi-node, configuration |
| invalid outbounds JSON | validation | error | json, validation, outbounds, api |
| download xray: archive exceeds | exception | error | xray-update, size-limit, download |
| tg_id must be a positive integer | validation | warning | validation, telegram, database, api |
| bot not started | http | warning | telegram, initialization, settings, bot |
| connection has no TCP addresses | exception | warning | proxy-protocol, reality-scan, network, type-assertion |
| a panel update is already in progress | exception | warning | updates, concurrency, locking, panel-update |
| email service not available | http | warning | email, smtp, settings, initialization |
| The new username and password are empty | validation | warning | validation, settings, api, authentication |
| GitHub API returned status | http | error | github-api, network, xray-update |
| The current username or password is invalid | validation | warning | authentication, settings, i18n, api |
| unsupported URL scheme | validation | warning | url, ssrf, validation |
| invalid tag (unknown observatory tag) | http | error | api, http-400, validation, xray, observatory |
| missing required user field | validation | error | xray, grpc, validation, user-management |
| postgres unreachable after | console | critical | database, postgres, connection, startup, retry |
| restore failed | exception | error | database, sqlite, restore, corruption |
| write panel updater | exception | error | io, download, updater, filesystem |
| AutoMigrate %T | exception | error | database, postgres, migration, schema, permissions |
| open sqlite destination | console | error | database, sqlite, filesystem, migration |
| remote inbound with tag | exception | error | node-sync, tag-mismatch, runtime, remote, reconcile |
| telegram bot disabled | http | warning | telegram, settings, bot, api |
| invalid metric (unknown metric) | http | error | api, http-400, validation, metrics, xray |
| source DSN is required | http | error | database, migration, export, configuration |
| HTTP from remote panel | http | error | node, network, http, health-check |
| failed to generate UUID | exception | error | crypto, entropy, uuid, server |
| http | http | warning | http-status, network, subscriptions, authentication |
| cannot resolve host | validation | error | dns, network, ssrf, url |
| stopped after 10 redirects | exception | warning | network, redirects, subscriptions, ssrf |
| failed to start panel update job | exception | error | updates, panel-update, resources, process, linux |
| bad ss host:port | validation | warning | parsing, proxy-links, shadowsocks, sip002, validation |
| bad ss port | validation | warning | parsing, proxy-links, shadowsocks, port, validation |
| runtime manager unavailable | exception | error | runtime, initialization, multi-node, certificates |
| inbound | exception | error | database, gorm, client-management, sqlite |
| upgrade panel schema for %T | console | critical | database, sqlite, automigrate, migration, schema-upgrade |
| sqlite backup is unavailable for PostgreSQL | http | warning | database, backup, postgres, sqlite |
| Failed to create test config path | exception | error | filesystem, permissions, disk-full, outbounds, environment |
| address is required | validation | error | validation, configuration, nodes |
| node port must be 1-65535 | validation | error | node, validation, network, sync |
| not vless | validation | warning | parsing, proxy-links, vless, invariant |
| parse XUI_PORT | console | error | config, environment, startup |
| decode envelope | exception | error | json, protocol, auth, proxy, remote |
| : (content-length , cap ) | exception | error | http, resource-limits, node-sync, remote, payload-size |
| invalid metric | http | error | api, http-400, validation, metrics, nodes |
| database is not initialized | http | error | database, initialization, backup, sqlite |
| unsupported link scheme | validation | warning | parsing, proxy-links, validation, outbound |
| vmess decode | validation | warning | parsing, proxy-links, vmess, base64 |
| vmess json | validation | warning | parsing, proxy-links, vmess, json |
| open postgres source | console | error | database, postgres, dsn, connection, gorm |
| password can not be empty | console | warning | validation, auth, admin, user-management |
| wireguard publicKey | validation | error | wireguard, xray, crypto, validation |
| xray is already running | exception | warning | xray, lifecycle, concurrency |
| XUI_DB_TYPE=postgres but XUI_DB_DSN is empty | console | critical | database, postgres, configuration, startup |
| download xray checksum: unexpected HTTP | exception | error | xray-update, checksum, github-api |
| Failed to start test xray instance | exception | error | xray, binary, filesystem, outbounds, environment |
| remote DeleteUser: resolve tag | exception | error | node-sync, client-management, reconcile, remote |
| invalid host | validation | error | validation, hostname, url, configuration |
| bot not initialized | exception | error | telegram, bot, initialization |