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