OneXray

April 26, 2026 · View on GitHub

简体中文

App Introduction

Follow us on Telegram: OneXray

Documentation

First Run

Download

Operating SystemVersionCPU ArchitectureInstallation Package FormatDownload Link
WindowsWindows 10, Windows 11x86_64exeOneXray-windows-amd64.exe
WindowsWindows 10, Windows 11x86_64zipOneXray-windows-amd64.zip
AndroidAndroid 10.0 and abovearm32, arm64, x86_64aabGoogle Play Store
AndroidAndroid 10.0 and abovearm32, arm64, x86_64apkOneXray-android-universal.apk
iOSiOS 15.0 and abovearm64ipaApp Store
iOSiOS 15.0 and abovearm64ipaOneXray-ios.ipa
macOSmacOS 12.0 and aboveApple silicon, IntelpkgMac App Store
macOSmacOS 12.0 and aboveApple silicon, IntelzipOneXray-macos-universal.zip
LinuxGLIBC >= 2.39x86_64debOneXray-linux-x86_64.deb
LinuxGLIBC >= 2.39x86_64zipOneXray-linux-x86_64.zip
LinuxGLIBC >= 2.39arm64debOneXray-linux-aarch64.deb
LinuxGLIBC >= 2.39arm64zipOneXray-linux-aarch64.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.

  1. Give this project a star.
  2. Translate the app's documentation onexray.com .
  3. Share your routing settings Routing .