{"id":15107202,"url":"https://github.com/mhsanaei/3x-ui","last_synced_at":"2026-06-02T04:00:45.237Z","repository":{"id":65824835,"uuid":"599735720","full_name":"MHSanaei/3x-ui","owner":"MHSanaei","description":"Xray panel supporting multi-protocol multi-user expire day \u0026 traffic \u0026 IP limit (Vmess, Vless, Trojan, ShadowSocks, Wireguard, Hysteria, Tunnel, Mixed, HTTP, Tun) ","archived":false,"fork":false,"pushed_at":"2026-05-26T12:43:28.000Z","size":42053,"stargazers_count":38242,"open_issues_count":638,"forks_count":7196,"subscribers_count":258,"default_branch":"main","last_synced_at":"2026-05-26T14:33:53.161Z","etag":null,"topics":["ech","fail2ban","http","hysteria2","mixed","nodes","post-quantum","reality","shadowsocks","shadowsocks2022","tls","trojan","tun","tunnel","vless","vmess","wireguard","x25519","xhttp"],"latest_commit_sha":null,"homepage":"https://t.me/XrayUI","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MHSanaei.png","metadata":{"files":{"readme":"README.ar_EG.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"MHSanaei","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"mhsanaei","custom":"https://donate.sanaei.dev/"}},"created_at":"2023-02-09T19:16:57.000Z","updated_at":"2026-05-26T14:24:36.000Z","dependencies_parsed_at":"2023-11-20T00:22:59.945Z","dependency_job_id":"bddeccd4-5224-42d6-a13d-b35904efeaef","html_url":"https://github.com/MHSanaei/3x-ui","commit_stats":{"total_commits":1413,"total_committers":79,"mean_commits":17.88607594936709,"dds":"0.45506015569709835","last_synced_commit":"0fc935e996fb37fe2c95937e851990d24367372a"},"previous_names":[],"tags_count":125,"template":false,"template_full_name":null,"purl":"pkg:github/MHSanaei/3x-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MHSanaei%2F3x-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MHSanaei%2F3x-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MHSanaei%2F3x-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MHSanaei%2F3x-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MHSanaei","download_url":"https://codeload.github.com/MHSanaei/3x-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MHSanaei%2F3x-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33805341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ech","fail2ban","http","hysteria2","mixed","nodes","post-quantum","reality","shadowsocks","shadowsocks2022","tls","trojan","tun","tunnel","vless","vmess","wireguard","x25519","xhttp"],"created_at":"2024-09-25T21:21:01.407Z","updated_at":"2026-06-02T04:00:45.221Z","avatar_url":"https://github.com/MHSanaei.png","language":"TypeScript","funding_links":["https://github.com/sponsors/MHSanaei","https://buymeacoffee.com/mhsanaei","https://donate.sanaei.dev/","https://www.buymeacoffee.com/MHSanaei"],"categories":[],"sub_categories":[],"readme":"[English](/README.md) | [فارسی](/README.fa_IR.md) | [العربية](/README.ar_EG.md) | [中文](/README.zh_CN.md) | [Español](/README.es_ES.md) | [Русский](/README.ru_RU.md)\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./media/3x-ui-dark.png\"\u003e\n    \u003cimg alt=\"3x-ui\" src=\"./media/3x-ui-light.png\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/MHSanaei/3x-ui/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/mhsanaei/3x-ui\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MHSanaei/3x-ui/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/mhsanaei/3x-ui/release.yml.svg\" alt=\"Build\"\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/mhsanaei/3x-ui.svg\" alt=\"GO Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MHSanaei/3x-ui/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/mhsanaei/3x-ui/total.svg\" alt=\"Downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.gnu.org/licenses/gpl-3.0.en.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/mhsanaei/3x-ui/v3\"\u003e\u003cimg src=\"https://pkg.go.dev/badge/github.com/mhsanaei/3x-ui/v3.svg\" alt=\"Go Reference\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/mhsanaei/3x-ui/v3\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/mhsanaei/3x-ui/v3\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**3X-UI** هي لوحة تحكم ويب متقدمة ومفتوحة المصدر لإدارة خوادم [Xray-core](https://github.com/XTLS/Xray-core). توفّر واجهة نظيفة ومتعددة اللغات لنشر وتكوين ومراقبة مجموعة واسعة من بروتوكولات الوكيل وVPN — من خادم VPS واحد إلى عمليات النشر متعددة العقد.\n\nتم بناء 3X-UI كنسخة محسّنة (fork) من مشروع X-UI الأصلي، وتضيف دعمًا أوسع للبروتوكولات، واستقرارًا محسّنًا، ومحاسبة للترافيك لكل عميل، والعديد من ميزات تحسين تجربة الاستخدام.\n\n\u003e [!IMPORTANT]\n\u003e هذا المشروع مخصص للاستخدام الشخصي فقط. يرجى عدم استخدامه لأغراض غير قانونية أو في بيئة إنتاجية.\n\n## الميزات\n\n- **اتصالات واردة متعددة البروتوكولات** — VLESS، VMess، Trojan، Shadowsocks، WireGuard، Hysteria2، HTTP، SOCKS (Mixed)، Dokodemo-door / Tunnel و TUN.\n- **وسائل نقل وأمان حديثة** — TCP (Raw)، mKCP، WebSocket، gRPC، HTTPUpgrade و XHTTP، مؤمَّنة بـ TLS و XTLS و REALITY.\n- **Fallback** — تقديم عدة بروتوكولات على منفذ واحد (مثل VLESS و Trojan على المنفذ 443) باستخدام ميزة fallback في Xray.\n- **إدارة لكل عميل** — حصص الترافيك، تواريخ انتهاء الصلاحية، حدود IP، حالة الاتصال المباشرة، وروابط مشاركة وأكواد QR واشتراكات بنقرة واحدة.\n- **إحصائيات الترافيك** — لكل اتصال وارد، ولكل عميل، ولكل اتصال صادر، مع عناصر تحكم لإعادة التعيين.\n- **دعم العقد المتعددة** — إدارة وتوسيع عبر عدة خوادم من لوحة واحدة.\n- **الاتصالات الصادرة والتوجيه** — WARP، NordVPN، قواعد توجيه مخصصة، موازنات تحميل، وتسلسل الوكلاء الصادرة.\n- **خادم اشتراك مدمج** بصيغ إخراج متعددة.\n- **روبوت تيليجرام** للمراقبة والإدارة عن بُعد.\n- **واجهة RESTful API** مع توثيق Swagger داخل اللوحة.\n- **تخزين مرن** — SQLite (افتراضي) أو PostgreSQL.\n- **13 لغة لواجهة المستخدم** مع سمات داكنة وفاتحة.\n- **تكامل مع Fail2ban** لفرض حدود IP لكل عميل.\n\n## لقطات الشاشة\n\n\u003cdetails\u003e\n\u003csummary\u003eانقر للتوسيع\u003c/summary\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./media/01-overview-dark.png\"\u003e\n  \u003cimg alt=\"Overview\" src=\"./media/01-overview-light.png\"\u003e\n\u003c/picture\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./media/02-add-inbound-dark.png\"\u003e\n  \u003cimg alt=\"Inbounds\" src=\"./media/02-add-inbound-light.png\"\u003e\n\u003c/picture\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./media/03-add-client-dark.png\"\u003e\n  \u003cimg alt=\"Add client\" src=\"./media/03-add-client-light.png\"\u003e\n\u003c/picture\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./media/05-add-nodes-dark.png\"\u003e\n  \u003cimg alt=\"Configs\" src=\"./media/05-add-nodes-light.png\"\u003e\n\u003c/picture\u003e\n\n\u003c/details\u003e\n\n## البدء السريع\n\n```bash\nbash \u003c(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)\n```\n\nأثناء التثبيت، يتم إنشاء اسم مستخدم وكلمة مرور ومسار وصول عشوائية. بعد التثبيت، شغّل `x-ui` لفتح قائمة الإدارة، حيث يمكنك بدء/إيقاف الخدمة، وعرض أو إعادة تعيين بيانات تسجيل الدخول، وإدارة شهادات SSL، والمزيد.\n\nللحصول على الوثائق الكاملة، يرجى زيارة [ويكي المشروع](https://github.com/MHSanaei/3x-ui/wiki).\n\n## المنصات المدعومة\n\n**أنظمة التشغيل:** Ubuntu، Debian، Armbian، Fedora، CentOS، RHEL، AlmaLinux، Rocky Linux، Oracle Linux، Amazon Linux، Virtuozzo، Arch، Manjaro، Parch، openSUSE (Tumbleweed / Leap)، Alpine و Windows.\n\n**المعماريات:** `amd64` · `386` · `arm64` (aarch64) · `armv7` · `armv6` · `armv5` · `s390x`.\n\n## خيارات قاعدة البيانات\n\nيدعم 3X-UI خلفيتين (backends) يتم اختيارهما أثناء التثبيت:\n\n- **SQLite** (افتراضي) — ملف واحد في `/etc/x-ui/x-ui.db`. بدون إعداد، مثالي لعمليات النشر الصغيرة والمتوسطة.\n- **PostgreSQL** — موصى به لأعداد العملاء الكبيرة أو الإعدادات متعددة العقد. يمكن للمثبِّت تثبيت PostgreSQL محليًا لك، أو قبول DSN لخادم موجود.\n\nفي وقت التشغيل، يتم اختيار الخلفية عبر متغيرات البيئة (يكتبها المثبِّت لك في `/etc/default/x-ui`):\n\n```\nXUI_DB_TYPE=postgres\nXUI_DB_DSN=postgres://xui:password@127.0.0.1:5432/xui?sslmode=disable\n```\n\n### ترحيل تثبيت SQLite موجود إلى PostgreSQL\n\n```bash\nx-ui migrate-db --dsn \"postgres://xui:password@127.0.0.1:5432/xui?sslmode=disable\"\n# ثم عيّن XUI_DB_TYPE و XUI_DB_DSN في /etc/default/x-ui وأعد التشغيل:\nsystemctl restart x-ui\n```\n\nيبقى ملف SQLite الأصلي دون تغيير؛ احذفه يدويًا بعد التحقق من الخلفية الجديدة.\n\n### Docker\n\nيستمر الأمر الافتراضي `docker compose up -d` في استخدام SQLite. للتشغيل مع خدمة PostgreSQL المرفقة، أزِل التعليق عن سطري متغيرات البيئة `XUI_DB_*` في `docker-compose.yml` وشغّل باستخدام البروفايل:\n\n```bash\ndocker compose --profile postgres up -d\n```\n\nتتضمن الصورة Fail2ban (مُفعَّل افتراضيًا) لفرض **حدود IP** لكل عميل. يحظر Fail2ban المخالفين باستخدام `iptables`، الذي يتطلب صلاحية `NET_ADMIN`. يمنح `docker-compose.yml` هذه الصلاحية مسبقًا عبر `cap_add`؛ إذا شغّلت الحاوية باستخدام `docker run` بدلاً من ذلك، فأضِف الصلاحيات بنفسك، وإلا فسيتم تسجيل عمليات الحظر دون تطبيقها أبدًا:\n\n```bash\ndocker run -d --cap-add=NET_ADMIN --cap-add=NET_RAW ... ghcr.io/mhsanaei/3x-ui\n```\n\n## متغيرات البيئة\n\n| المتغير | الوصف | الافتراضي |\n| --- | --- | --- |\n| `XUI_DB_TYPE` | خلفية قاعدة البيانات: `sqlite` أو `postgres` | `sqlite` |\n| `XUI_DB_DSN` | سلسلة اتصال PostgreSQL (عندما `XUI_DB_TYPE=postgres`) | — |\n| `XUI_DB_FOLDER` | مجلد ملف قاعدة بيانات SQLite | `/etc/x-ui` |\n| `XUI_DB_MAX_OPEN_CONNS` | الحد الأقصى للاتصالات المفتوحة (تجمّع PostgreSQL) | — |\n| `XUI_DB_MAX_IDLE_CONNS` | الحد الأقصى للاتصالات الخاملة (تجمّع PostgreSQL) | — |\n| `XUI_ENABLE_FAIL2BAN` | تفعيل فرض حدود IP المعتمد على Fail2ban | `true` |\n| `XUI_LOG_LEVEL` | مستوى السجل (`debug`، `info`، `warning`، `error`) | `info` |\n| `XUI_DEBUG` | تفعيل وضع التصحيح | `false` |\n\n## اللغات المدعومة\n\nتتوفر واجهة اللوحة بـ 13 لغة:\n\nEnglish · فارسی · العربية · 中文（简体） · 中文（繁體） · Español · Русский · Українська · Türkçe · Tiếng Việt · 日本語 · Bahasa Indonesia · Português (Brasil)\n\n## المساهمة\n\nالمساهمات مرحب بها. يرجى قراءة [دليل المساهمة](/CONTRIBUTING.md) قبل فتح مشكلة (issue) أو طلب سحب (pull request).\n\n## شكر خاص إلى\n\n- [alireza0](https://github.com/alireza0/)\n\n## الاعتراف\n\n- [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (الترخيص: **GPL-3.0**): _قواعد توجيه v2ray/xray و v2ray/xray-clients المحسنة مع النطاقات الإيرانية المدمجة وتركيز على الأمان وحظر الإعلانات._\n- [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (الترخيص: **GPL-3.0**): _يحتوي هذا المستودع على قواعد توجيه V2Ray محدثة تلقائيًا بناءً على بيانات النطاقات والعناوين المحظورة في روسيا._\n\n## أدوات المجتمع\n\nأدوات وتكاملات بناها المجتمع حول 3x-ui.\n\n- [terraform-provider-3x-ui](https://github.com/batonogov/terraform-provider-threexui) (الترخيص: **MIT**): _إدارة الاتصالات الواردة والعملاء وإعدادات اللوحة وتكوين Xray كرمز باستخدام Terraform / OpenTofu._\n\n## دعم المشروع\n\n**إذا كان هذا المشروع مفيدًا لك، فقد ترغب في إعطائه**:star2:\n\n\u003ca href=\"https://www.buymeacoffee.com/MHSanaei\" target=\"_blank\"\u003e\n\u003cimg src=\"./media/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 70px !important;width: 277px !important;\" \u003e\n\u003c/a\u003e\n\u003c/br\u003e\n\u003ca href=\"https://nowpayments.io/donation/hsanaei\" target=\"_blank\" rel=\"noreferrer noopener\"\u003e\n   \u003cimg src=\"./media/donation-button-black.svg\" alt=\"Crypto donation button by NOWPayments\"\u003e\n\u003c/a\u003e\n\n## النجوم عبر الزمن\n\n[![Stargazers over time](https://starchart.cc/MHSanaei/3x-ui.svg?variant=adaptive)](https://starchart.cc/MHSanaei/3x-ui)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhsanaei%2F3x-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhsanaei%2F3x-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhsanaei%2F3x-ui/lists"}