Установка 3x-ui на VPS занимает около десяти минут, если сервер соответствует минимальным требованиям и вы заранее подготовили SSH-доступ. Панель 3x-ui — это веб-интерфейс для управления прокси-сервером на базе Xray-core, который поддерживает протоколы VLESS, VMess, Trojan и Shadowsocks. Ошибка на этапе установки чаще всего связана не с самой панелью, а с неподготовленным сервером: закрытым портом, устаревшей системой или конфликтом занятых портов.
В этом руководстве разберём весь процесс: от выбора VPS и подключения по SSH до запуска установочного скрипта, первого входа в панель и базовой настройки безопасности. Инструкция ориентирована на Ubuntu 20.04/22.04 и Debian 11/12 — именно эти системы чаще всего используются для 3x-ui, хотя панель работает и на других дистрибутивах Linux.
Что нужно подготовить перед установкой
Прежде чем запускать установку, убедитесь, что у вас есть всё необходимое. Отсутствие любого из пунктов ниже — частая причина того, что скрипт завершается с ошибкой или панель оказывается недоступна после установки.
- 🖥️ VPS с чистой установкой Ubuntu или Debian (рекомендуются свежие версии системы)
- 🔑 Root-доступ или пользователь с правами
sudo - 🌐 Публичный IP-адрес сервера и данные для SSH-подключения
- 🔓 Свободные порты для панели и прокси-подключений
- 💾 Минимальные ресурсы: 1 vCPU и 512 МБ ОЗУ обычно достаточно для личного использования
Если сервер только что арендован, не спешите ставить панель. Сначала обновите систему и проверьте, что SSH-соединение стабильно. На некоторых хостингах по умолчанию включён агрессивный файрвол, который блокирует нестандартные порты — это нужно учесть заранее.
⚠️ Внимание: не устанавливайте 3x-ui на сервер, где уже работают другие панели (например, x-ui старой версии или аналогичные решения) без предварительной очистки. Конфликт портов и конфигураций Xray приведёт к тому, что ни одна из панелей не запустится корректно.
Шаг 1. Подключение к серверу и обновление системы
Подключитесь к VPS по SSH. На Windows для этого подойдут PuTTY или встроенный клиент OpenSSH в PowerShell, на Linux и macOS — стандартный терминал. Команда подключения выглядит так:
ssh root@IP_вашего_сервераПосле входа первым делом обновите списки пакетов и установите доступные обновления. Это закроет известные уязвимости и гарантирует, что установочный скрипт получит актуальные зависимости, например curl, который нужен для загрузки панели.
apt update && apt upgrade -yОбновление может занять несколько минут в зависимости от того, насколько свежий образ системы предоставил хостер. Если в процессе появится диалог с вопросом о перезапуске служб — подтвердите. После завершения проверьте, что curl установлен: введите curl --version. Если команда не найдена, установите пакет командой apt install curl -y.
Шаг 2. Запуск установочного скрипта 3x-ui
Установка 3x-ui выполняется одной командой — официальный скрипт из репозитория проекта на GitHub сам скачает панель, ядро Xray и создаст системную службу. Команда выглядит следующим образом:
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)В процессе скрипт задаст несколько вопросов. Как правило, предлагается указать имя пользователя, пароль и порт для доступа к веб-панели, либо скрипт сгенерирует их автоматически и покажет в конце установки. Обязательно сохраните эти данные — без них войти в панель не получится, а восстановление потребует сброса через консольную команду.
☑️ Что проверить после завершения скрипта
После установки управлять панелью можно через встроенное меню: введите команду x-ui в терминале. Откроется текстовое меню с пунктами запуска, остановки, перезапуска, сброса настроек и просмотра текущей конфигурации. Это удобно, если веб-интерфейс недоступен и нужно быстро диагностировать проблему.
Шаг 3. Первый вход в панель и базовая настройка
Веб-интерфейс открывается в браузере по адресу вида http://IP_сервера:порт/путь, где порт и секретный путь указаны в данных, которые выдал скрипт. Секретный путь (web base path) — важный элемент защиты: без него страница входа будет отдавать ошибку, что затрудняет обнаружение панели сканерами.
После входа первым делом смените стандартные учётные данные в настройках панели, если они были сгенерированы автоматически и вы хотите задать свои. Затем можно создать первое подключение (inbound): выберите протокол VLESS с Reality — на текущий момент это один из наиболее устойчивых к блокировкам вариантов, и панель позволяет настроить его в несколько кликов без ручного редактирования конфигурации Xray.
Для подключения клиентских устройств панель генерирует ссылку подписки и QR-код. Их можно импортировать в клиенты вроде v2rayNG (Android), Nekoray или FoXray и аналогичные приложения на других платформах. Проверьте работоспособность сразу после создания inbound — так проще локализовать проблему, если она возникнет.
Открытие портов и настройка файрвола
Одна из самых частых причин, по которой свежеустановленная панель «не открывается», — закрытый порт. Файрвол может работать на двух уровнях: в самой системе (ufw, iptables) и в панели управления хостингом. Проверить нужно оба.
Если используется ufw, откройте порт панели и порты созданных подключений. Пример для порта панели:
ufw allow 2053/tcpПодставьте свой реальный порт вместо примера. После добавления правил проверьте статус командой ufw status. У некоторых хостеров дополнительно действует облачный файрвол в личном кабинете — там правила добавляются через веб-интерфейс, и локальные настройки сервера их не переопределяют.
| Компонент | Назначение порта | Нужно ли открывать |
|---|---|---|
| Веб-панель 3x-ui | Доступ к интерфейсу управления | Да, желательно ограничить по IP |
| Inbound VLESS/Trojan | Подключения клиентов к прокси | Да, обязательно |
| SSH (порт 22) | Управление сервером | Да, рекомендуется сменить порт |
| Служебные порты Xray | Внутренние процессы ядра | Нет, только локально |
⚠️ Внимание: не открывайте порт панели для всего интернета без необходимости. Если ваш хостер или файрвол позволяет ограничить доступ по IP-адресу, разрешите подключение к панели только со своего адреса. Прокси-порты при этом должны оставаться открытыми — иначе клиенты не смогут подключиться.
Защита панели и сервера после установки
Сервер с открытой панелью управления — заметная цель для ботов, которые постоянно сканируют интернет в поисках типовых портов и стандартных страниц входа. Базовые меры защиты занимают немного времени, но существенно снижают риск компрометации.
- 🔐 Используйте сложный пароль и нестандартный секретный путь панели
- 🛡️ Настройте вход по SSH только с ключами, отключив авторизацию по паролю
- 🔢 Смените стандартный SSH-порт на произвольный
- 📜 Включите SSL/TLS для веб-панели, если обращаетесь к ней по домену
- 🔄 Регулярно обновляйте панель через меню
x-ui— выходят версии с исправлениями
Отдельно стоит сказать про домен. Привязка доменного имени к серверу не обязательна для работы прокси, но упрощает выпуск TLS-сертификата и настройку некоторых транспортов. Если домена нет, панель и VLESS с Reality отлично работают и по чистому IP.
Как сбросить логин и пароль панели, если они утеряны
Подключитесь к серверу по SSH и введите команду x-ui. В текстовом меню выберите пункт сброса настроек (Reset) — панель сгенерирует новые случайные учётные данные или позволит задать свои, в зависимости от версии. После сброса перезапустите службу через то же меню и войдите с новыми данными.
Типичные ошибки при установке и их решение
Даже при строгом следовании инструкции что-то может пойти не так. Ниже — проблемы, с которыми пользователи сталкиваются чаще всего, и способы их диагностики.
Панель не открывается в браузере. Проверьте три вещи по порядку: запущена ли служба (systemctl status x-ui), открыт ли порт в файрволе и правильно ли вы указали секретный путь в адресе. Чаще всего причина — именно закрытый порт на уровне хостера.
Скрипт установки обрывается с ошибкой загрузки. Возможная причина — недоступность GitHub с сервера или отсутствие curl. Установите пакет вручную и повторите попытку. Если сеть сервера ограничена, проверьте резолвинг доменов командой ping github.com.
Прокси создан, но клиент не подключается. Убедитесь, что порт inbound открыт, а в настройках клиента корректно импортирована ссылка. Также проверьте логи Xray через меню панели — там видно, доходят ли подключения до сервера вообще.
⚠️ Внимание: не запускайте установочный скрипт повторно «для надёжности», если первая установка завершилась успешно. Повторный запуск может перезаписать конфигурацию и сгенерировать новые учётные данные, из-за чего созданные подключения перестанут работать.
Часто задаваемые вопросы
Какая ОС лучше подходит для 3x-ui?
Наиболее предсказуемо панель работает на Ubuntu 20.04/22.04 и Debian 11/12 — именно на них чаще всего тестируется установочный скрипт. Другие дистрибутивы (CentOS, AlmaLinux) тоже поддерживаются, но при нестандартных проблемах проще найти решение для Ubuntu и Debian.
Сколько ресурсов потребляет 3x-ui?
Сама панель потребляет немного: для личного использования хватает минимального тарифа VPS с 1 vCPU и 512 МБ–1 ГБ оперативной памяти. Основная нагрузка создаётся трафиком прокси и количеством одновременных клиентов, а не интерфейсом управления.
Как обновить 3x-ui до новой версии?
Подключитесь к серверу по SSH, введите команду x-ui и выберите в меню пункт обновления. Панель скачает свежую версию и перезапустится, настройки и созданные подключения при этом сохраняются.
Можно ли установить 3x-ui без root-доступа?
Нет, установка требует прав root или sudo, поскольку скрипт создаёт системную службу, устанавливает пакеты и настраивает сетевые параметры. На shared-хостинге без полного доступа к системе панель установить не получится — нужен именно VPS/VDS.
Чем 3x-ui отличается от оригинальной x-ui?
3x-ui — это форк проекта x-ui с расширенной функциональностью: поддержкой протокола Reality, мультипользовательским режимом, ограничением трафика по клиентам и более частыми обновлениями. Для новых установок обычно рекомендуют именно 3x-ui как активно развивающийся вариант.