Home is the main operating surface for connection state and node operation.
It prioritizes the current VPN state, selected node, start/stop control, traffic entry, location entry, and the Outbound / Raw Json node lists. Full node details are shown on the Node Info page instead of occupying the Home workspace.
Configuration changes are applied the next time the VPN starts. If the VPN is already running, edit the configuration, stop the VPN, and start it again.
Configuration Types#
| Type | Purpose | Where it belongs |
|---|---|---|
| Outbound | A single Xray outbound node such as VLESS, VMess, Trojan, Shadowsocks, SOCKS, HTTP, or Hysteria2. | Home node list and subscriptions. |
| Raw Json | A complete Xray JSON document imported and edited as text. | Local Raw Json list only. |
| Xray Setting | A structured reusable Xray configuration generated by OneXray UI pages. | Core > Xray Settings. |
| Simple | A built-in Xray Setting writer. | Core > Xray Settings > Simple. |
Recommended Flow#
- Add an outbound node or subscription.
- Keep the node’s Xray Setting as
Simple. - Adjust Simple Setting only when you need a different direct region, FakeDNS, chain proxy, DNS query strategy, or log level.
- Start the VPN from the Home page.
Node Lists#
Outbound nodes use subscription grouping where applicable. Raw Json is always shown under Local and is not created by subscriptions.
The node list uses a compact adaptive grid. On desktop, the content width is capped so cards remain readable.
Status and Testing#
When the VPN starts, OneXray writes an Xray config file into the app runtime directory and starts the platform network tunnel. After startup, the app can test latency and node IP information. Ping settings are shared by manual ping, subscription auto-ping, and post-start checks.