Repository files navigation

简体中文

This is a wrapper aroundXray-core to improve the client development experience.

1. This repository has few maintainers. If you do not report a bug or initiate a PR, your issue will be ignored.
2. This repository does not guarantee API stability, you need to adapt it yourself.
3. This repository is only compatible with the latest release of Xray-core.

Compile script. It is recommended to always use this script to compile libXray. We will not answer questions caused by using other compilation methods.

You need to put Xray-core and libXray in the same directory to compile.

python3 build/main.py androidpython3 build/main.py apple gomobilepython3 build/main.py apple gopython3 build/main.py linuxpython3 build/main.py windows

usegomobile .

Need "iOS Simulator Runtime".

This is the best choice for general scenarios and will not conflict with other frameworks.

Supports iOS, iOSSimulator, macOS, macCatalyst.

But it is not possible to set the minimum macOS version, which will cause some warnings when compiling. And it does not support tvOS.

Need "iOS Simulator Runtime" and "tvOS Simulator Runtime".

Support more compilation options, output c header files.

This works well when you use ffi for integration. For example, integration with swift, kotlin, dart.

Support iOS, iOSSimulator, macOS, tvOS.

Note: The productLibXray.xcframework does not containmodule.modulemap. When using swift, you need to create a bridge file.

depend on gcc and g++.

depend onLLVM MinGW, you can install it using winget.

winget install MartinStorsjo.LLVM-MinGW.UCRT

Used to solve the socket protect problem on Android.

Used to solve server address resolution issues on Android, Linux, and Windows. If not handled, the DNS traffic will be resent to the tun device, resulting in failure to initiate a connection.

Read geo files and count the categories and rules.

Read the Xray Json configuration and extract the geo file name used.

Read the Xray Json configuration and cut the geo file used.

Download geosite.dat and geoip.dat and count them.

Only executed on iOS, GC is initiated once a second. This can alleviate memory pressure on iOS.

Write data to a file.

Speed ​​test the Xray configuration.

The response body of the wrapper interface.

Get free ports.

libXray usessendThrough to store outbound names.

Parse Clash.Meta configuration.

convert Xray Json to VMessAEAD/VLESS sharing protocol.

convert VMessAEAD/VLESS sharing protocol to Xray Json.

convert VMessQRCode to Xray Json.

convert VMessQRCode to Xray Json.

Some tools used to parse shared links.

Latency testing.

Refer to the following configuration:

{"metrics" : {"tag" :"metrics","listen":"[::1]:49227",  },"policy" : {"system" : {"statsInboundDownlink" :true,"statsInboundUplink" :true,"statsOutboundDownlink" :true,"statsOutboundUplink" :true    }  },"stats" : {}}

Note:

1. When testing latency or validating configuration, make suremetrics isnull.

2. When enabling metrics, the Xray-core instance needs to be run in achild process.

Verify the Xray configuration.

Start and stop Xray instances.

export nodep.

export xray.

Project X

VMessPing

FreePort

This repository is based on the MIT License.