mirror of
https://github.com/XTLS/Xray-core.git
synced 2026-11-20 16:49:12 +00:00
Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3e2b8ef1ad | ||
|
|
153eb771ac | ||
|
|
2a351fe2aa | ||
|
|
b1ef448a88 | ||
|
|
02decee3d2 | ||
|
|
9af8bb7f05 | ||
|
|
939ca80bed |
@@ -0,0 +1,5 @@
|
|||||||
|
<!--
|
||||||
|
Read CONTRIBUTING.md before opening a pull request.
|
||||||
|
Human-led pull requests can use a normal description.
|
||||||
|
For agent-led pull requests, disclose each AI tool and model, then paste the complete conversation directly in a collapsed <details> block in this PR body. External transcript links are not accepted.
|
||||||
|
-->
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# Contributing to Xray-core
|
||||||
|
|
||||||
|
We review pull requests that address a concrete problem or an agreed proposal. Please keep each change focused and provide evidence that maintainers can check.
|
||||||
|
|
||||||
|
## Bug fixes
|
||||||
|
|
||||||
|
A bug-fix pull request must link an existing issue filed using the issue template. Summarize the code change and verification in the pull request, and add a regression test when practical. A speculative fix without a demonstrated problem is not ready for a pull request. Report security vulnerabilities through [the security policy](SECURITY.md) rather than a public issue.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
Propose the use case and intended design in an issue before implementing it. Wait for a maintainer to accept the proposal. Explain how the change fits the existing architecture and any compatibility impact.
|
||||||
|
|
||||||
|
## Refactors
|
||||||
|
|
||||||
|
Propose the scope in an issue and wait for maintainer acceptance before implementing it. Show which complexity the change removes and why the resulting design is easier to understand. Prefer a reduction in code and moving parts, but line count alone is not the review criterion. Preserve observable behavior and test both old-to-new and new-to-old client/server connections when protocol or network behavior is affected.
|
||||||
|
|
||||||
|
## AI involvement and author responsibility
|
||||||
|
|
||||||
|
AI assistance does not require a conversation record when the author selects or verifies the problem, directs the approach, reviews every changed line, verifies the result, and personally responds to review feedback. The author must be able to explain every changed line and maintain the change. A pull request meeting these conditions is considered human-led, regardless of whether AI wrote the code or who pushed the commits. Such pull requests may ignore the agent-led requirements below.
|
||||||
|
|
||||||
|
If an AI agent independently selected the task or made key implementation decisions without ongoing human direction, the pull request is agent-led even if a person submits it manually. Disclose each tool and model and paste the complete prompt-and-response record for every session used for the pull request, including retries and changes after review feedback, inside a collapsed `<details>` block in the pull request description. External links, summaries, and selected excerpts are insufficient. A transcript does not replace the author's review, verification, or responsibility for responding to maintainers.
|
||||||
|
|
||||||
|
In agent-led pull requests, commits containing AI-generated changes must credit the specific LLM as their author or co-author.
|
||||||
|
|
||||||
|
We do not oppose the use of AI, but agent-led pull requests must have a human author who responds to maintainer feedback for several weeks after submission. Dishonest declarations, fabricated verification, intentionally incomplete records, or abandoning an agent-led pull request are prohibited and may result in being blocked from contributing to Xray-core.
|
||||||
|
|
||||||
|
## Review
|
||||||
|
|
||||||
|
Maintainers may ask for missing evidence before reviewing code or close a pull request that is outside the agreed scope. The contributor is responsible for understanding, testing, and explaining the change, regardless of the tools used to produce it.
|
||||||
@@ -41,10 +41,10 @@
|
|||||||
|
|
||||||
## Telegram
|
## Telegram
|
||||||
|
|
||||||
[Project X](https://t.me/projectXray)
|
|
||||||
|
|
||||||
[Project X Channel](https://t.me/projectXtls)
|
[Project X Channel](https://t.me/projectXtls)
|
||||||
|
|
||||||
|
[Project X](https://t.me/projectXray) (中文 / English)
|
||||||
|
|
||||||
[Project VLESS](https://t.me/projectVless) (Русский)
|
[Project VLESS](https://t.me/projectVless) (Русский)
|
||||||
|
|
||||||
[Project XHTTP](https://t.me/projectXhttp) (Persian)
|
[Project XHTTP](https://t.me/projectXhttp) (Persian)
|
||||||
@@ -53,7 +53,6 @@
|
|||||||
|
|
||||||
- Linux Script
|
- Linux Script
|
||||||
- [XTLS/Xray-install](https://github.com/XTLS/Xray-install) (**Official**)
|
- [XTLS/Xray-install](https://github.com/XTLS/Xray-install) (**Official**)
|
||||||
- [tempest](https://github.com/team-cloudchaser/tempest) (supports [`systemd`](https://systemd.io) and [OpenRC](https://github.com/OpenRC/openrc); Linux-only)
|
|
||||||
- Docker
|
- Docker
|
||||||
- [ghcr.io/xtls/xray-core](https://ghcr.io/xtls/xray-core) (**Official**)
|
- [ghcr.io/xtls/xray-core](https://ghcr.io/xtls/xray-core) (**Official**)
|
||||||
- [teddysun/xray](https://hub.docker.com/r/teddysun/xray)
|
- [teddysun/xray](https://hub.docker.com/r/teddysun/xray)
|
||||||
@@ -69,12 +68,10 @@
|
|||||||
- [TX-UI](https://github.com/AghayeCoder/tx-ui)
|
- [TX-UI](https://github.com/AghayeCoder/tx-ui)
|
||||||
- [CELERITY](https://github.com/ClickDevTech/CELERITY-panel)
|
- [CELERITY](https://github.com/ClickDevTech/CELERITY-panel)
|
||||||
- One Click
|
- One Click
|
||||||
- [Xray-REALITY](https://github.com/zxcvos/Xray-script), [xray-reality](https://github.com/sajjaddg/xray-reality), [reality-ezpz](https://github.com/aleskxyz/reality-ezpz)
|
- [xray-reality](https://github.com/sajjaddg/xray-reality), [Xray_bash_onekey](https://github.com/hello-yunshu/Xray_bash_onekey)
|
||||||
- [Xray_bash_onekey](https://github.com/hello-yunshu/Xray_bash_onekey), [XTool](https://github.com/LordPenguin666/XTool), [VPainLess](https://github.com/vpainless/vpainless)
|
- [v2ray-agent](https://github.com/mack-a/v2ray-agent), [Xray_onekey](https://github.com/wulabing/Xray_onekey)
|
||||||
- [v2ray-agent](https://github.com/mack-a/v2ray-agent), [Xray_onekey](https://github.com/wulabing/Xray_onekey), [ProxySU](https://github.com/proxysu/ProxySU)
|
|
||||||
- Magisk
|
- Magisk
|
||||||
- [Magic_V2Ray](https://github.com/vincentng295/Magic_V2Ray)
|
- [Magic_V2Ray](https://github.com/vincentng295/Magic_V2Ray)
|
||||||
- [Xray_For_Magisk](https://github.com/E7KMbb/Xray_For_Magisk)
|
|
||||||
- Homebrew
|
- Homebrew
|
||||||
- `brew install xray`
|
- `brew install xray`
|
||||||
|
|
||||||
@@ -86,14 +83,7 @@
|
|||||||
- [All-in-One-fallbacks-Nginx](https://github.com/XTLS/Xray-examples/tree/main/All-in-One-fallbacks-Nginx)
|
- [All-in-One-fallbacks-Nginx](https://github.com/XTLS/Xray-examples/tree/main/All-in-One-fallbacks-Nginx)
|
||||||
- Xray-examples
|
- Xray-examples
|
||||||
- [XTLS/Xray-examples](https://github.com/XTLS/Xray-examples)
|
- [XTLS/Xray-examples](https://github.com/XTLS/Xray-examples)
|
||||||
- [chika0801/Xray-examples](https://github.com/chika0801/Xray-examples)
|
|
||||||
- [lxhao61/integrated-examples](https://github.com/lxhao61/integrated-examples)
|
- [lxhao61/integrated-examples](https://github.com/lxhao61/integrated-examples)
|
||||||
- Tutorial
|
|
||||||
- [XTLS Vision](https://github.com/chika0801/Xray-install)
|
|
||||||
- [REALITY (English)](https://cscot.pages.dev/2023/03/02/Xray-REALITY-tutorial/)
|
|
||||||
- [XTLS-Iran-Reality (English)](https://github.com/SasukeFreestyle/XTLS-Iran-Reality)
|
|
||||||
- [Xray REALITY with 'steal oneself' (English)](https://computerscot.github.io/vless-xtls-utls-reality-steal-oneself.html)
|
|
||||||
- [Xray with WireGuard inbound (English)](https://g800.pages.dev/wireguard)
|
|
||||||
|
|
||||||
## GUI Clients
|
## GUI Clients
|
||||||
|
|
||||||
@@ -106,43 +96,31 @@
|
|||||||
- [fancyss](https://github.com/hq450/fancyss)
|
- [fancyss](https://github.com/hq450/fancyss)
|
||||||
- Windows
|
- Windows
|
||||||
- [v2rayN](https://github.com/2dust/v2rayN)
|
- [v2rayN](https://github.com/2dust/v2rayN)
|
||||||
- [Furious](https://github.com/LorenEteval/Furious)
|
|
||||||
- [Invisible Man - Xray](https://github.com/InvisibleManVPN/InvisibleMan-XRayClient)
|
|
||||||
- [AnyPortal](https://github.com/AnyPortal/AnyPortal)
|
|
||||||
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
||||||
- [OneXray](https://github.com/OneXray/OneXray)
|
- [OneXray](https://github.com/OneXray/OneXray)
|
||||||
- [XrayUI-dev](https://github.com/PhoenixNil/XrayUI-dev)
|
- [XrayUI-dev](https://github.com/PhoenixNil/XrayUI-dev)
|
||||||
- Android
|
- Android
|
||||||
- [v2rayNG](https://github.com/2dust/v2rayNG)
|
- [v2rayNG](https://github.com/2dust/v2rayNG)
|
||||||
- [X-flutter](https://github.com/XTLS/X-flutter)
|
|
||||||
- [SaeedDev94/Xray](https://github.com/SaeedDev94/Xray)
|
- [SaeedDev94/Xray](https://github.com/SaeedDev94/Xray)
|
||||||
- [SimpleXray](https://github.com/lhear/SimpleXray)
|
- [SimpleXray](https://github.com/lhear/SimpleXray)
|
||||||
- [XrayFA](https://github.com/Q7DF1/XrayFA)
|
- [XrayFA](https://github.com/Q7DF1/XrayFA)
|
||||||
- [AnyPortal](https://github.com/AnyPortal/AnyPortal)
|
|
||||||
- [OneXray](https://github.com/OneXray/OneXray)
|
- [OneXray](https://github.com/OneXray/OneXray)
|
||||||
- [AsteriskNG](https://github.com/Asterisk4Magisk/AsteriskNG)
|
- [AsteriskNG](https://github.com/Asterisk4Magisk/AsteriskNG)
|
||||||
- iOS & macOS arm64 & tvOS
|
- iOS & macOS arm64 & tvOS
|
||||||
- [Happ](https://apps.apple.com/app/happ-proxy-utility/id6504287215) | [Happ RU](https://apps.apple.com/ru/app/happ-proxy-utility-plus/id6746188973) | [Happ tvOS](https://apps.apple.com/us/app/happ-proxy-utility-for-tv/id6748297274)
|
- [Happ](https://apps.apple.com/app/happ-proxy-utility/id6504287215) | [Happ tvOS](https://apps.apple.com/us/app/happ-proxy-utility-for-tv/id6748297274)
|
||||||
- [Streisand](https://apps.apple.com/app/streisand/id6450534064)
|
- [Streisand](https://apps.apple.com/app/streisand/id6450534064)
|
||||||
- [OneXray](https://github.com/OneXray/OneXray)
|
- [OneXray](https://github.com/OneXray/OneXray)
|
||||||
- [INCY](https://apps.apple.com/en/app/incy/id6756943388)
|
- [INCY](https://apps.apple.com/en/app/incy/id6756943388)
|
||||||
- macOS arm64 & x64
|
- macOS arm64 & x64
|
||||||
- [Happ](https://apps.apple.com/app/happ-proxy-utility/id6504287215) | [Happ RU](https://apps.apple.com/ru/app/happ-proxy-utility-plus/id6746188973)
|
- [Happ](https://apps.apple.com/app/happ-proxy-utility/id6504287215)
|
||||||
- [V2rayU](https://github.com/yanue/V2rayU)
|
- [V2rayU](https://github.com/yanue/V2rayU)
|
||||||
- [V2RayXS](https://github.com/tzmax/V2RayXS)
|
- [V2RayXS](https://github.com/tzmax/V2RayXS)
|
||||||
- [Furious](https://github.com/LorenEteval/Furious)
|
|
||||||
- [OneXray](https://github.com/OneXray/OneXray)
|
- [OneXray](https://github.com/OneXray/OneXray)
|
||||||
- [GoXRay](https://github.com/goxray/desktop)
|
|
||||||
- [AnyPortal](https://github.com/AnyPortal/AnyPortal)
|
|
||||||
- [v2rayN](https://github.com/2dust/v2rayN)
|
- [v2rayN](https://github.com/2dust/v2rayN)
|
||||||
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
||||||
- [INCY](https://apps.apple.com/en/app/incy/id6756943388)
|
- [INCY](https://apps.apple.com/en/app/incy/id6756943388)
|
||||||
- Linux
|
- Linux
|
||||||
- [v2rayA](https://github.com/v2rayA/v2rayA)
|
- [v2rayA](https://github.com/v2rayA/v2rayA)
|
||||||
- [Furious](https://github.com/LorenEteval/Furious)
|
|
||||||
- [GorzRay](https://github.com/ketetefid/GorzRay)
|
|
||||||
- [GoXRay](https://github.com/goxray/desktop)
|
|
||||||
- [AnyPortal](https://github.com/AnyPortal/AnyPortal)
|
|
||||||
- [v2rayN](https://github.com/2dust/v2rayN)
|
- [v2rayN](https://github.com/2dust/v2rayN)
|
||||||
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
- [GenyConnect](https://github.com/genyleap/GenyConnect)
|
||||||
- [OneXray](https://github.com/OneXray/OneXray)
|
- [OneXray](https://github.com/OneXray/OneXray)
|
||||||
@@ -163,24 +141,29 @@
|
|||||||
- Xray Wrapper
|
- Xray Wrapper
|
||||||
- [XTLS/libXray](https://github.com/XTLS/libXray)
|
- [XTLS/libXray](https://github.com/XTLS/libXray)
|
||||||
- [xtls-sdk](https://github.com/remnawave/xtls-sdk)
|
- [xtls-sdk](https://github.com/remnawave/xtls-sdk)
|
||||||
- [xtlsapi](https://github.com/hiddify/xtlsapi)
|
|
||||||
- [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite)
|
- [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite)
|
||||||
- [flutter_vless](https://github.com/XIIIFOX/flutter_vless)
|
- [flutter_vless](https://github.com/XIIIFOX/flutter_vless)
|
||||||
- [Xray-core-python](https://github.com/LorenEteval/Xray-core-python)
|
|
||||||
- [xray-api](https://github.com/XVGuardian/xray-api)
|
|
||||||
- [XrayR](https://github.com/XrayR-project/XrayR)
|
|
||||||
- [XrayR-release](https://github.com/XrayR-project/XrayR-release)
|
|
||||||
- [XrayR-V2Board](https://github.com/missuo/XrayR-V2Board)
|
|
||||||
- Cores
|
- Cores
|
||||||
- [Amnezia VPN](https://github.com/amnezia-vpn)
|
- [Amnezia VPN](https://github.com/amnezia-vpn)
|
||||||
- [mihomo](https://github.com/MetaCubeX/mihomo)
|
- [mihomo](https://github.com/MetaCubeX/mihomo)
|
||||||
- [sing-box](https://github.com/SagerNet/sing-box)
|
- [sing-box](https://github.com/SagerNet/sing-box)
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Project listing criteria</summary>
|
||||||
|
|
||||||
|
To submit a project to the [README](https://github.com/XTLS/Xray-core#readme), open a [pull request](https://github.com/XTLS/Xray-core/pulls). Projects are listed under these rules:
|
||||||
|
|
||||||
|
- Projects must be based on Xray-core, have been maintained for at least one month, and have at least 30 stars.
|
||||||
|
- Projects with no activity for three months will be removed.
|
||||||
|
- **Closed-source iOS clients must be submitted by their developers.**
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
[Code of Conduct](https://github.com/XTLS/Xray-core/blob/main/CODE_OF_CONDUCT.md)
|
For code contributions, please read [CONTRIBUTING.md](CONTRIBUTING.md) and [Code of Conduct](https://github.com/XTLS/Xray-core/blob/main/CODE_OF_CONDUCT.md) before opening a pull request.
|
||||||
|
|
||||||
[](https://deepwiki.com/XTLS/Xray-core)
|
[Ask DeepWiki](https://deepwiki.com/XTLS/Xray-core) might be helpful.
|
||||||
|
|
||||||
## Credits
|
## Credits
|
||||||
|
|
||||||
@@ -263,4 +246,8 @@ GOOS=linux GOARCH=mipsle GOMIPS=softfloat CGO_ENABLED=0 go build -o xray -trimpa
|
|||||||
|
|
||||||
## Stargazers over time
|
## Stargazers over time
|
||||||
|
|
||||||
[](https://starchart.cc/XTLS/Xray-core)
|
<picture>
|
||||||
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=xtls/xray-core&type=date&theme=dark&legend=top-left" />
|
||||||
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=xtls/xray-core&type=date&legend=top-left" />
|
||||||
|
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=xtls/xray-core&type=date&legend=top-left" />
|
||||||
|
</picture>
|
||||||
|
|||||||
Reference in New Issue
Block a user