{"id":26364598,"url":"https://github.com/masterhide/x-sl","last_synced_at":"2026-03-07T03:03:51.273Z","repository":{"id":276667251,"uuid":"929931705","full_name":"MasterHide/X-SL","owner":"MasterHide","description":"Xray panel supporting multi-protocol multi-user expire day \u0026 traffic \u0026 IP limit (Vmess \u0026 Vless \u0026 Trojan \u0026 ShadowSocks \u0026 Wireguard)","archived":false,"fork":false,"pushed_at":"2025-03-16T11:29:31.000Z","size":7975,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T14:53:40.195Z","etag":null,"topics":["http","iptables-rules","shadowsocks","socks5","trojan","vless","vmess","wiregurad","xtls"],"latest_commit_sha":null,"homepage":"https://t.me/Xray_SL","language":"JavaScript","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/MasterHide.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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},"funding":{"github":null,"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":"masterhide","custom":null}},"created_at":"2025-02-09T18:20:36.000Z","updated_at":"2025-03-16T11:29:35.000Z","dependencies_parsed_at":"2025-02-28T02:43:31.866Z","dependency_job_id":"96e824ce-cb70-4894-ac02-7a90c8875397","html_url":"https://github.com/MasterHide/X-SL","commit_stats":null,"previous_names":["masterhide/x-sl"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/MasterHide/X-SL","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterHide%2FX-SL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterHide%2FX-SL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterHide%2FX-SL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterHide%2FX-SL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MasterHide","download_url":"https://codeload.github.com/MasterHide/X-SL/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterHide%2FX-SL/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30206341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"online","status_checked_at":"2026-03-07T02:00:06.765Z","response_time":53,"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":["http","iptables-rules","shadowsocks","socks5","trojan","vless","vmess","wiregurad","xtls"],"created_at":"2025-03-16T19:22:00.321Z","updated_at":"2026-03-07T03:03:51.247Z","avatar_url":"https://github.com/MasterHide.png","language":"JavaScript","readme":"[English](/README.md)\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/user-attachments/assets/03b48caa-0646-4ff3-b4d4-50d1724cfc46\"\u003e\n    \u003cimg alt=\"x-sl\" src=\"https://github.com/user-attachments/assets/03b48caa-0646-4ff3-b4d4-50d1724cfc46\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n**An Advanced Web Panel • Built on Xray Core**\n\n[![](https://img.shields.io/github/v/release/mhsanaei/3x-ui.svg)](https://github.com/MHSanaei/3x-ui/releases)\n[![](https://img.shields.io/github/actions/workflow/status/mhsanaei/3x-ui/release.yml.svg)](#)\n[![GO Version](https://img.shields.io/github/go-mod/go-version/mhsanaei/3x-ui.svg)](#)\n[![Downloads](https://img.shields.io/github/downloads/mhsanaei/3x-ui/total.svg)](#)\n[![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n\u003e **Disclaimer:** This project is only for personal learning and communication, please do not use it for illegal purposes, please do not use it in a production environment\n\n**If this project is helpful to you, you may wish to give it a**:star2:\n\n\n- USDT (TRC20): `TTJZdUms8KQ9WMJg8i7AGxxkFBMzmsEaRN`\n- PAYID (Binance): `426577151`\n\n\n\n## Install \u0026 Upgrade\n\n```\nbash \u003c(curl -Ls https://raw.githubusercontent.com/MasterHide/X-SL/main/install.sh)\n\n```\n\n## SSL Certificate  (Enable SSL before running the web panel.)\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick for SSL Certificate details\u003c/summary\u003e\n\n### ACME\n\nTo manage SSL certificates using ACME:\n\n1. Ensure your domain is correctly resolved to the server.\n2. Run the `x-ui` command in the terminal, then choose `Manage SSL Certificates`.\n3. You will be presented with the following options:\n\n   - **Get SSL:** Obtain SSL certificates.\n   - **Revoke:** Revoke existing SSL certificates.\n   - **Force Renew:** Force renewal of SSL certificates.\n   - **Show Existing Domains:** Display all domain certificates available on the server.  \n   - **Set Certificate Paths for the Panel:** Specify the certificate for your domain to be used by the panel. \n\n \u003c/details\u003e\n\n## Features 🚀\n\n| Category                | Details                                                                 |\n|-------------------------|-------------------------------------------------------------------------|\n| **Monitoring \u0026 Security** |                                                                         |\n| 📊 System Status         | Real-time monitoring of system performance and resource usage          |\n| 🚫 Torrent Blocking      | Block public torrent traffic via iptables (reduce the risk)           |\n| 📉 Usage Analytics       | Traffic statistics, traffic limits, and client expiration management    |\n|                         |                                                                         |\n| **Protocol Support**     |                                                                         |\n| 🌐 Multi-Protocol         | Supports VMESS, VLESS, Trojan, Shadowsocks, Dokodemo-door, Socks, HTTP  |\n| 🔒 Advanced Protocols    | XTLS native support (RPRX-Direct, Vision, REALITY) and WireGuard        |\n|                         |                                                                         |\n| **Automation**           |                                                                         |\n| ⚙️ Server Management     | Automated server boot system and API route fixes                        |\n| 🔒 SSL Management        | One-click SSL certificate issuance + automatic renewal                 |\n| 🔄 Data Control          | Export/import database functionality                                   |\n|                         |                                                                         |\n| **Customization**        |                                                                         |\n| 🎨 Theme Support         | Dark/Light mode toggle                                                  |\n| 🛠️ Configuration         | Customizable Xray templates and panel-driven config adjustments         |\n| 🔍 Search                | Full search capability across inbounds and clients                      |\n|                         |                                                                         |\n| **User Management**      |                                                                         |\n| 👥 Multi-User System      | Robust multi-user support with traffic monitoring (Traffic-X)           |\n| 🔧 Admin Tools           | Create user settings via API and advanced panel configurations          |\n\n\n## Nginx Settings\n\u003cdetails\u003e\n  \u003csummary\u003eClick for Reverse Proxy Configuration\u003c/summary\u003e\n\n#### Nginx Reverse Proxy\n```nginx\nlocation / {\n    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    proxy_set_header X-Forwarded-Proto $scheme;\n    proxy_set_header Host $http_host;\n    proxy_set_header X-Real-IP $remote_addr;\n    proxy_set_header Range $http_range;\n    proxy_set_header If-Range $http_if_range; \n    proxy_redirect off;\n    proxy_pass http://127.0.0.1:2053;\n}\n```\n\n#### Nginx sub-path\n- Ensure that the \"URI Path\" in the `/sub` panel settings is the same.\n- The `url` in the panel settings needs to end with `/`.   \n\n```nginx\nlocation /sub {\n    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    proxy_set_header X-Forwarded-Proto $scheme;\n    proxy_set_header Host $http_host;\n    proxy_set_header X-Real-IP $remote_addr;\n    proxy_set_header Range $http_range;\n    proxy_set_header If-Range $http_if_range; \n    proxy_redirect off;\n    proxy_pass http://127.0.0.1:2053;\n}\n```\n\u003c/details\u003e\n\n## Recommended OS\n\n- Ubuntu 20.04+\n- Debian 11+\n- CentOS 8+\n- OpenEuler 22.03+\n- Fedora 36+\n- Arch Linux\n- Parch Linux\n- Manjaro\n- Armbian\n- AlmaLinux 8.0+\n- Rocky Linux 8+\n- Oracle Linux 8+\n- OpenSUSE Tubleweed\n- Amazon Linux 2023\n\n\n## Default Panel Settings\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick for default settings details\u003c/summary\u003e\n\n### Username, Password, Port, and Web Base Path\n\nIf you choose not to modify these settings, they will be generated randomly .\n\n**Default Settings for Docker:**\n- **Username:** admin\n- **Password:** admin\n- **Port:** 2053\n\n### Database Management:\n\n  You can conveniently perform database Backups and Restores directly from the panel.\n\n- **Database Path:**\n  - `/etc/x-ui/x-ui.db`\n\n\n### Web Base Path\n\n1. **Reset Web Base Path:**\n   - Open your terminal.\n   - Run the `x-ui` command.\n   - Select the option to `Reset Web Base Path`.\n\n2. **Generate or Customize Path:**\n   - The path will be randomly generated, or you can enter a custom path.\n\n3. **View Current Settings:**\n   - To view your current settings, use the `x-ui settings` command in the terminal or `View Current Panel Info` in `x-ui`\n\n### Security Recommendation:\n- For enhanced security, use a long, random word in your URL structure.\n\n**Examples:**\n- `http://ip:port/*webbasepath*/panel`\n- `https://domain:port/*webbasepath*/panel`\n\n\u003c/details\u003e\n\n## WARP Configuration\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick for WARP configuration details\u003c/summary\u003e\n\n#### Usage\n\n**For versions `v2.1.0` and later:**\n\nWARP is built-in, and no additional installation is required. Simply turn on the necessary configuration in the panel.\n\n\u003c/details\u003e\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n## API Routes\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick for API routes details\u003c/summary\u003e\n\n#### Usage\n\n- `/login` with `POST` user data: `{username: '', password: ''}` for login\n- `/panel/api/inbounds` base for following actions:\n\n| Method | Path                               | Action                                      |\n| :----: | ---------------------------------- | ------------------------------------------- |\n| `GET`  | `\"/list\"`                          | Get all inbounds                            |\n| `GET`  | `\"/get/:id\"`                       | Get inbound with inbound.id                 |\n| `GET`  | `\"/getClientTraffics/:email\"`      | Get Client Traffics with email              |\n| `GET`  | `\"/getClientTrafficsById/:id\"`     | Get client's traffic By ID |\n| `GET`  | `\"/createbackup\"`                  | Telegram bot sends backup to admins         |\n| `POST` | `\"/add\"`                           | Add inbound                                 |\n| `POST` | `\"/del/:id\"`                       | Delete Inbound                              |\n| `POST` | `\"/update/:id\"`                    | Update Inbound                              |\n| `POST` | `\"/clientIps/:email\"`              | Client Ip address                           |\n| `POST` | `\"/clearClientIps/:email\"`         | Clear Client Ip address                     |\n| `POST` | `\"/addClient\"`                     | Add Client to inbound                       |\n| `POST` | `\"/:id/delClient/:clientId\"`       | Delete Client by clientId\\*                 |\n| `POST` | `\"/updateClient/:clientId\"`        | Update Client by clientId\\*                 |\n| `POST` | `\"/:id/resetClientTraffic/:email\"` | Reset Client's Traffic                      |\n| `POST` | `\"/resetAllTraffics\"`              | Reset traffics of all inbounds              |\n| `POST` | `\"/resetAllClientTraffics/:id\"`    | Reset traffics of all clients in an inbound |\n| `POST` | `\"/delDepletedClients/:id\"`        | Delete inbound depleted clients (-1: all)   |\n| `POST` | `\"/onlines\"`                       | Get Online users ( list of emails )         |\n\n\\*- The field `clientId` should be filled by:\n\n- `client.id` for VMESS and VLESS\n- `client.password` for TROJAN\n- `client.email` for Shadowsocks\n\n- [\u003cimg src=\"https://run.pstmn.io/button.svg\" alt=\"Run In Postman\" style=\"width: 128px; height: 32px;\"\u003e](https://app.getpostman.com/run-collection/5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5?action=collection%2Ffork\u0026source=rip_markdown\u0026collection-url=entityId%3D5146551-dda3cab3-0e33-485f-96f9-d4262f437ac5%26entityType%3Dcollection%26workspaceId%3Dd64f609f-485a-4951-9b8f-876b3f917124)\n\u003c/details\u003e\n\n## Environment Variables\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick for environment variables details\u003c/summary\u003e\n\n#### Usage\n\n| Variable       |                      Type                      | Default       |\n| -------------- | :--------------------------------------------: | :------------ |\n| XUI_LOG_LEVEL  | `\"debug\"` \\| `\"info\"` \\| `\"warn\"` \\| `\"error\"` | `\"info\"`      |\n| XUI_DEBUG      |                   `boolean`                    | `false`       |\n| XUI_BIN_FOLDER |                    `string`                    | `\"bin\"`       |\n| XUI_DB_FOLDER  |                    `string`                    | `\"/etc/x-ui\"` |\n| XUI_LOG_FOLDER |                    `string`                    | `\"/var/log\"`  |\n\nExample:\n\n```sh\nXUI_BIN_FOLDER=\"bin\" XUI_DB_FOLDER=\"/etc/x-ui\" go build main.go\n```\n\n\u003c/details\u003e\n\n## Preview\n![home](https://github.com/user-attachments/assets/1a0187ba-90fa-4518-98d9-7033c475a440)\n![inbound](https://github.com/user-attachments/assets/20837943-25d7-4b40-ad9a-0f0d93611b7e)\n![usage](https://github.com/user-attachments/assets/98b1dc01-6897-4150-8391-12db8b1beadf)\n![result](https://github.com/user-attachments/assets/21c73af1-fc43-4575-be94-4f5df4ed361c)\n\n\n\n\n## A Special Thanks to\n\n- [Project X](https://github.com/XTLS)\n- [Inspired by 3x-ui](https://github.com/MHSanaei)\n\n\n## Acknowledgment\n\n- [Iran v2ray rules](https://github.com/chocolate4u/Iran-v2ray-rules) (License: **GPL-3.0**): _Enhanced v2ray/xray and v2ray/xray-clients routing rules with built-in Iranian domains and a focus on security and adblocking._\n- [Russia v2ray rules](https://github.com/runetfreedom/russia-v2ray-rules-dat) (License: **GPL-3.0**): _This repository contains automatically updated V2Ray routing rules based on data on blocked domains and addresses in Russia._\n\n\n\n\n![GitHub license](https://img.shields.io/github/license/MasterHide/X-SL?style=for-the-badge)\n## Stargazers over time\n[![Stargazers over time](https://starchart.cc/MasterHide/X-SL.svg?background=%230e0d11\u0026axis=%23635e5e\u0026line=%236370ff)](https://starchart.cc/MasterHide/X-SL)\n\n","funding_links":["https://buymeacoffee.com/masterhide"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterhide%2Fx-sl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasterhide%2Fx-sl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterhide%2Fx-sl/lists"}