OneXray is a cross-platform Xray-core client for iOS, macOS, Android, Windows, and Linux.
The current app is organized around four primary areas:
| Area | Purpose |
|---|---|
| Home | Connection status, the selected node, VPN start and stop, and the unified node list. |
| Subscriptions | Subscription source management and per-subscription outbound node lists. |
| Core | Xray-core related settings such as TUN, Ping, Logs, Xray Profiles, and GeoData. |
| Settings | App preferences, auto update, backup, clear data, support links, credits, and privacy. |
On phones, these areas are shown in the bottom navigation. On tablets and desktops, they are shown in the side rail. Secondary pages stay scoped under the current primary area.
Download#
| Platform | Requirements | Download |
|---|---|---|
| iOS | iOS 15.0 and above, arm64 | App Store, IPA |
| macOS (Mac App Store) | macOS 12.0 and above, Apple silicon or Intel | App Store |
| macOS (Outside App Store) | macOS 12.0 and above, Apple silicon or Intel | Homebrew: brew install --cask onexrayse, Universal ZIP |
| Android | Android 10.0 and above, arm32, arm64, or x86_64 | Google Play, Universal APK |
| Windows | Windows 10 or Windows 11, x86_64 | winget: winget install --id YuanDevLLC.OneXray -e, EXE, ZIP |
| Linux x86_64 | GLIBC >= 2.39 | DEB, ZIP |
| Linux arm64 | GLIBC >= 2.39 | DEB, ZIP |
For macOS outside-App-Store distribution, Windows winget, and Linux ZIP setup, see Install.
For integration notes and exact runtime semantics, start with the AI reference and the Develop page.