Руководство по установке и работе с nexcore-x-ui (Xray)
Пошаговое руководство по Astrenix/nexcore-x-ui: установка одной командой, Vue 3 + статический Go-бинарник, усиление systemd, REST API /api/v1 и CLI.
- Статический Go-бинарник с интерфейсом Vue 3 + Element Plus и Xray-core без жёсткой привязки к версии GLIBC хоста.
- Полноценный REST API /api/v1 для внешних контроллеров, скриптов и массового управления узлами.
- Строгую песочницу systemd (ProtectSystem=strict, NoNewPrivileges=true), права 0700 для каталогов, 0600 для БД и хранение API Token в виде хеша SHA256.
- VLESS с XTLS-Reality, TCP, WebSocket и gRPC для минимальных накладных расходов и стабильной работы.
Архитектура и ключевые особенности
Переработанная на базе vaxilu/x-ui под облачную автоматизацию и промышленную безопасность панель nexcore-x-ui включает:
- Статический Go-бинарник с интерфейсом Vue 3 + Element Plus и Xray-core без жёсткой привязки к версии GLIBC хоста.
- Полноценный REST API /api/v1 для внешних контроллеров, скриптов и массового управления узлами.
- Строгую песочницу systemd (ProtectSystem=strict, NoNewPrivileges=true), права 0700 для каталогов, 0600 для БД и хранение API Token в виде хеша SHA256.
- Независимые каталоги, службу systemd и CLI (nexcore-x-ui), исключающие конфликты с оригинальным x-ui.
Системные требования
- Операционная система — Современная 64-битная Linux с systemd (рекомендуются чистые Ubuntu 22.04 / 24.04 LTS или Debian 12).
- Права доступа — Требуются права root для регистрации службы systemd, настройки портов и защиты каталога данных.
- Сеть — Публичный IP с выходом на GitHub Releases для загрузки бинарников и открытые в фаерволе порты панели и протоколов.
- Рекомендуемые серверы — Отлично сочетается с нативными, двойными ISP, резидентными VPS и физическими серверами Tovanix.
Установка одной командой и автоматизация
Подключитесь к серверу по SSH от root и запустите официальный скрипт — он скачает статический бинарник, настроит службу и сгенерирует случайные учётные данные:
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
При массовом развёртывании через cloud-init или контроллер передайте переменные безопасного входа и webhook-уведомления перед запуском:
REPORT_URL=https://your-controller.example/callback \
REPORT_KEY=your_secret \
SECURE_ENTRY=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-x-ui/main/install.sh)
Начиная с версии v2.1.3, начальные учётные данные в открытом виде больше не записываются в install-info.txt — они выводятся только в баннер терминала и systemd journal.
Как восстановить первичные учётные данные
Если вы закрыли терминал после установки, получите стартовый баннер через встроенную CLI или напрямую из systemd journal:
nexcore-x-ui creds
journalctl -u nexcore-x-ui --no-pager --since "1 day ago"
После первого входа смените случайный пароль в панели или командой nexcore-x-ui passwd и ограничьте доступ к порту панели в фаерволе.
Справочник команд nexcore-x-ui CLI
После установки доступна глобальная команда nexcore-x-ui для управления службой, логами, паролями, обновлениями и удалением:
- nexcore-x-ui — Открывает интерактивное меню управления в терминале.
- nexcore-x-ui start | stop | restart | status — Запускает, останавливает, перезапускает или проверяет статус службы панели.
- nexcore-x-ui creds / info — Показывает порт панели, путь входа и первичные учётные данные.
- nexcore-x-ui reset — Принудительно перегенерирует случайный логин, пароль и порт панели.
- nexcore-x-ui passwd <user> <new_password> — Вручную устанавливает новый пароль для указанного администратора.
- nexcore-x-ui log / log-tail — Выводит последние 200 строк логов или транслирует журнал в реальном времени.
- nexcore-x-ui update — Плавно обновляет панель до последней версии с GitHub Releases и перезапускает службу.
- nexcore-x-ui uninstall — Полностью удаляет бинарники, службу systemd и каталог данных (сначала сделайте резервную копию).
Поддерживаемые протоколы и транспорты
На основе Xray-core панель управляет отдельными пользователями, лимитами трафика и сроками действия для:
- VLESS с XTLS-Reality, TCP, WebSocket и gRPC для минимальных накладных расходов и стабильной работы.
- VMess и Trojan для совместимости с существующими клиентами и доменами TLS.
- Shadowsocks и Shadowsocks-2022 для лёгких клиентов и быстрых транзитных каналов.
- SOCKS, HTTP и Dokodemo-door для проксирования приложений, проброса портов и цепочек.
После проверки подключения прогоните выходной IP через бесплатную проверку качества IP на нашем сайте.
Устранение проблем
- Страница входа панели не открывается в браузере — Случайный порт панели закрыт фаерволом или не указан безопасный путь входа. — Выполните nexcore-x-ui status и nexcore-x-ui info для проверки порта и пути, затем откройте TCP-порт в фаерволе.
- Утерян первичный случайный пароль — Версии v2.1.3 и новее не сохраняют открытый текстовый файл с паролем на диске. — Прочтите баннер командой nexcore-x-ui creds или задайте новый пароль через nexcore-x-ui passwd <user> <new_password>.
- Входной узел активен, но клиенты не подключаются — Закрыт порт протокола, не проходит рукопожатие Reality или сильно сбито системное время. — Проверьте правила TCP / UDP, синхронизацию NTP и посмотрите ошибки Xray через nexcore-x-ui log-tail.
- Обновление из веб-панели не применилось — Таймаут загрузки с GitHub Releases или зависший старый процесс. — Запустите nexcore-x-ui update по SSH, проверьте вывод и убедитесь в работе через nexcore-x-ui status.
Часто задаваемые вопросы
Может ли nexcore-x-ui работать рядом с vaxilu/x-ui на одном сервере?
Да. Бинарники, данные, служба systemd и CLI полностью разделены — достаточно не занимать одни и те же порты.
Удалит ли обновление существующих пользователей и узлы?
Нет. Обновление в панели и nexcore-x-ui update заменяют только бинарники, сохраняя базу SQLite и все настройки.
Как автоматизировать управление через /api/v1?
Создайте API Token в настройках панели (на сервере хранится лишь SHA256-хеш) и используйте стандартные REST-запросы.
Связанные страницы: Руководство по установке и настройке nexcore-s-ui (sing-box) · Выбор панели узлов: nexcore-x-ui, nexcore-s-ui и выделенный прокси · Решение для развёртывания выделенной сети · VPS с нативными и резидентными IP
Загрузка…