An open-source Xray-core client for phones, tablets and desktops.
Download from the official stores
Linux · OneXraySE · Other downloads
If OneXray is useful to you, give this repository a ⭐ Star to support its continued development.
Bring your own servers or subscription. OneXray does not provide VPN access or proxy servers.
- Across your devices. Use iPhone, iPad, Mac, Android, Windows or Linux, with light/dark themes and five interface languages.
- Your servers, organized. Import share links, Xray JSON and subscriptions. Group manual nodes and reorder them by dragging.
- Routing you control. Choose Smart or Custom Routing, or use complete Raw and provider configurations, including Remnawave subscriptions.
- Open and private. GPL-3.0 source with a VPN provider exception, without accounts, advertising, analytics or tracking. Privacy policy.
- Install from the official store and complete setup and system permissions. Windows and Linux also need an outbound-interface selection.
- Open Servers and add your subscription, share links or Xray JSON. Complete provider configurations are recognized during subscription import.
- On Connect, choose a server or complete configuration and start the VPN. For App-managed nodes, Smart Routing is a useful starting point; provider configurations use their own routing and DNS.
First connection guide · Import guide · Remnawave guide
Choose the official store for your device:
- iPhone / iPad: App Store — iOS / iPadOS 15+.
- macOS: Mac App Store — macOS 13+, Apple silicon or Intel.
- Android phones / tablets: Google Play — Android 10+, arm64-v8a or x86_64.
- Windows: Microsoft Store — Windows 10 20H2+ (x64) or Windows 11 (ARM64).
DEB · x86_64 · DEB · arm64. Requires Linux 5.3+ and glibc 2.39+. See the Linux installation guide for dependencies and permissions.
The macOS System Extension edition is available through Homebrew or Universal ZIP. Requires macOS 13+, Apple silicon or Intel. Follow the macOS installation guide for extension approval and updates.
Direct packages and installation details
| Platform | Packages |
|---|---|
| iPhone / iPad | IPA |
| Android | Universal APK |
| Windows x64 | EXE via winget · ZIP |
| Windows ARM64 | EXE via winget · ZIP |
| Linux x86_64 | ZIP |
| Linux arm64 | ZIP |
The installation guide covers IPA signing, Windows editions and separate data locations, ZIP permissions and updates. All releases.
- User documentation — setup, routing, subscriptions and platform features.
- Configure with AI — copy the guide's prompt into an assistant you trust, or attach the complete guide. OneXray has no built-in AI service and does not send configurations to an assistant; review generated JSON in the App before connecting.
- Report a bug or request a feature — include your platform, App/Core versions and reproduction steps. Remove credentials from shared configurations, subscription links and logs.
- Telegram community.
Enjoy OneXray? Give this repository a ⭐ Star to support its continued development.
App Store · Google Play · Microsoft Store
Code, translations and documentation contributions are welcome. Start with the development setup, build guide and App contracts.
OneXray is licensed under the GNU General Public License v3.0, with the OneXray VPN Provider Exception.
VPN service providers may build and distribute customized, closed-source clients for their own VPN services without complying with the repository's GPL requirements for the code covered by the exception. Other uses remain subject to the GPL or another applicable permission.
Yuan Dev Team guarantees that it will not introduce direct third-party dependencies that require a qualifying customized client as a whole to be GPL-licensed or to disclose its source code under the GPL. Third-party licenses and their component-specific obligations still apply; the exception only covers rights Yuan Dev Team owns or is authorized to license.
For business partnerships, please email yuan@yuandev.net.