Tovanix
Tovanix

nexcore-s-ui 설치 및 구성 튜토리얼 (sing-box 노드 패널)

Astrenix/nexcore-s-ui 완벽 가이드: sing-box 원클릭 설치, musl 정적 빌드, Cloudflare DNS-01 자동 SSL 인증서, /api/v1 API 및 CLI 운영.

  • 전면 개편된 Vue 3 + Element Plus UI로 sing-box의 인바운드, 아웃바운드, 라우팅 규칙, 다중 사용자를 통합 관리합니다.
  • musl 정적 컴파일로 amd64, arm64 등 다양한 Linux 아키텍처를 지원하며 호스트 GLIBC에 의존하지 않습니다.
  • 감사 로그가 포함된 /api/v1 REST API를 제공해 nexcore-x-ui 컨트롤러 워크플로와 호환됩니다.
  • Cloudflare API Token 연동을 내장해 포트 80 충돌 없이 DNS-01 방식으로 SSL 인증서를 자동 발급·갱신합니다.

아키텍처와 핵심 기능

alireza0/s-ui를 바탕으로 sing-box 운영과 API 자동화에 맞춰 재설계한 nexcore-s-ui의 특징은 다음과 같습니다.

  • 전면 개편된 Vue 3 + Element Plus UI로 sing-box의 인바운드, 아웃바운드, 라우팅 규칙, 다중 사용자를 통합 관리합니다.
  • musl 정적 컴파일로 amd64, arm64 등 다양한 Linux 아키텍처를 지원하며 호스트 GLIBC에 의존하지 않습니다.
  • 감사 로그가 포함된 /api/v1 REST API를 제공해 nexcore-x-ui 컨트롤러 워크플로와 호환됩니다.
  • Cloudflare API Token 연동을 내장해 포트 80 충돌 없이 DNS-01 방식으로 SSL 인증서를 자동 발급·갱신합니다.

시스템 및 아키텍처 요구 사항

  • 지원 OS — Ubuntu 24.04 LTS(종단간 검증 권장)와 Ubuntu 20.04+, Debian 11+, CentOS Stream 8+ 등 systemd 기반 Linux.
  • CPU 아키텍처 — amd64, arm64, 386, armv5, armv6, armv7, s390x 정적 바이너리를 지원합니다.
  • 실행 권한 — 80 / 443 저번 포트 바인딩, ACME 인증서 기록, 필요 시 tun 장치 생성을 위해 root 권한이 필요합니다.
  • 독립 공존 — 설치 경로, systemd 서비스, 랜덤 포트가 원본 s-ui와 분리되어 같은 서버에 함께 운영할 수 있습니다.

원클릭 설치, 버전 고정 및 강제 재설치

root로 SSH 접속해 공식 설치 스크립트를 실행합니다. 최초 설치 시 랜덤 사용자명, 비밀번호, 패널 포트가 자동 생성됩니다.

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 자동 SSL 인증서 설정

Hysteria2, Trojan, AnyTLS 등 TLS가 필요한 인바운드에는 Cloudflare DNS-01 자동 발급·갱신을 권장합니다.

  • Cloudflare 관리 도메인을 서버에 연결: Tovanix Cloud에서 등록한 도메인(또는 보유 도메인)의 A / AAAA 레코드를 노드 서버의 공용 IP로 지정하세요.
  • 최소 권한의 Cloudflare API Token 생성: Cloudflare에서 글로벌 키 대신 대상 영역에 Zone:DNS:Edit 권한만 부여한 API Token을 발급합니다.
  • 패널에 도메인과 Token 입력 후 발급: nexcore-s-ui 인증서 설정에서 DNS-01을 고르고 도메인과 API Token을 저장하면 자동 발급과 주기적 갱신이 시작됩니다.

DNS-01은 DNS TXT 레코드로 소유권을 확인하므로 서버의 80 포트가 사용 중이거나 닫혀 있어도 인증서를 발급·갱신할 수 있습니다.

nexcore-s-ui CLI 명령 요약

설치된 nexcore-s-ui 명령으로 서비스 제어, 로그 확인, 업그레이드, 제거를 수행할 수 있습니다.

  • nexcore-s-ui — 대화형 CLI 관리 메뉴를 엽니다.
  • 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 인증서 발급 실패 — API Token에 해당 영역의 Zone:DNS:Edit 권한이 없거나 DNS 전파가 아직 완료되지 않았습니다. — Token 권한 범위를 확인한 뒤 nexcore-s-ui log로 정확한 ACME 오류 메시지를 점검하세요.
  • Hysteria2 등 UDP 기반 프로토콜 연결 실패 — 방화벽에 TCP만 열려 있고 UDP가 막혀 있거나 TLS 인증서 도메인·ALPN이 맞지 않습니다. — 해당 포트의 UDP 트래픽을 허용하고 클라이언트 SNI와 인증서 도메인이 일치하는지 확인하세요.
  • 데이터를 잃지 않고 바이너리만 복구하고 싶음 — uninstall을 실행하면 바이너리와 데이터베이스가 함께 삭제됩니다. — uninstall 대신 install.sh --force를 실행하면 기존 데이터베이스를 보존한 채 바이너리만 덮어씁니다.

자주 묻는 질문

nexcore-s-ui는 호스트 GLIBC 버전에 영향을 받나요?

아니요. musl 정적 바이너리로 빌드되어 다양한 Linux 배포판과 아키텍처에서 동작하며 Ubuntu 24.04 LTS를 권장합니다.

원본 alireza0/s-ui와 한 서버에 같이 쓸 수 있나요?

네. 경로, systemd 서비스명, 포트가 분리되어 있어 수신 포트만 겹치지 않으면 함께 실행할 수 있습니다.

HTTP-01 대신 Cloudflare DNS-01을 권장하는 이유는 무엇인가요?

포트 80이 필요 없고 와일드카드 인증서를 지원하며 기존 웹 서버와 충돌하지 않아 자동 갱신이 안정적입니다.

관련 페이지: nexcore-x-ui 설치 및 운영 튜토리얼 (Xray 노드 패널) · 자체 노드 패널 선택 가이드: nexcore-x-ui, nexcore-s-ui, 전용 프록시 · 전용 네트워크 구축 솔루션 · 전용 프록시

불러오는 중…