wulabing/Xray_onekey là một trong những repo tập trung bảo mật mà TopGit theo dõi, hiện có 9.3k sao, viết chủ yếu bằng Shell. Xray 基于 Nginx 的 VLESS + XTLS 一键安装脚本
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Thanks for non-commercial open source development authorization by JetBrains!
Nested TLS caused by placing Nginx in front may lead to connection blocking. REALITY is now the recommended option — please head to the address below
https://github.com/wulabing/xray_docker
❤️ Sponsors
Want to appear here? Feel free to reach out via an issue or the Telegram group
Thanks to CapybaraCode for sponsoring this project — the very first sponsorship this project has received, and I truly appreciate the recognition! A stable, low-latency API relay service for Claude Code / AI coding. Works out of the box, pay-as-you-go, and smooth enough for daily coding work. Enter the promo code WULABING when signing up to get an extra $4 in credit.
Thanks to UHDNOW for sponsoring this project! A carefully maintained private Emby server with a full catalogue of 4K / IMAX remuxes, Dolby Vision and HDR sources, multiple direct-connect routes and instant seeking. Worth a look if you are into home media.
If you do not understand what a given setting in the script means, use the default value provided by the script for everything except the domain name;
Using this script requires Linux fundamentals and hands-on experience, some knowledge of computer networking, and basic computer skills;
The maintainer provides only very limited support. If you run into problems, feel free to ask other members in the group.
Supported Systems
Distribution
Version requirement
Notes
Debian
10+
Debian 12 / 13 recommended
Ubuntu
20.04+
Rocky Linux
8+
AlmaLinux
8+
Oracle Linux
7+
CentOS
7+ / Stream
CentOS 7 reached EOL on 2024-06-30. Official repositories have moved to vault.centos.org; the script prints a warning and continues, but dependency installation may fail. Switching to another distribution is recommended
Known Limitations
The WebSocket transport has been marked as deprecated by Xray. Since Xray-core v26.1.23, using the ws transport prints a deprecation warning in the startup log (The feature WebSocket transport (with ALPN http/1.1, etc.) is deprecated, not recommended for using and might be removed.), and it may be removed in a future release. This warning is emitted before the log file is created, so it is only visible in journalctl -u xray and never appears in /var/log/xray/error.log.
This script uses an Nginx-in-front + nested TLS structure, which can be targeted and blocked. Migrating to REALITY / XHTTP is recommended for the long run — see wulabing/xray_docker.
Fixes in v1.4.1
Fixed dependency installation failing on Debian 13 (#487): Debian 13 removed libpcre3-dev, but the script still installed it as part of a single apt install command, so the whole command failed and packages listed alongside it — including openssl — were never installed. Those pcre / zlib / openssl development packages are leftovers from the days when Nginx was compiled from source; Nginx is now installed as a binary from the official repository and no longer needs them, so they have all been removed.
Port-in-use check no longer force-kills Nginx (#469): the script used to kill -9 whatever occupied port 80. When that was a running Nginx, nginx.service was left in failed (Result: signal) state. It now tries systemctl stop nginx first and only falls back to kill -9 if the port is still held.
Fixed limits.conf corruption: when /etc/security/limits.conf does not end with a newline (as on some distributions and cloud images), the appended * soft nofile 65536 was concatenated onto the previous line, both corrupting the existing limit and defeating the line-anchored cleanup logic — repeated installs kept accumulating garbage lines, and the file-descriptor tuning never actually took effect. A newline is now added before appending.
BBR script source validation (#490): when the upstream ylx2016/Linux-NetSpeed repository misbehaves it may serve an outdated script. The script now validates the source and prints its version before executing, and aborts if validation fails.
Fixes in This Maintenance Release (v1.4.0)
Important notice for existing users: if your node was installed with v1.3.11 or earlier, its inbound TLS configuration never actually loaded any certificate, so clients cannot complete the TLS handshake. Please reinstall, or manually rename "xtlsSettings" to "tlsSettings" in /usr/local/etc/xray/config.json and then run systemctl restart xray.
Fixed the inbound TLS not loading any certificate (critical): xtlsSettings in the configuration template has not been a valid field since Xray-core v1.8.1. Unknown JSON fields are silently ignored, so security: "tls" fell back to an empty TLS configuration and certificates never took effect. The field has been renamed to tlsSettings.
Fixed certificate renewal always failing on non-443 ports: the previous approach temporarily rewrote the Nginx configuration by line number with sed to allow /.well-known/acme-challenge/. Under normal conditions port 80 also unconditionally 301-redirects that path to https, so renewal only succeeded by luck when the CA followed the redirect to 443; once the port had been changed via menu item 13 it failed 100% of the time. That location is now permanently present in Nginx, making issuance and renewal independent of the port Xray listens on. Commented-out configuration lines are no longer left behind when issuance fails.
Fixed the permanently false-positive domain IP check: ipget.net now returns 403. The check uses dig to query A / AAAA records, falling back to getent when dig is unavailable.
Certificate permissions: the renewal --reloadcmd now also fixes ownership of /ssl, so Xray can still read the certificate after renewal; the owner is taken from User= in the systemd unit. Also fixed the deprecated chown user.group dot syntax and the omission of the /ssl directory itself.
acme.sh: --upgrade --auto-upgrade is executed after installation, preventing renewal failures caused by CA API changes on older versions.
Post-install self-check: added xray run -test and nginx -t validation; the script errors out and exits on failure.
Configuration templates embedded in the script: config/*.json, web.conf and nginx.repo are no longer fetched from GitHub during installation, so network hiccups can no longer produce a half-installed setup.
Compatibility: added support for Rocky Linux / AlmaLinux / CentOS Stream; nginx >= 1.25.1 now uses the http2 on; directive; the jq fallback download picks amd64 / arm64 based on CPU architecture; on IPv6-only machines the DNS64 configuration is appended to /etc/resolv.conf instead of overwriting it; timeouts were added to network requests everywhere, so the menu no longer hangs when GitHub is unreachable.
Share links: removed the long-broken security=xtls links and QR codes, added the missing encryption=none / type / sni / host parameters, and the WebSocket path is now urlencoded (multi-level paths are no longer mangled).
Acknowledgements
The Project_Xray image in this README was provided by Blitzcrank (Telegram: @Blitz_crank) — many thanks to Blitzcrank;
The MTProxyTLS part of this script is a modified version of https://github.com/sunpma/mtp — thanks to sunpma;
The original 4-in-1 LotServer script is referenced from https://www.94ish.me/1635.html — thanks;
The modified 4-in-1 LotServer script is referenced from https://github.com/ylx2016/Linux-NetSpeed — thanks to ylx2016;
The configuration files and part of the logic reference https://github.com/jiuqi9997/xray-yes — thanks to 玖柒;
The QR code API part references https://github.com/mack-a/v2ray-agent — thanks to mack-a.
Service Control
Start Xray: systemctl start xray
Stop Xray: systemctl stop xray
Start Nginx: systemctl start nginx
Stop Nginx: systemctl stop nginx
Relevant Paths
Web directory: /www/xray_web
Xray server configuration: /usr/local/etc/xray/config.json
Nginx directory: /etc/nginx
Certificate files: /ssl/xray.key (private key) and /ssl/xray.crt (public certificate)
Support This Project
If you would like to support me, you can buy servers / proxies through my affiliate links:
wulabing/Xray_onekey thuộc nhóm Security trên TopGit, cùng 8 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
Đọc thêm về wulabing/Xray_onekey ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/wulabing/Xray_onekey là nguồn chính thức.
Vì sao wulabing/Xray_onekey được xếp vào nhóm Security?
TopGit xếp wulabing/Xray_onekey vào nhóm Security dựa trên GitHub topics và mô tả của repo (gắn thẻ: "nginx", "tls", "v2ray"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
wulabing/Xray_onekey có phải mã nguồn mở không?
Có — wulabing/Xray_onekey phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/wulabing/Xray_onekey.
wulabing/Xray_onekey có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho wulabing/Xray_onekey. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
wulabing/Xray_onekey dùng license gì?
wulabing/Xray_onekey phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
wulabing/Xray_onekey là gì?
wulabing/Xray_onekey (wulabing/Xray_onekey) là dự án Shell trên GitHub. Theo mô tả gốc: Xray 基于 Nginx 的 VLESS + XTLS 一键安装脚本
Đọc đầy đủ README ở tab phía trên.
Xray_onekey có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về Xray_onekey.