xrat - Xray-core and sing-box proxy manager

xrat is an open-source Rust CLI and TUI proxy configuration manager for XTLS/Xray-core, V2Ray-core, and SagerNet/sing-box. Import proxy subscriptions, test latency, scan Cloudflare/CDN edge IPs, rotate proxies, and run managed local proxy sessions from a single terminal application.

xrat is built for VLESS, VMess, Trojan, Shadowsocks, SOCKS5, HTTP, and Hysteria2 workflows. It can preview Xray and sing-box JSON, expose local SOCKS/HTTP/Shadowsocks inbounds, supervise runtime sessions with a daemon, and serve stored configs through an authenticated HTTP API.

What you can do

• Import subscriptions, files, raw links, base64 lists, SIP008 JSON, and Xray JSON into SQLite or PostgreSQL.
• Support VLESS, VMess, Trojan, Shadowsocks, HTTP, SOCKS5, and Hysteria2 parsing/preview.
• Deduplicate configs with normalized, versioned keys while preserving subscription metadata.
• Test proxies with ICMP, TCP, real-delay, download, and upload stages.
• Rank bulk test results with concurrency control, failure classification, history, and GeoIP enrichment.
• Run Xray-core, V2Ray-core, or sing-box-backed Hysteria2 as a managed local proxy runtime.
• Expose SOCKS5, HTTP, and Shadowsocks inbounds with configurable ports and sniffing.
• Supervise runtime sessions through a daemon with IPC, health checks, and stale-session reattach.
• Rotate proxies automatically on schedule or health failure, with cooldown and manual override.
• Scan Cloudflare/CDN edge IPs and persist reachable endpoints with latency.
• Control configs through CLI, interactive TUI, HTTP API, or systemd user services.
• Serve stored configs as JSON or base64 subscriptions with optional API-key authentication.
• Manage config state with enable, disable, soft delete, restore, purge, and detailed show commands.
• Inspect operational events with xrat logs for daemon, runtime, rotation, health, and test activity.
• Generate shell completions, man pages, Docker images, and self-upgrade from releases or source.

SagerNet/sing-box support covers sing-box JSON preview and managed Hysteria2 runtime sessions. Hy2 configs automatically launch through sing-box because Xray/V2Ray cannot express that protocol; other managed runtime protocols still use Xray/V2Ray unless [runtime].engine selects a supported engine.

Sections