Исходный код вики 3x-ui
Версия 3.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 | bash <(curl -sSL https://get.docker.com) | ||
| 63 | git clone https://github.com/mhsanaei/3x-ui.git | ||
| 64 | cd 3x-ui | ||
| 65 | docker compose up -d | ||
| 66 | |||
| 67 | 1. Установите Docker: | ||
| 68 | 1. Склонируйте репозиторий проекта: | ||
| 69 | 1. Запустите сервис: | ||
| 70 | |||
| 71 | Или альтернативный вариант: | ||
| 72 | |||
| 73 | docker run -itd \ | ||
| 74 | -e XRAY_VMESS_AEAD_FORCED=false \ | ||
| 75 | -v $PWD/db/:/etc/x-ui/ \ | ||
| 76 | -v $PWD/cert/:/root/cert/ \ | ||
| 77 | --network=host \ | ||
| 78 | --restart=unless-stopped \ | ||
| 79 | --name 3x-ui \ | ||
| 80 | ghcr.io/mhsanaei/3x-ui:latest | ||
| 81 | |||
| 82 | ## Настройка SSL-сертификата | ||
| 83 | |||
| 84 | Существует несколько способов настройки SSL-сертификата в 3x-ui | ||
| 85 | |||
| 86 | ### ACME | ||
| 87 | |||
| 88 | **Для управления SSL-сертификатами с помощью ACME:** | ||
| 89 | |||
| 90 | 1. Убедитесь, что ваш домен корректно указывает на этот сервер (т.е. А-запись в DNS настроена правильно). | ||
| 91 | 1. Запустите команду x-ui в терминале, затем выберите пункт Управление SSL-сертификатами. | ||
| 92 | 1. Вам будут предложены следующие варианты: | ||
| 93 | * **Получить SSL:** Получить SSL-сертификаты. | ||
| 94 | * **Отозвать:** Отозвать существующие SSL-сертификаты. | ||
| 95 | * **Принудительное продление:** Принудительно продлить SSL-сертификаты. | ||
| 96 | * **Показать существующие домены:** Отобразить все сертификаты доменов, доступные на сервере. | ||
| 97 | * **Указать пути к сертификатам для панели:** Указать сертификат для вашего домена, который будет использоваться панелью управления. | ||
| 98 | |||
| 99 | ### Certbot | ||
| 100 | |||
| 101 | apt-get install certbot -y | ||
| 102 | certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com | ||
| 103 | certbot renew --dry-run | ||
| 104 | |||
| 105 | Чтобы установить и использовать Certbot, достаточно ввести эти команды: | ||
| 106 | |||
| 107 | * где yourdomain.com — ваш домен | ||
| 108 | |||
| 109 | ## Вход в веб-панель | ||
| 110 | |||
| 111 | После установки панели управления, следуйте инструкциям ниже: | ||
| 112 | |||
| 113 | 1. Введите команду x-ui | ||
| 114 | 1. Выберите опцию 10, введя соответствующее число в терминал. | ||
| 115 | |||
| 116 | Вам будут предоставлены данные для входа в панель в таком виде:![[console|view-current-settings.png]] | ||
| 117 | |||
| 118 | Вам нужно будет перейти по ссылке, которая указывается в Access URL и авторизоваться под своими username и password | ||
| 119 | |||
| 120 | ## Настройка подключений (Inbounds) | ||
| 121 | |||
| 122 | ### Создание нового подключения | ||
| 123 | |||
| 124 | 1. Перейдите на страницу "Inbounds" | ||
| 125 | 1. Нажмите кнопку "Add inbound" для создания нового подключения | ||
| 126 | 1. В открывшемся окне укажите любое удобное название в поле "Remark" | ||
| 127 | 1. Выберите тип протокола (VMess, VLESS, Trojan, ShadowSocks или WireGuard) | ||
| 128 | |||
| 129 | ### Настройка протоколов | ||
| 130 | |||
| 131 | #### Для VLESS + Reality (рекомендуется для обхода блокировок) | ||
| 132 | |||
| 133 | 1. Выберите тип безопасности - Reality | ||
| 134 | 1. Установите uTLS - chrome | ||
| 135 | 1. В поле "Dest" укажите значение, например dl.google.com:443 | ||
| 136 | 1. В поле "SNI" укажите значение, например dl.google.com | ||
| 137 | 1. Нажмите Get New Cert для автоматической генерации случайных ключей | ||
| 138 | 1. Нажмите на кнопку Create для сохранения и создания подключения | ||
| 139 | |||
| 140 | ### Настройка ограничений | ||
| 141 | |||
| 142 | Для каждого подключения можно настроить: | ||
| 143 | |||
| 144 | * Лимит трафика (в гигабайтах) | ||
| 145 | * Срок действия (в днях) | ||
| 146 | * Лимит IP-адресов (количество одновременных подключений) | ||
| 147 | * Включить или отключить ограничения | ||
| 148 | |||
| 149 | ## Управление пользователями | ||
| 150 | |||
| 151 | В разделе Inbounds: | ||
| 152 | |||
| 153 | 1. Для просмотра дополнительных настроек нажмите на значок + рядом с созданным подключением | ||
| 154 | 1. Для создания нового пользователя выберите опцию "Add Client"![[add client|add_client.png]] | ||
| 155 | 1. Для каждого пользователя можно настроить: | ||
| 156 | * Имя (удобное вам название) | ||
| 157 | * Лимит трафика | ||
| 158 | * Срок действия | ||
| 159 | * Уникальный ID | ||
| 160 | |||
| 161 | ## Подключение клиентов | ||
| 162 | |||
| 163 | ### Windows, macOS и Linux | ||
| 164 | |||
| 165 | Рекомендуемые клиенты: | ||
| 166 | |||
| 167 | * Hiddify (Windows, Linux, macOS) | ||
| 168 | * NekoRay (Windows, Linux) | ||
| 169 | |||
| 170 | Для подключения: | ||
| 171 | |||
| 172 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 173 | 1. Скопируйте конфигурацию либо отсканируйте QR-код с помощью VPN-клиента | ||
| 174 | 1. Импортируйте конфигурацию в клиент и совершите подключение | ||
| 175 | |||
| 176 | ### Android | ||
| 177 | |||
| 178 | Рекомендуемые клиенты: | ||
| 179 | |||
| 180 | * Hiddify | ||
| 181 | * v2rayNG | ||
| 182 | |||
| 183 | Для подключения: | ||
| 184 | |||
| 185 | 1. Установите клиент из Google Play | ||
| 186 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 187 | 1. Отсканируйте QR-код с помощью VPN-клиента либо скопируйте и импортируйте конфигурацию | ||
| 188 | 1. Совершите подключение используя импортированную конфигурацию | ||
| 189 | |||
| 190 | ### iOS | ||
| 191 | |||
| 192 | Рекомендуемые клиенты: | ||
| 193 | |||
| 194 | * FoXray | ||
| 195 | * v2box | ||
| 196 | * ShadowRocket | ||
| 197 | |||
| 198 | Для подключения: | ||
| 199 | |||
| 200 | 1. Установите клиент из App Store | ||
| 201 | 1. В веб-панели 3x-ui нажмите на QR-код нужного пользователя | ||
| 202 | 1. Отсканируйте QR-код с помощью клиента либо скопируйте и импортируйте конфигурацию | ||
| 203 | 1. Совершите подключение используя импортированную конфигурацию | ||
| 204 | |||
| 205 | ## Мониторинг и статистика | ||
| 206 | |||
| 207 | В веб-панели 3X-UI вы можете следить за активностью пользователей: | ||
| 208 | |||
| 209 | * Общее потребление трафика | ||
| 210 | * Использование трафика по пользователям | ||
| 211 | * Статус подключений | ||
| 212 | * Срок действия подписок пользователей | ||
| 213 | * Использование IP-адресов | ||
| 214 | |||
| 215 | ## Обновление 3X-UI | ||
| 216 | |||
| 217 | Для обновления панели до последней версии выполните следующую команду: | ||
| 218 | |||
| 219 | Если вы используете Docker, нужно будет выполнить следующие команды: | ||
| 220 | |||
| 221 | ## Решение проблем | ||
| 222 | |||
| 223 | ### Стандартные настройки | ||
| 224 | |||
| 225 | * Порт: 2053 | ||
| 226 | * Путь к базе данных: /etc/x-ui/x-ui.db | ||
| 227 | * Путь к конфигурации xray: /usr/local/x-ui/bin/config.json | ||
| 228 | |||
| 229 | ### Дополнительные настройки Xray | ||
| 230 | |||
| 231 | В веб-панели можно настроить дополнительные опции Xray: | ||
| 232 | |||
| 233 | * Блокировка рекламы | ||
| 234 | * Блокировка IP-адресов определенных стран | ||
| 235 | * Блокировка доменов | ||
| 236 | * Маршрутизация Google, Netflix, Spotify, OpenAI (ChatGPT) через WARP | ||
| 237 | |||
| 238 | ### Настройка WARP | ||
| 239 | |||
| 240 | Для версий v2.1.0 и более поздних — WARP встроен и не требует дополнительной установки. | ||
| 241 | |||
| 242 | Просто включите нужную конфигурацию в панели. |