mirror of
https://github.com/XTLS/Xray-core.git
synced 2025-06-26 21:24:14 +00:00
Xray, Penetrates Everything. Also the best v2ray-core, with XTLS support. Fully compatible configuration.
anticensorshipdnsnetworkproxyrealityshadowsockssocks5tlstrojantunnelutlsvlessvmessvpnwireguardxrayxtlsxudp
fix(proxy/freedom): prevent crash when passthrough is "origin" or "srcip" In certain routing scenarios, outbound detour tags like "origin" or "srcip" may be assigned to freedom handlers without proper initialization, causing nil pointer dereference during Dial(). This patch adds guard checks to ensure the outbound handler is valid before dialing, and improves fallback logic for local address passthrough (e.g., 127.0.0.1) to avoid kernel crashes. Also ensures `sendThrough` behavior gracefully degrades if loopback or empty DNS response is encountered. |
||
---|---|---|
.github | ||
app | ||
common | ||
core | ||
features | ||
infra | ||
main | ||
proxy | ||
testing | ||
transport | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
go.mod | ||
go.sum | ||
LICENSE | ||
README.md |
Project X
Project X originates from XTLS protocol, providing a set of network tools such as Xray-core and REALITY.
README is open, so feel free to submit your project here.
Donation & NFTs
- ETH/USDT/USDC:
0xDc3Fe44F0f25D13CACb1C4896CD0D321df3146Ee
- Project X NFT: Announcement of NFTs by Project X
- REALITY NFT: XHTTP: Beyond REALITY
License
Mozilla Public License Version 2.0
Documentation
Telegram
Project VLESS (Русский)
Project XHTTP (Persian)
Installation
- Linux Script
- XTLS/Xray-install (Official)
- tempest (supports
systemd
and OpenRC; Linux-only)
- Docker
- Web Panel - WARNING: Please DO NOT USE plain HTTP panels like 3X-UI, as they are believed to be bribed by Iran GFW for supporting plain HTTP by default and refused to change (https://github.com/XTLS/Xray-core/pull/3884#issuecomment-2439595331), which has already put many users' data security in danger in the past few years. If you are already using 3X-UI, please switch to the following panels, which are verified to support HTTPS and SSH port forwarding only:
- One Click
- Magisk
- Homebrew
brew install xray
Usage
- Example
- Xray-examples
- Tutorial
GUI Clients
- OpenWrt
- Asuswrt-Merlin
- Windows
- Android
- iOS & macOS arm64
- macOS arm64 & x64
- Linux
Others that support VLESS, XTLS, REALITY, XUDP, PLUX...
- iOS & macOS arm64
- Xray Tools
- Xray Wrapper
- XrayR
- Cores
Contributing
Credits
- Xray-core v1.0.0 was forked from v2fly-core 9a03cc5, and we have made & accumulated a huge number of enhancements over time, check the release notes for each version.
- For third-party projects used in Xray-core, check your local or the latest go.mod.
One-line Compilation
Windows (PowerShell)
$env:CGO_ENABLED=0
go build -o xray.exe -trimpath -buildvcs=false -ldflags="-s -w -buildid=" -v ./main
Linux / macOS
CGO_ENABLED=0 go build -o xray -trimpath -buildvcs=false -ldflags="-s -w -buildid=" -v ./main
Reproducible Releases
Make sure that you are using the same Go version, and remember to set the git commit id (7 bytes):
CGO_ENABLED=0 go build -o xray -trimpath -buildvcs=false -ldflags="-X github.com/xtls/xray-core/core.build=REPLACE -s -w -buildid=" -v ./main