English | Русский | فارسی

Welcome to SharX / Добро пожаловать в SharX

SharX is a fork of the original 3XUI panel with enhanced features and monitoring capabilities.

SharX — это форк оригинальной панели 3XUI с расширенными возможностями и функциями мониторинга.

This version brings a modern, Docker-first architecture, multi-node workers, a visual subscription page builder, encrypted cookie-based web sessions, and optional observability hooks (Prometheus text metrics, optional Loki / VictoriaMetrics in settings, Grafana dashboard JSON export).

Эта версия даёт современную Docker-сборку, multi-node worker-узлы, визуальный конструктор страницы подписки, веб-сессии в зашифрованных cookie и опциональную наблюдаемость (метрики в формате Prometheus, опционально Loki/VictoriaMetrics в настройках, JSON дашборда для Grafana).

---

🔥 v2.0.0-beta — what's hot in the v2.0 branch

🇬🇧 The bleeding-edge multi-core release. 🇷🇺 Передовая мульти-кор сборка.

🇬🇧 English	🇷🇺 Русский
One sing-box, every protocol — mieru / AnyTLS / Naïve / TUIC v5 / Hysteria2 inbounds with per-user billing stats	Один sing-box на все протоколы — входящие mieru / AnyTLS / Naïve / TUIC v5 / Hysteria2 с поюзерной статистикой
Real AmneziaWG 1.5 + mieru server in a single sing-box (anti-DPI WARP egress)	Настоящий AmneziaWG 1.5 + mieru-сервер в одном sing-box (anti-DPI WARP)
:443 SNI router — VLESS/Trojan/AnyTLS share one port by SNI; Hy2/TUIC on :443/udp	SNI-роутинг на :443 — VLESS/Trojan/AnyTLS делят порт по SNI; Hy2/TUIC на :443/udp
Cores page — Stop/Restart/Logs/version/uptime per core + Telemt version switcher	Страница «Ядра» — Стоп/Рестарт/Логи/версия/аптайм + переключатель версий Telemt
Multi-node cascades + Cloudflare WARP egress + 3X-UI-style L7 routing	Мульти-нод каскады + Cloudflare WARP + L7-маршрутизация в стиле 3X-UI
Hybrid panel-as-node — the panel host can run its own workload	Гибрид «панель-как-нода» — хост панели может нести свою нагрузку

▶️ Get it: 📦 Packages (GHCR) · 🏷️ Release v2.0.0-beta · 🌿 v2.0 branch

docker pull ghcr.io/teslaproduuction/sharx:latest-beta
docker pull ghcr.io/teslaproduuction/sharxnode:latest-beta

---

Quick Start / Быстрый старт

🚀 Install / Установка

Клонируйте и запустите:

git clone https://github.com/konstpic/SharX.git
cd SharX
sudo bash ./install_ru.sh

---

📜 Script Installation (Recommended) / Установка через скрипт (Рекомендуется)

Automatic Installation / Автоматическая установка

The install script supports multiple Linux distributions and automatically:

