Tovanix
Tovanix

Руководство по установке и настройке nexcore-s-ui (sing-box)

Полное руководство по Astrenix/nexcore-s-ui: установка sing-box одной командой, сборки musl, автосертификаты Cloudflare DNS-01, API /api/v1 и CLI.

  • Переписанный интерфейс Vue 3 + Element Plus для управления входящими, исходящими правилами, маршрутами и пользователями sing-box.
  • Статические сборки musl под amd64, arm64 и другие архитектуры Linux без зависимости от GLIBC хоста.
  • Полноценный REST API /api/v1 с журналом аудита, совместимый с контроллерами nexcore-x-ui.
  • Встроенную поддержку Cloudflare API Token для автоматического выпуска и продления SSL-сертификатов по DNS-01 без порта 80.

Архитектура и ключевые особенности

Переработанная на основе alireza0/s-ui под sing-box и API-автоматизацию панель nexcore-s-ui предлагает:

  • Переписанный интерфейс Vue 3 + Element Plus для управления входящими, исходящими правилами, маршрутами и пользователями sing-box.
  • Статические сборки musl под amd64, arm64 и другие архитектуры Linux без зависимости от GLIBC хоста.
  • Полноценный REST API /api/v1 с журналом аудита, совместимый с контроллерами nexcore-x-ui.
  • Встроенную поддержку Cloudflare API Token для автоматического выпуска и продления SSL-сертификатов по DNS-01 без порта 80.

Требования к системе и архитектуре

  • Поддерживаемые ОС — Ubuntu 24.04 LTS (полностью проверена); также совместимы Ubuntu 20.04+, Debian 11+ и CentOS Stream 8+ с systemd.
  • Архитектуры CPU — Статические бинарники для amd64, arm64, 386, armv5, armv6, armv7 и s390x.
  • Права доступа — Нужны права root для привязки портов 80 / 443, записи сертификатов ACME и создания tun-интерфейсов.
  • Совместимость на узле — Изолированные пути, служба systemd и случайный порт позволяют сосуществовать с оригинальным s-ui.

Установка одной командой, фиксация версии и переустановка

Войдите по SSH как root и запустите официальный скрипт. При первой установке генерируются случайные логин, пароль и порт панели:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh)

Чтобы зафиксировать конкретный тег релиза или перезаписать бинарники без потери базы данных, укажите тег или флаг --force:

bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) --force
# bash <(curl -fsSL https://raw.githubusercontent.com/Astrenix/nexcore-s-ui/main/install.sh) v1.0.0

Случайные начальные учётные данные и URI панели печатаются в терминал только один раз — сразу сохраните их до закрытия сессии.

Настройка автосертификатов Cloudflare DNS-01

Для Hysteria2, Trojan, AnyTLS и других TLS-подключений настройте Cloudflare DNS-01 для автоматического выпуска и продления:

  • Направьте домен в Cloudflare на ваш сервер: Зарегистрируйте домен в Tovanix Cloud (или используйте свой) и добавьте A / AAAA запись на публичный IP сервера.
  • Создайте Cloudflare API Token с минимальными правами: В Cloudflare создайте токен только для нужной зоны с единственным правом Zone:DNS:Edit вместо глобального ключа.
  • Укажите домен и Token в панели: В разделе сертификатов nexcore-s-ui выберите режим DNS-01, введите домен и API Token и сохраните для автоматического выпуска и продления.

Проверка DNS-01 работает через DNS TXT-записи, поэтому сертификаты выпускаются даже при занятом или закрытом порте 80.

Справочник команд nexcore-s-ui CLI

Команда nexcore-s-ui упрощает управление службой, чтение логов, обновление и удаление:

  • nexcore-s-ui — Открывает интерактивное меню управления панелью.
  • nexcore-s-ui start | stop | restart | status — Запускает, останавливает, перезапускает или проверяет статус службы nexcore-s-ui.
  • nexcore-s-ui log — Показывает последние журналы панели и ядра для диагностики узлов и ACME.
  • nexcore-s-ui update — Обновляет до актуального релиза на GitHub Releases с сохранением базы данных.
  • nexcore-s-ui uninstall — Полностью удаляет бинарники, службу systemd и локальные данные (сделайте бэкап заранее).

Устранение проблем

  • Адрес панели не отвечает после установки — Случайный порт не открыт в фаерволе или пропущен сгенерированный URI-путь. — Сверьте порт и URI из вывода установки, разрешите порт в фаерволе и проверьте nexcore-s-ui status.
  • Ошибка выпуска сертификата Cloudflare DNS-01 — У токена нет права Zone:DNS:Edit для этой зоны либо DNS-запись ещё не обновилась. — Проверьте область действия токена и просмотрите точную ошибку ACME через nexcore-s-ui log.
  • Hysteria2 или UDP-протоколы не подключаются — В фаерволе открыт только TCP при закрытом UDP, либо не совпадают домен и ALPN сертификата. — Разрешите UDP на входящем порту и убедитесь, что SNI клиента совпадает с доменом сертификата.
  • Нужно переустановить бинарники без потери настроек — Команда uninstall удаляет и бинарники, и базу данных. — Не запускайте uninstall — выполните install.sh --force, чтобы обновить бинарники и сохранить базу данных.

Часто задаваемые вопросы

Зависит ли nexcore-s-ui от версии GLIBC на сервере?

Нет. Сборки скомпилированы статически с musl под разные архитектуры Linux; рекомендуется Ubuntu 24.04 LTS.

Может ли nexcore-s-ui работать вместе с alireza0/s-ui?

Да. Каталоги, служба systemd и порты изолированы и позволяют совместную работу при непересекающихся портах.

Почему Cloudflare DNS-01 лучше HTTP-01?

DNS-01 не требует порта 80, поддерживает wildcard-сертификаты и не конфликтует с работающими веб-серверами.

Связанные страницы: Руководство по установке и работе с nexcore-x-ui (Xray) · Выбор панели узлов: nexcore-x-ui, nexcore-s-ui и выделенный прокси · Решение для развёртывания выделенной сети · Выделенный прокси

Загрузка…