txlyre/3x-ui @ 554d85c2f7acccb64e19eb6aeebda75ef29d3083

Ei kuvausta

1 Haarat

animesha3 554d85c2f7 feat: allow selecting inbounds synchronized from nodes (#5178)		18 tuntia sitten
.github	9730561f20 ci(bot): update issue-bot repo map and tighten reply style	1 päivä sitten
.vscode	cc34dc381c feat(postgres): in-panel backup/restore and consistent CLI backend	1 viikko sitten
docs	41645255f1 refactor: focused service files, leaf subpackages, and an internal/ layout (#5167)	2 päivää sitten
frontend	554d85c2f7 feat: allow selecting inbounds synchronized from nodes (#5178)	18 tuntia sitten
internal	554d85c2f7 feat: allow selecting inbounds synchronized from nodes (#5178)	18 tuntia sitten
media	87f446fe22 docs(readme): revamp README and sync all translations	1 viikko sitten
tools	3092326d9e refactor: replace custom geo manager with Xray-core native geodata auto-update	1 päivä sitten
windows_files	570ab8e5e0 Update OpenSSL installer to version 3.6.0	5 kuukautta sitten
.dockerignore	41645255f1 refactor: focused service files, leaf subpackages, and an internal/ layout (#5167)	2 päivää sitten
.env.example	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
.gitattributes	eb78b8666f fix(inbound): re-derive auto tags on edit and keep node tags consistent	1 viikko sitten
.gitignore	41645255f1 refactor: focused service files, leaf subpackages, and an internal/ layout (#5167)	2 päivää sitten
.nvmrc	428f1333ac Security hardening: sessions, SSRF, CSP nonce, CSRF logout, trusted proxies (#4275)	1 kuukausi sitten
CONTRIBUTING.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
DockerEntrypoint.sh	b1d079fc24 fix(fail2ban): exempt SSH and panel ports from IP-limit ban (#4896)	1 viikko sitten
DockerInit.sh	1ca5924a44 feat(mtproto): add MTProto (FakeTLS) protocol via managed mtg sidecar (#5076)	4 päivää sitten
Dockerfile	41645255f1 refactor: focused service files, leaf subpackages, and an internal/ layout (#5167)	2 päivää sitten
LICENSE	b73e4173a3 3x-ui	3 vuotta sitten
README.ar_EG.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.es_ES.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.fa_IR.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.ru_RU.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.tr_TR.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
README.zh_CN.md	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
docker-compose.yml	89b1137b00 feat(env): allow setting the initial URI path for the web panel (#5149)	1 päivä sitten
go.mod	eee652c4a5 chore(deps): bump golang.org/x/net from 0.55.0 to 0.56.0 (#5199)	1 päivä sitten
go.sum	eee652c4a5 chore(deps): bump golang.org/x/net from 0.55.0 to 0.56.0 (#5199)	1 päivä sitten
install.sh	f8e89cc848 fix(mtproto): reap orphaned mtg, fix SysLog viewer, mtg log visibility, export remark (#5105) (#5107)	3 päivää sitten
main.go	65fa40b819 fix: accurately retrieve and generate API tokens via CLI with hashed storage (#5145) (#5183)	1 päivä sitten
update.sh	f88f53cd7b fix(update): restart panel after regenerating webBasePath to fix login desync	1 päivä sitten
x-ui.rc	4c2915586c fix(alpine): restart_xray uses rc-service; OpenRC reload reads pidfile contents	1 kuukausi sitten
x-ui.service.arch	e2649f98df fix(arch): correct x-ui service path (#4213)	1 kuukausi sitten
x-ui.service.debian	2b1d3e7347 [feat] restart xray-core from cli #3825	3 kuukautta sitten
x-ui.service.rhel	2b1d3e7347 [feat] restart xray-core from cli #3825	3 kuukautta sitten
x-ui.sh	57e9661758 fix: properly configure fail2ban backend and dependencies on Ubuntu 22.04+ (#5159) (#5184)	1 päivä sitten

3X-UI هي لوحة تحكم ويب متقدمة ومفتوحة المصدر لإدارة خوادم Xray-core. توفّر واجهة نظيفة ومتعددة اللغات لنشر وتكوين ومراقبة مجموعة واسعة من بروتوكولات الوكيل وVPN — من خادم VPS واحد إلى عمليات النشر متعددة العقد.

تم بناء 3X-UI كنسخة محسّنة (fork) من مشروع X-UI الأصلي، وتضيف دعمًا أوسع للبروتوكولات، واستقرارًا محسّنًا، ومحاسبة للترافيك لكل عميل، والعديد من ميزات تحسين تجربة الاستخدام.

[!IMPORTANT] هذا المشروع مخصص للاستخدام الشخصي فقط. يرجى عدم استخدامه لأغراض غير قانونية أو في بيئة إنتاجية.

الميزات

اتصالات واردة متعددة البروتوكولات — VLESS، VMess، Trojan، Shadowsocks، WireGuard، Hysteria2، HTTP، SOCKS (Mixed)، Dokodemo-door / Tunnel و TUN.
وسائل نقل وأمان حديثة — TCP (Raw)، mKCP، WebSocket، gRPC، HTTPUpgrade و XHTTP، مؤمَّنة بـ TLS و XTLS و REALITY.
Fallback — تقديم عدة بروتوكولات على منفذ واحد (مثل VLESS و Trojan على المنفذ 443) باستخدام ميزة fallback في Xray.
إدارة لكل عميل — حصص الترافيك، تواريخ انتهاء الصلاحية، حدود IP، حالة الاتصال المباشرة، وروابط مشاركة وأكواد QR واشتراكات بنقرة واحدة.
إحصائيات الترافيك — لكل اتصال وارد، ولكل عميل، ولكل اتصال صادر، مع عناصر تحكم لإعادة التعيين.
دعم العقد المتعددة — إدارة وتوسيع عبر عدة خوادم من لوحة واحدة.
الاتصالات الصادرة والتوجيه — WARP، NordVPN، قواعد توجيه مخصصة، موازنات تحميل، وتسلسل الوكلاء الصادرة.
خادم اشتراك مدمج بصيغ إخراج متعددة.
روبوت تيليجرام للمراقبة والإدارة عن بُعد.
واجهة RESTful API مع توثيق Swagger داخل اللوحة.
تخزين مرن — SQLite (افتراضي) أو PostgreSQL.
13 لغة لواجهة المستخدم مع سمات داكنة وفاتحة.
تكامل مع Fail2ban لفرض حدود IP لكل عميل.

لقطات الشاشة

انقر للتوسيع

البدء السريع

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

أثناء التثبيت، يتم إنشاء اسم مستخدم وكلمة مرور ومسار وصول عشوائية. بعد التثبيت، شغّل x-ui لفتح قائمة الإدارة، حيث يمكنك بدء/إيقاف الخدمة، وعرض أو إعادة تعيين بيانات تسجيل الدخول، وإدارة شهادات SSL، والمزيد.

للحصول على الوثائق الكاملة، يرجى زيارة ويكي المشروع.

المنصات المدعومة

أنظمة التشغيل: Ubuntu، Debian، Armbian، Fedora، CentOS، RHEL، AlmaLinux، Rocky Linux، Oracle Linux، Amazon Linux، Virtuozzo، Arch، Manjaro، Parch، openSUSE (Tumbleweed / Leap)، Alpine و Windows.

المعماريات: amd64 · 386 · arm64 (aarch64) · armv7 · armv6 · armv5 · s390x.

خيارات قاعدة البيانات

يدعم 3X-UI خلفيتين (backends) يتم اختيارهما أثناء التثبيت:

SQLite (افتراضي) — ملف واحد في /etc/x-ui/x-ui.db. بدون إعداد، مثالي لعمليات النشر الصغيرة والمتوسطة.
PostgreSQL — موصى به لأعداد العملاء الكبيرة أو الإعدادات متعددة العقد. يمكن للمثبِّت تثبيت PostgreSQL محليًا لك، أو قبول DSN لخادم موجود.

في وقت التشغيل، يتم اختيار الخلفية عبر متغيرات البيئة (يكتبها المثبِّت لك في /etc/default/x-ui):

XUI_DB_TYPE=postgres
XUI_DB_DSN=postgres://xui:[email protected]:5432/xui?sslmode=disable

ترحيل تثبيت SQLite موجود إلى PostgreSQL

x-ui migrate-db --dsn "postgres://xui:[email protected]:5432/xui?sslmode=disable"
# ثم عيّن XUI_DB_TYPE و XUI_DB_DSN في /etc/default/x-ui وأعد التشغيل:
systemctl restart x-ui

يبقى ملف SQLite الأصلي دون تغيير؛ احذفه يدويًا بعد التحقق من الخلفية الجديدة.

Docker

يستمر الأمر الافتراضي docker compose up -d في استخدام SQLite. للتشغيل مع خدمة PostgreSQL المرفقة، أزِل التعليق عن سطري متغيرات البيئة XUI_DB_* في docker-compose.yml وشغّل باستخدام البروفايل:

docker compose --profile postgres up -d

تتضمن الصورة Fail2ban (مُفعَّل افتراضيًا) لفرض حدود IP لكل عميل. يحظر Fail2ban المخالفين باستخدام iptables، الذي يتطلب صلاحية NET_ADMIN. يمنح docker-compose.yml هذه الصلاحية مسبقًا عبر cap_add؛ إذا شغّلت الحاوية باستخدام docker run بدلاً من ذلك، فأضِف الصلاحيات بنفسك، وإلا فسيتم تسجيل عمليات الحظر دون تطبيقها أبدًا:

docker run -d --cap-add=NET_ADMIN --cap-add=NET_RAW ... ghcr.io/mhsanaei/3x-ui

متغيرات البيئة

المتغير	الوصف	الافتراضي
`XUI_DB_TYPE`	خلفية قاعدة البيانات: `sqlite` أو `postgres`	`sqlite`
`XUI_DB_DSN`	سلسلة اتصال PostgreSQL (عندما `XUI_DB_TYPE=postgres`)	—
`XUI_DB_FOLDER`	مجلد ملف قاعدة بيانات SQLite	`/etc/x-ui`
`XUI_DB_MAX_OPEN_CONNS`	الحد الأقصى للاتصالات المفتوحة (تجمّع PostgreSQL)	—
`XUI_DB_MAX_IDLE_CONNS`	الحد الأقصى للاتصالات الخاملة (تجمّع PostgreSQL)	—
`XUI_INIT_WEB_BASE_PATH`	مسار URI الأولي للوحة الويب	`/`
`XUI_ENABLE_FAIL2BAN`	تفعيل فرض حدود IP المعتمد على Fail2ban	`true`
`XUI_LOG_LEVEL`	مستوى السجل (`debug`، `info`، `warning`، `error`)	`info`
`XUI_DEBUG`	تفعيل وضع التصحيح	`false`

اللغات المدعومة

تتوفر واجهة اللوحة بـ 13 لغة:

English · فارسی · العربية · 中文（简体） · 中文（繁體） · Español · Русский · Українська · Türkçe · Tiếng Việt · 日本語 · Bahasa Indonesia · Português (Brasil)

المساهمة

المساهمات مرحب بها. يرجى قراءة دليل المساهمة قبل فتح مشكلة (issue) أو طلب سحب (pull request).

شكر خاص إلى

alireza0

الاعتراف

Iran v2ray rules (الترخيص: GPL-3.0): قواعد توجيه v2ray/xray و v2ray/xray-clients المحسنة مع النطاقات الإيرانية المدمجة وتركيز على الأمان وحظر الإعلانات.
Russia v2ray rules (الترخيص: GPL-3.0): يحتوي هذا المستودع على قواعد توجيه V2Ray محدثة تلقائيًا بناءً على بيانات النطاقات والعناوين المحظورة في روسيا.

أدوات المجتمع

أدوات وتكاملات بناها المجتمع حول 3x-ui.

terraform-provider-3x-ui (الترخيص: MIT): إدارة الاتصالات الواردة والعملاء وإعدادات اللوحة وتكوين Xray كرمز باستخدام Terraform / OpenTofu.

دعم المشروع

إذا كان هذا المشروع مفيدًا لك، فقد ترغب في إعطائه:star2:

README.ar_EG.md