• Installs Docker and Docker Compose
• Configures network mode (host/bridge)
• Sets up SSL certificates (Let's Encrypt for domain or IP)
• Generates secure database password
• Creates and starts all services

Скрипт установки поддерживает множество дистрибутивов Linux и автоматически:

• Устанавливает Docker и Docker Compose
• Настраивает режим сети (host/bridge)
• Настраивает SSL сертификаты (Let's Encrypt для домена или IP)
• Генерирует безопасный пароль базы данных
• Создаёт и запускает все сервисы

Supported Systems / Поддерживаемые системы

Distribution	Package Manager
Ubuntu/Debian	apt
Fedora	dnf
CentOS/RHEL	yum
Arch Linux	pacman
Alpine	apk
openSUSE	zypper

Panel Installation / Установка панели

sudo ./install.sh
# Select: 1) Install Panel

sudo ./install_ru.sh
# Выбрать: 1) Установить панель

Management Menu / Меню управления

After installation, run the script again to access the management menu:

После установки запустите скрипт снова для доступа к меню управления:

sudo ./install.sh

Menu options / Опции меню:

• Update Panel / Обновить панель
• Start/Stop/Restart services
• Change ports
• Renew SSL certificates
• View logs and status

Panel updates / Обновление панели: Watchtower in the same stack + XUI_DOCKER_UPDATER_* (in-UI update), or docker compose pull + up -d, or the SharX script Update Panel (pulls sharx + watchtower). / Watchtower в стеке и UI, либо docker compose pull, либо 2) в install_*.sh. Set WATCHTOWER_HTTP_API_TOKEN in production. / WATCHTOWER_HTTP_API_TOKEN в .env для production. If you used build: in compose, the image name (e.g. sharx-code-sharx) is not pullable; use a Harbor image: and docker login — see README_RU/EN.

Remote nodes / Удалённые узлы: enable multi-node, add node and copy docker-compose.yml from the modal (PANEL_URL + SECRET_KEY pairing), then on the worker docker compose up -d --build. Manage in Nodes / Geography. Install script only deploys the panel. / Включите multi-node, в Нодах скопируйте compose из модалки, на узле — docker compose up -d --build. Подробно: node/README.md.

---

🔧 Manual Installation / Ручная установка

Panel Installation / Установка панели

1. Clone the repository / Клонируйте репозиторий:

   git clone https://github.com/konstpic/SharX.git
   cd SharX

2. Configure docker-compose.yml / Настройте docker-compose.yml:

   • Change change_this_password to a secure password
   • Измените change_this_password на надёжный пароль

   XUI_DB_PASSWORD: your_secure_password
   POSTGRES_PASSWORD: your_secure_password

3. Prepare SSL certificates / Подготовьте SSL сертификаты:

   mkdir -p cert
   cp /path/to/fullchain.pem cert/fullchain.pem
   cp /path/to/privkey.pem cert/privkey.pem

4. Start services / Запустите сервисы:

   docker compose up -d

5. Access the panel / Откройте панель:

   http://your-server-ip:2053
   

6. Configure TLS in panel settings / Настройте TLS в панели:

   • Certificate: /app/cert/fullchain.pem
   • Private Key: /app/cert/privkey.pem

7. Remote nodes (optional) / Удалённые узлы (по желанию): multi-node + compose from the add node modal; see node/README.md. / Multi-node и docker-compose из модалки добавления узла — node/README.md.

---

Key Features / Основные возможности

• Multi-node: One panel controls many worker nodes (REST node API, geography / host overrides)

• PostgreSQL: Primary database with in-repo migrations; optional SQLite → PostgreSQL import for legacy 3XUI backups

• Encrypted cookie sessions: Standard stack uses signed/encrypted browser cookies (Gin session store)

• Observability (optional): GET {basePath}panel/metrics (Prometheus text); optional Loki log push and VictoriaMetrics URL in panel settings; downloadable Grafana dashboard JSON for your stack (Grafana itself is not bundled by default)

• Docker + Watchtower: Pre-built images; in-stack or manual updates

• Subscription page builder: Block-based public subscription page (/panel/api/public/subscription) — see below

• Xray core config profiles: Reusable core JSON merged into worker configs in multi-node mode

• Telemt (MTProto): Sidecars on panel (standalone) and workers (multi-node), separate lifecycle from Xray where applicable

• HWID (beta): Per-client device limits (Happ, V2RayTun)

• Auto SSL: Let's Encrypt via install scripts / acme workflow

• Environment-based config: Panel, sub, and DB settings via env (see full docs)

• Multi-node: одна панель и множество worker-узлов (REST API узла, география / host overrides)

• PostgreSQL: основная БД и миграции в репозитории; опциональный импорт SQLite → PostgreSQL со старых бэкапов 3XUI

• Сессии в cookie: веб-сессии в подписанных/зашифрованных cookie (Gin session store)

• Наблюдаемость (опционально): GET {basePath}panel/metrics (текст Prometheus); опционально Loki и VictoriaMetrics в настройках панели; JSON дашборда для импорта в ваш Grafana (сам Grafana по умолчанию не входит в compose)

• Docker + Watchtower: готовые образы; обновления из стека или вручную

• Конструктор страницы подписки: блоковая публичная страница (/panel/api/public/subscription) — см. ниже

• Профили конфига Xray (core): общий core JSON, мердж в конфиг worker в multi-node

• Telemt (MTProto): sidecar на панели (single-node) и на worker; жизненный цикл отделён от Xray где задумано

• HWID (бета): лимит устройств на клиента (Happ, V2RayTun)

• Авто SSL: Let's Encrypt через скрипты установки / acme

• Конфиг через env: панель, подписка, БД — см. полные README_EN/RU

Supported Protocols / Поддерживаемые протоколы

SharX runs three proxy cores from one panel — every protocol reports per-user traffic into one billing pipeline.
SharX управляет тремя ядрами из одной панели — каждый протокол отдаёт поюзерный трафик в единый биллинг.

Inbound (server) / Входящие (сервер)

Xray core / Ядро Xray

• VLESS — XTLS-Vision, REALITY, VLESS-Encryption
• VMess
• Trojan
• Shadowsocks (+ Shadowsocks-2022)
• SOCKS / HTTP (Mixed)
• Dokodemo-door
• WireGuard

Sing-box core / Ядро Sing-box — singleton sidecar / единый процесс-sidecar

• Mieru — anti-DPI
• AnyTLS
• Naïve — Chromium NaïveProxy
• TUIC v5
• Hysteria2
• AmneziaWG 1.5 / WireGuard

Telemt core / Ядро Telemt

• MTProto — Telegram, hot-swappable Telemt fork / переключаемый форк Telemt

Outbound · cascade · egress / Исходящие · каскад · egress

• Cascade members / Участники каскада (node→node): Mieru · AnyTLS · TUIC · Hysteria2
• Cloudflare WARP (WireGuard egress) + AmneziaWG outbound — .conf drag-drop / URI import
• Xray balancer (leastPing observatory) over cascade members / по участникам каскада

Transports & security / Транспорты и безопасность

TLS · REALITY · XTLS-Vision · uTLS · WebSocket / gRPC / HTTPUpgrade / XHTTP · :443 SNI multiplexing (Caddy layer4) · Caddy masking + decoy / маскировка и decoy

Subscription Page Builder / Конструктор страницы подписки

SharX includes a built-in visual constructor for the public subscription page (/panel/api/public/subscription) with block-based layout and per-brand customization.

В SharX есть встроенный визуальный конструктор публичной страницы подписки (/panel/api/public/subscription) с блочной структурой и кастомизацией под бренд.

What you can configure / Что можно настраивать:

• Branding and theme (title, logo, colors, locale)
• Installation guides and app catalog (including Telegram MTProto flow when enabled)
• Add-to-app buttons and deep links
• Response rules (headers, profile metadata, announce/support links)
• Custom HTML/content blocks and ordering
• JSON templates and preview before publishing

Documentation / Документация

For detailed installation instructions, configuration, and migration guide, please see:

Для подробных инструкций по установке, настройке и миграции, пожалуйста, смотрите:

• Full English Documentation - Complete guide in English
• Полная русская документация - Полное руководство на русском языке
• API Documentation - REST API reference / Справочник REST API

Requirements / Требования

• Linux server (Ubuntu, Debian, CentOS, Fedora, Arch, Alpine, openSUSE)

• Root access

• Domain name (optional, for TLS with domain)

• Port 80 open (for SSL certificate issuance)

• Linux сервер (Ubuntu, Debian, CentOS, Fedora, Arch, Alpine, openSUSE)

• Root доступ

• Доменное имя (опционально, для TLS с доменом)

• Открытый порт 80 (для выпуска SSL сертификата)

Support / Поддержка

For issues, questions, or contributions, please refer to the project repository.

По вопросам, проблемам или вкладу в проект обращайтесь в репозиторий проекта.

🙏 Acknowledgements / Происхождение и благодарности

SharX (this repo) is a fork of konstpic/SharX, which is a fork of MHSanaei/3x-ui (3X-UI) — itself built on the original alireza0/x-ui panel for XTLS/Xray-core.

SharX (этот репозиторий) — форк konstpic/SharX, который, в свою очередь, является форком MHSanaei/3x-ui (3X-UI), выросшего из оригинальной панели alireza0/x-ui для ядра XTLS/Xray-core.

Inspired by / Вдохновлялись:

• Hiddify Manager & hiddify-sing-box — multi-protocol UX, decoy masking / мульти-протокольный UX и маскировка через decoy-сайт
• shtorm-7/sing-box-extended — AmneziaWG + per-user v2ray_api stats / AmneziaWG и поюзерная статистика
• SagerNet/sing-box, AmneziaWG, enfein/mieru, Caddy (caddy-l4), Telegram MTProto / Telemt

What we combined / Что объединили: three proxy cores — Xray-core + sing-box + Telemt (MTProto) — under one multi-node panel with cascade chains, Cloudflare WARP egress and :443 SNI masking.

Что объединили: три прокси-ядра — Xray-core + sing-box + Telemt (MTProto) — в одной мульти-нод панели: каскадные цепочки между узлами, egress через Cloudflare WARP и маскировка нескольких протоколов на :443 по SNI.

---

Note: This version uses Docker containers for easy deployment. All images are pre-built and ready to use.

Примечание: Эта версия использует Docker-контейнеры для легкого развертывания. Все образы предварительно собраны и готовы к использованию.