Исходный код вики 3x-ui
Версия 2.1 от Anton Krivchenkov на 28.02.2026 14:02
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | # Руководство по установке и использованию панели 3x-ui | ||
| 2 | |||
| 3 | ![[3x-ui|x-ui.png]] | ||
| 4 | |||
| 5 | 3X-UI - это многофункциональная веб-панель для управления серверами, поддерживающая множество протоколов, таких как VMess, VLESS, Trojan, ShadowSocks и WireGuard. | ||
| 6 | |||
| 7 | Эта панель обеспечивает легкое управление приватными соединениями, настройку нескольких пользователей и установку ограничений по трафику, сроку действия и IP-адресам. | ||
| 8 | |||
| 9 | Подсказка | ||
| 10 | |||
| 11 | Клиентам нашего хостинга доступна полностью автоматическая установка панели 3X-UI при первоначальном заказе услуги или с помощью скриптов в панели управления ВМ. Останется только лишь создать пользователей и настроить конфигурации для устройств. | ||
| 12 | |||
| 13 | #### Особенности 3X-UI | ||
| 14 | |||
| 15 | * Многоязычный интерфейс (английский, фарси, китайский, русский, вьетнамский, испанский) | ||
| 16 | * Поддержка множества протоколов (VMess, VLESS, Trojan, ShadowSocks, WireGuard) | ||
| 17 | * Управление несколькими пользователями | ||
| 18 | * Установка лимитов трафика, срока действия и IP-адресов | ||
| 19 | * Автоматическое управление SSL-сертификатами | ||
| 20 | * Интуитивно понятный веб-интерфейс | ||
| 21 | * Статистика использования трафика | ||
| 22 | * Возможность блокировки рекламы и маршрутизации трафика | ||
| 23 | * Поддержка технологии Reality для обхода блокировок | ||
| 24 | |||
| 25 | ## Процесс установки | ||
| 26 | |||
| 27 | ### Автоматическая установка для клиентов хостинга | ||
| 28 | |||
| 29 | #### При заказе услуги | ||
| 30 | |||
| 31 | В меню заказа через выпадающее меню выберите опцию "3X-UI", завершите заказ и дождитесь окончания обработки услуги. | ||
| 32 | |||
| 33 | Сразу после активации сервера вы получите данные для входа в ОС сервера, а также данные для входа в 3X-UI, после чего вы можете [совершить вход](https://wiki.senko.digital/ru/vpn/3x-ui#%D0%B2%D1%85%D0%BE%D0%B4-%D0%B2-%D0%B2%D0%B5%D0%B1-%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C) и начать [настройку подключений](https://wiki.senko.digital/ru/vpn/3x-ui#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B8%D0%BA%D0%B0-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B8-inbounds). | ||
| 34 | |||
| 35 | #### Через панель управления ВМ | ||
| 36 | |||
| 37 | Перейдите в [панель управления ВМ](https://vm.senko.digital/), перейдите в управление нужным сервером, в правом верхнем углу раскройте "Меню" и выберите опцию "Запустить скрипт". | ||
| 38 | |||
| 39 | В диалоге выберите опцию "3X-UI" и активируйте опцию "Отправить письмо, которое привязано к скрипту". | ||
| 40 | |||
| 41 | По окончанию установки вы получите письмо с данными для входа в панель управления, после чего вы можете [совершить вход](https://wiki.senko.digital/ru/vpn/3x-ui#%D0%B2%D1%85%D0%BE%D0%B4-%D0%B2-%D0%B2%D0%B5%D0%B1-%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C) и начать [настройку подключений](https://wiki.senko.digital/ru/vpn/3x-ui#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B8%D0%BA%D0%B0-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B8-inbounds). | ||
| 42 | |||
| 43 | ### Стандартная установка | ||
| 44 | |||
| 45 | bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) | ||
| 46 | |||
| 47 | Для установки 3X-UI выполните следующую команду: | ||
| 48 | |||
| 49 | Во время установки вам будет предложено: | ||
| 50 | |||
| 51 | 1. Изменить настройки панели (рекомендуется ответить y для повышения безопасности) | ||
| 52 | 1. Указать порт панели (рекомендуется использовать нестандартный) | ||
| 53 | |||
| 54 | ### Установка определённой версии | ||
| 55 | |||
| 56 | `VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION` | ||
| 57 | |||
| 58 | Для установки иной версии панели, добавьте номер версии в переменную команды установки. Например, для версии v1.7.9: | ||
| 59 | |||
| 60 | ### Установка через Docker | ||
| 61 | |||
| 62 | 1. Установите Docker: | ||
| 63 | 1. Склонируйте репозиторий проекта: | ||
| 64 | 1. Запустите сервис: | ||
| 65 | |||
| 66 | Или альтернативный вариант: | ||
| 67 | |||
| 68 | ## Настройка SSL-сертификата | ||
| 69 | |||
| 70 | Существует несколько способов настройки SSL-сертификата в 3x-ui | ||
| 71 | |||
| 72 | ### ACME | ||
| 73 | |||
| 74 | **Для управления SSL-сертификатами с помощью ACME:** | ||
| 75 | |||
| 76 | 1. Убедитесь, что ваш домен корректно указывает на этот сервер (т.е. А-запись в DNS настроена правильно). | ||
| 77 | 1. Запустите команду x-ui в терминале, затем выберите пункт Управление SSL-сертификатами. | ||
| 78 | 1. Вам будут предложены следующие варианты: | ||
| 79 | * **Получить SSL:** Получить SSL-сертификаты. | ||
| 80 | * **Отозвать:** Отозвать существующие SSL-сертификаты. | ||
| 81 | * **Принудительное продление:** Принудительно продлить SSL-сертификаты. | ||
| 82 | * **Показать существующие домены:** Отобразить все сертификаты доменов, доступные на сервере. | ||
| 83 | * **Указать пути к сертификатам для панели:** Указать сертификат для вашего домена, который будет использоваться панелью управления. | ||
| 84 | |||
| 85 | ### Certbot | ||
| 86 | |||
| 87 | Чтобы установить и использовать Certbot, достаточно ввести эти команды: | ||
| 88 | |||
| 89 | * где yourdomain.com — ваш домен | ||
| 90 | |||
| 91 | ## Вход в веб-панель | ||
| 92 | |||
| 93 | После установки панели управления, следуйте инструкциям ниже: | ||
| 94 | |||
| 95 | 1. Введите команду x-ui | ||
| 96 | 1. Выберите опцию 10, введя соответствующее число в терминал. | ||
| 97 | |||
| 98 | Вам будут предоставлены данные для входа в панель в таком виде:![[console|view-current-settings.png]] | ||
| 99 | |||
| 100 | Вам нужно будет перейти по ссылке, которая указывается в Access URL и авторизоваться под своими username и password | ||
| 101 | |||
| 102 | ## Настройка подключений (Inbounds) | ||
| 103 | |||
| 104 | ### Создание нового подключения | ||
| 105 | |||
| 106 | 1. Перейдите на страницу "Inbounds" | ||
| 107 | 1. Нажмите кнопку "Add inbound" для создания нового подключения | ||
| 108 | 1. В открывшемся окне укажите любое удобное название в поле "Remark" | ||
| 109 | 1. Выберите тип протокола (VMess, VLESS, Trojan, ShadowSocks или WireGuard) | ||
| 110 | |||
| 111 | ### Настройка протоколов | ||
| 112 | |||
| 113 | #### Для VLESS + Reality (рекомендуется для обхода блокировок) | ||
| 114 | |||
| 115 | 1. Выберите тип безопасности - Reality | ||
| 116 | 1. Установите uTLS - chrome | ||
| 117 | 1. В поле "Dest" укажите значение, например dl.google.com:443 | ||
| 118 | 1. В поле "SNI" укажите значение, например dl.google.com | ||
| 119 | 1. Нажмите Get New Cert для автоматической генерации случайных ключей | ||
| 120 | 1. Нажмите на кнопку Create для сохранения и создания подключения | ||
| 121 | |||
| 122 | ### Настройка ограничений | ||
| 123 | |||
| 124 | Для каждого подключения можно настроить: | ||
| 125 | |||
| 126 | * Лимит трафика (в гигабайтах) | ||
| 127 | * Срок действия (в днях) | ||
| 128 | * Лимит IP-адресов (количество одновременных подключений) | ||
| 129 | * Включить или отключить ограничения | ||
| 130 | |||
| 131 | ## Управление пользователями | ||
| 132 | |||
| 133 | В разделе Inbounds: | ||
| 134 | |||
| 135 | 1. Для просмотра дополнительных настроек нажмите на значок + рядом с созданным подключением | ||
| 136 | 1. Для создания нового пользователя выберите опцию "Add Client"![[add client|add_client.png]] | ||
| 137 | 1. Для каждого пользователя можно настроить: | ||
| 138 | * Имя (удобное вам название) | ||
| 139 | * Лимит трафика | ||
| 140 | * Срок действия | ||
| 141 | * Уникальный ID | ||
| 142 | |||
| 143 | ## Подключение клиентов | ||
| 144 | |||
| 145 | ### Windows, macOS и Linux | ||
| 146 | |||
| 147 | Рекомендуемые клиенты: | ||
| 148 | |||
| 149 | * Hiddify (Windows, Linux, macOS) | ||
| 150 | * NekoRay (Windows, Linux) | ||
| 151 | |||
| 152 | Для подключения: | ||
| 153 | |||
| 154 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 155 | 1. Скопируйте конфигурацию либо отсканируйте QR-код с помощью VPN-клиента | ||
| 156 | 1. Импортируйте конфигурацию в клиент и совершите подключение | ||
| 157 | |||
| 158 | ### Android | ||
| 159 | |||
| 160 | Рекомендуемые клиенты: | ||
| 161 | |||
| 162 | * Hiddify | ||
| 163 | * v2rayNG | ||
| 164 | |||
| 165 | Для подключения: | ||
| 166 | |||
| 167 | 1. Установите клиент из Google Play | ||
| 168 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 169 | 1. Отсканируйте QR-код с помощью VPN-клиента либо скопируйте и импортируйте конфигурацию | ||
| 170 | 1. Совершите подключение используя импортированную конфигурацию | ||
| 171 | |||
| 172 | ### iOS | ||
| 173 | |||
| 174 | Рекомендуемые клиенты: | ||
| 175 | |||
| 176 | * FoXray | ||
| 177 | * v2box | ||
| 178 | * ShadowRocket | ||
| 179 | |||
| 180 | Для подключения: | ||
| 181 | |||
| 182 | 1. Установите клиент из App Store | ||
| 183 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 184 | 1. Отсканируйте QR-код с помощью клиента либо скопируйте и импортируйте конфигурацию | ||
| 185 | 1. Совершите подключение используя импортированную конфигурацию | ||
| 186 | |||
| 187 | ## Мониторинг и статистика | ||
| 188 | |||
| 189 | В веб-панели 3X-UI вы можете следить за активностью пользователей: | ||
| 190 | |||
| 191 | * Общее потребление трафика | ||
| 192 | * Использование трафика по пользователям | ||
| 193 | * Статус подключений | ||
| 194 | * Срок действия подписок пользователей | ||
| 195 | * Использование IP-адресов | ||
| 196 | |||
| 197 | ## Обновление 3X-UI | ||
| 198 | |||
| 199 | Для обновления панели до последней версии выполните следующую команду: | ||
| 200 | |||
| 201 | Если вы используете Docker, нужно будет выполнить следующие команды: | ||
| 202 | |||
| 203 | ## Решение проблем | ||
| 204 | |||
| 205 | ### Стандартные настройки | ||
| 206 | |||
| 207 | * Порт: 2053 | ||
| 208 | * Путь к базе данных: /etc/x-ui/x-ui.db | ||
| 209 | * Путь к конфигурации xray: /usr/local/x-ui/bin/config.json | ||
| 210 | |||
| 211 | ### Дополнительные настройки Xray | ||
| 212 | |||
| 213 | В веб-панели можно настроить дополнительные опции Xray: | ||
| 214 | |||
| 215 | * Блокировка рекламы | ||
| 216 | * Блокировка IP-адресов определенных стран | ||
| 217 | * Блокировка доменов | ||
| 218 | * Маршрутизация Google, Netflix, Spotify, OpenAI (ChatGPT) через WARP | ||
| 219 | |||
| 220 | ### Настройка WARP | ||
| 221 | |||
| 222 | Для версий v2.1.0 и более поздних — WARP встроен и не требует дополнительной установки. | ||
| 223 | |||
| 224 | Просто включите нужную конфигурацию в панели. |