reality-inbound

Creates and repairs VLESS-REALITY inbounds on a 3x-ui panel with verified camouflage targets.

5|3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/pyworkload/3x-ui-mcp --skill reality-inbound-pyworkload
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reality-inbound
Source: https://github.com/pyworkload/3x-ui-mcp/tree/main/skills/reality-inbound
Command: npx skills add https://github.com/pyworkload/3x-ui-mcp --skill reality-inbound-pyworkload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a VLESS-REALITY inbound on a 3x-ui panel fails silently when the camouflage target (dest/SNI) is poorly chosen, and the panel does not validate that choice for you. This Skill walks through target selection, key generation, inbound creation, and client provisioning so the resulting configuration actually passes traffic. ## Core Features & Use Cases - Target verification: Scans candidate camouflage targets for TLS 1.3, HTTP/2 ALPN, X25519 support, and trusted certificate chains, ranking them by feasibility and latency. - Complete inbound setup: Generates X25519 keys, builds valid shortIds, creates the VLESS-REALITY inbound with correct streamSettings, and attaches a client with the xtls-rprx-vision flow. - Repair workflow: Diagnoses an existing REALITY inbound that stopped working by re-scanning its dest and updating dest and serverNames together. - Use Case: You need a stealth VLESS inbound on a fresh VPS. The Skill scans the VPS's own subnet for low-latency, unpopular TLS targets, picks one, and hands back a working client link. ## Quick Start Ask the agent to set up a new REALITY inbound on your 3x-ui panel and give you the client connection link.

Frequently Asked Questions about reality-inbound

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a VLESS REALITY inbound on 3x-ui?▼

Scan candidate camouflage targets with scan_reality_targets, generate an X25519 key pair, then create the inbound with protocol vless, security reality, and the target's host:port as dest. Finally add a client with flow xtls-rprx-vision and retrieve the connection link.

How to choose a good REALITY dest target?▼

A valid REALITY dest must support TLS 1.3, HTTP/2 in ALPN, X25519 key exchange, and a trusted certificate chain. Avoid CDN-fronted sites, major domains like google.com or apple.com, and anything blocked in your users' region; prefer low-latency hosts near your VPS.

Why did my REALITY inbound stop working?▼

The most common cause is the camouflage target changing: losing HTTP/2, moving behind a CDN, or serving a certificate that no longer covers your serverNames. Re-scan the current dest and update dest and serverNames together if it now fails.

Can I use xtls-rprx-vision flow with WebSocket or gRPC?▼

No, the xtls-rprx-vision flow is valid only on TCP-based VLESS inbounds. Setting it on ws, grpc, or xhttp clients causes connection failures that look like a server-side problem.

What are valid shortIds for a REALITY inbound?▼

shortIds must be hex strings of even length, at most 16 characters, and the array itself must not be empty or Xray refuses to start. An empty string inside the array is legal and admits clients that send no shortId.

Does REALITY target scanning work on older 3x-ui panels?▼

The scan_reality_target and scan_reality_targets tools require panel version 3.4.2 or newer. On older panels they return 404, so you must pick the target manually against the same TLS and certificate criteria.