Appearance

Руководство по установке и использованию панели 3x-ui ​

3x-ui

3x-ui - это многофункциональная веб-панель для управления VPN-серверами, поддерживающая множество протоколов, таких как VMess, VLESS, Trojan, ShadowSocks и WireGuard.

Эта панель обеспечивает легкое управление VPN-соединениями, настройку нескольких пользователей и установку ограничений по трафику, сроку действия и IP-адресам.

Особенности 3x-ui ​

  • Многоязычный интерфейс (английский, фарси, китайский, русский, вьетнамский, испанский)
  • Поддержка множества протоколов (VMess, VLESS, Trojan, ShadowSocks, WireGuard)
  • Управление несколькими пользователями
  • Установка лимитов трафика, срока действия и IP-адресов
  • Автоматическое управление SSL-сертификатами
  • Интуитивно понятный веб-интерфейс
  • Статистика использования трафика
  • Возможность блокировки рекламы и маршрутизации трафика
  • Поддержка технологии Reality для обхода блокировок

Установка ​

Стандартная установка ​

Для установки 3x-ui выполните следующую команду:

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

Во время установки вам будет предложено:

  1. Изменить настройки панели (рекомендуется ответить y для повышения безопасности)
  2. Указать порт панели (рекомендуется использовать нестандартный)

Установка определенной версии ​

Для установки определенной версии добавьте номер версии в конец команды установки. Например, для версии v1.7.9:

bash
VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION

Установка через Docker ​

  1. Установите Docker:
bash
bash <(curl -sSL https://get.docker.com)
  1. Склонируйте репозиторий проекта:
bash
git clone https://github.com/mhsanaei/3x-ui.git
cd 3x-ui
  1. Запустите сервис:
bash
docker compose up -d

Или альтернативный вариант:

bash
docker run -itd \
   -e XRAY_VMESS_AEAD_FORCED=false \
   -v $PWD/db/:/etc/x-ui/ \
   -v $PWD/cert/:/root/cert/ \
   --network=host \
   --restart=unless-stopped \
   --name 3x-ui \
   ghcr.io/mhsanaei/3x-ui:latest

Настройка SSL-сертификата ​

Существует несколько способов настройки SSL-сертификата в 3x-ui

ACME ​

Для управления SSL-сертификатами с помощью ACME:

  1. Убедитесь, что ваш домен корректно указывает на этот сервер (т.е. А-запись в DNS настроена правильно).
  2. Запустите команду x-ui в терминале, затем выберите пункт Управление SSL-сертификатами.
  3. Вам будут предложены следующие варианты:
    • Получить SSL: Получить SSL-сертификаты.
    • Отозвать: Отозвать существующие SSL-сертификаты.
    • Принудительное продление: Принудительно продлить SSL-сертификаты.
    • Показать существующие домены: Отобразить все сертификаты доменов, доступные на сервере.
    • Указать пути к сертификатам для панели: Указать сертификат для вашего домена, который будет использоваться панелью управления.

Certbot ​

Чтобы установить и использовать Certbot, достаточно ввести эти команды:

bash
apt-get install certbot -y
certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com
certbot renew --dry-run
  • где yourdomain.com — ваш домен

Вход в веб-панель ​

После установки панели управления, следуйте инструкциям ниже:

  1. Введите команду x-ui
  2. Выберите опцию 10, введя соответствующее число в терминал.

Вам будут предоставлены данные для входа в панель в таком виде: console

Вам нужно будет перейти по ссылке, которая указывается в Access URL и авторизоваться под своими username и password

Настройка подключений (Inbounds) ​

Создание нового подключения ​

  1. Перейдите на страницу "Inbounds"
  2. Нажмите кнопку "Add inbound" для создания нового подключения
  3. В открывшемся окне укажите любое удобное название в поле "Remark"
  4. Выберите тип протокола (VMess, VLESS, Trojan, ShadowSocks или WireGuard)

Настройка протоколов ​

Для VLESS + Reality (рекомендуется для обхода блокировок): ​

  1. Выберите тип безопасности - Reality
  2. Установите uTLS - chrome
  3. В поле "Dest" укажите значение, например dl.google.com:443
  4. В поле "SNI" укажите значение, например dl.google.com
  5. Нажмите Get New Cert для автоматической генерации случайных ключей
  6. Нажмите на кнопку Create для сохранения и создания подключения

Настройка ограничений ​

Для каждого подключения можно настроить:

  • Лимит трафика (в гигабайтах)
  • Срок действия (в днях)
  • Лимит IP-адресов (количество одновременных подключений)
  • Включить или отключить ограничения

Управление пользователями ​

В разделе Inbounds:

  1. Для просмотра дополнительных настроек нажмите на значок + рядом с созданным подключением
  2. Для создания нового пользователя выберите опцию "Add Client" add client
  3. Для каждого пользователя можно настроить:
    • Имя (удобное вам название)
    • Лимит трафика
    • Срок действия
    • Уникальный ID

Подключение клиентов ​

Windows, macOS и Linux ​

Рекомендуемые клиенты:

  • Hiddify (Windows, Linux, macOS)
  • NekoRay (Windows, Linux)

Для подключения:

  1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя
  2. Скопируйте конфигурацию либо отсканируйте QR-код с помощью VPN-клиента
  3. Импортируйте конфигурацию в клиент и совершите подключение

Android ​

Рекомендуемые клиенты:

  • Hiddify
  • v2rayNG

Для подключения:

  1. Установите клиент из Google Play
  2. В веб-панели 3x-ui нажмите на QR-код нужного пользователя
  3. Отсканируйте QR-код с помощью VPN-клиента либо скопируйте и импортируйте конфигурацию
  4. Совершите подключение используя импортированную конфигурацию

iOS ​

Рекомендуемые клиенты:

  • FoXray
  • v2box
  • ShadowRocket

Для подключения:

  1. Установите клиент из App Store
  2. В веб-панели 3x-ui нажмите на QR-код нужного пользователя
  3. Отсканируйте QR-код с помощью клиента либо скопируйте и импортируйте конфигурацию
  4. Совершите подключение используя импортированную конфигурацию

Мониторинг и статистика ​

В веб-панели 3x-ui вы можете следить за активностью клиентов:

  • Общее потребление трафика
  • Использование трафика по пользователям
  • Статус подключений
  • Срок действия подписок пользователей
  • Использование IP-адресов

Обновление 3x-ui ​

Для обновления панели до последней версии выполните следующую команду:

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

Если вы используете Docker, нужно будет выполнить следующие команды:

bash
cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d

Решение проблем ​

Стандартные настройки ​

  • Порт: 2053
  • Путь к базе данных: /etc/x-ui/x-ui.db
  • Путь к конфигурации xray: /usr/local/x-ui/bin/config.json

Дополнительные настройки Xray ​

В веб-панели можно настроить дополнительные опции Xray:

  • Блокировка рекламы
  • Блокировка IP-адресов определенных стран
  • Блокировка доменов
  • Маршрутизация Google, Netflix, Spotify, OpenAI (ChatGPT) через WARP

Настройка WARP ​

Для версий v2.1.0 и более поздних — WARP встроен и не требует дополнительной установки.

Просто включите нужную конфигурацию в панели. warp