OneXray

June 26, 2026 · View on GitHub

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

Notes

iOS

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.

Linux

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/OneXrayCore

If 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 onexray

If 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.

Kernel Upgrade

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.

Linux

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.

Windows

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.

Contribution

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 .