Use Smart Routing to get started, or describe your requirements to an AI assistant and import its configuration. OneXray is a client: bring your own servers.

From a requirement to a configuration

• Configure with AI：Copy a prompt or read the complete guide.
• Configuration contracts：Outbound, Custom Routing and Raw JSON: choose the right file and entry.
• Recipes：Regional routing, corporate DNS and proxy chains.
• VPN Tunnel by requirement：Platform-specific instructions, separate from JSON.
• Validate and troubleshoot：Import errors, missing data, DNS and startup.
• Versions and compatibility：Supported features and import requirements.

Use the App

Connect, Servers, Advanced, and Settings are the four root tabs. Detail pages open within the originating tab, including shared destinations such as Backup & restore; Back returns to the previous page.

• Install and first connection · First connection
• Connect and Smart Routing
• Servers and subscriptions
• Advanced settings
• Settings · Shortcuts
• Backup & restore
• Import and sharing · Updates
• Privacy · Credits and licenses

Protocols and transports: VLESS, VMessAEAD, XHTTP, Trojan, Shadowsocks, SOCKS.

OneXray at a glance

• Smart Routing: Direct regions and services with your own local DNS. Optional ad blocking, 1–3 entry servers, and a final exit for chained connections.
• Your own rules: Build domain, IP, port, and network rules with GeoData suggestions. Share a route without tying it to particular servers.
• Complete Raw JSON: Switch to expert mode for a full configuration editor. OneXray keeps control of the platform tunnel and related runtime settings.
• Servers, organized: Browse by subscription or location and compare delay and protocols. HTTPS subscriptions support optional age encryption and per-subscription HWID.
• Fits your platform: Apple route exclusions, Android per-app VPN, and Windows/Linux interfaces. Start and switch with mobile shortcuts or desktop tray menus.
• Useful local tools: See current-connection traffic, test nodes, update routing data, and inspect the generated configuration and supported local logs.

About OneXray

What is OneXray? Does it provide VPN servers?

OneXray is an open-source Xray-core client for desktop and mobile. It does not provide VPN access, servers or subscriptions; bring a compatible configuration from a source you trust, as explained in the installation guide.

Which devices and platforms does OneXray support?

OneXray supports iPhone, iPad, Mac, Android phones and tablets, Windows and Linux. On Mac, the App Store edition uses a Packet Tunnel extension and OneXraySE uses a System Extension; see the installation guide for system requirements and package differences.

How do I import servers and choose a configuration type?

Add servers from share links, HTTPS subscriptions or outbound JSON, then start with Smart Routing. Use ordinary Custom Routing for traffic rules and Advanced Custom for DNS, sniffing or local inbounds while reusing App servers. Choose full Raw JSON for your own actual nodes or fields outside the Advanced template, and check version compatibility.

Is AI built in? Are configurations sent to it automatically?

OneXray has no built-in AI service and does not automatically send configurations to an AI assistant. The AI guide provides prompts for your chosen assistant; the website does not receive configurations, so share only necessary information with a service you trust.

Do I need an account? Does OneXray collect my traffic?

OneXray requires no account, and the developer does not collect VPN traffic, browsing history, configurations or connection logs through the app. Network requests still reach your chosen servers and services under their own policies; see the privacy policy for local processing and sharing details.