Follow us on Telegram: OneXray
| 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 |
The Mac App Store build is a separate store package. The outside-App-Store distribution uses the same Developer ID macos_se package for Homebrew and Universal ZIP, and installs OneXraySE.app.
brew install --cask onexrayse
brew uninstall --cask onexrayseYou can install and uninstall OneXray with winget.
winget install --id YuanDevLLC.OneXray -e
winget uninstall --id YuanDevLLC.OneXray -eIf 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 run the following setup commands 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. Build libXray for the dynamic library, and build the Xray-core CLI separately for OneXrayCore.
Replace OneXray/lib/libXray.so with the compiled product of libXray linux_so/libXray.so.
Replace OneXray/bin/OneXrayCore with the compiled Xray-core CLI.
Replace OneXray/libXray.dll with the compiled product of libXray windows_dll/libXray.dll.
Replace OneXray/bin/OneXrayCore.exe with the compiled Xray-core CLI.
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 templates Routing.