Follow us on Telegram: OneXray
| Platform | Requirements | Download |
|---|---|---|
| iOS | iOS 15.0 and above, arm64 | App Store, IPA |
| macOS | macOS 12.0 and above, Apple silicon or Intel | Mac App Store, 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 | EXE, ZIP |
| Linux x86_64 | GLIBC >= 2.39 | DEB, ZIP |
| Linux arm64 | GLIBC >= 2.39 | DEB, ZIP |
Desktop packages include the onexray CLI. It talks to the running app through the local Automation API, so OneXray must be open before using CLI commands.
onexray health
onexray status
onexray import --file /path/to/import.txt
onexray import --text 'vless://...'
cat import.txt | onexray import --file -
onexray debug session
onexray vpn start
onexray vpn start --id 123
onexray vpn stoponexray import accepts OneXray URL Scheme links, HTTPS subscription URLs, Xray share links, multi-line share text, Clash.Meta YAML, and Xray JSON text supported by the bundled libXray API. --file reads text files; QR image import is available from the app UI.
For exact command options, import payloads, session paths, and Automation API details, see Develop and AI Reference.
If you don't have an Apple ID, or your Apple ID cannot download OneXray, you can download OneXray-ios.ipa and then use AltStore or other third-party tools to install it.
If you use the zip package, you need to make the following settings to use OneXray normally.
Please confirm the directory before executing the command.
sudo apt install -y procps libcap2-bin libayatana-appindicator3-1
sudo setcap cap_net_admin,cap_net_raw+eip OneXray/bin/OneXrayCoreIf you use the deb package, you can use the following commands to install and uninstall.
sudo apt install ./OneXray-linux-x86_64.deb
sudo apt remove onexrayIf your desktop environment is gnome, please install the AppIndicator extension.
If your machine's CPU architecture is Arm64, switching the language to a CJK language (Chinese, Japanese, or Korean) will cause OneXray to reset the interface language to English.
On Linux and Windows platforms, you can upgrade or replace Xray-core yourself. You can compile it using the build script according to the instructions in libXray.
Replace OneXray/lib/libXray.so with the compiled product of libXray linux_so/libXray.so.
Replace OneXray/bin/OneXrayCore with the compiled product of libXray bin/xray.
Replace OneXray/libXray.dll with the compiled product of libXray windows_dll/libXray.dll.
Replace OneXray/bin/OneXrayCore.exe with the compiled product of libXray bin/xray.exe.
If this project is helpful to you, you can consider contributing to this project in the following ways.
- Give this project a star.
- Translate the app's documentation onexray.com .
- Share your routing settings Routing .