Руководство по установке и настройке 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 и выделенный прокси · Решение для развёртывания выделенной сети · Выделенный прокси
Загрузка…