UX 에디션 — 웹 대시보드
UX (User eXperience) 에디션은 SX 에디션과 동일한 라이트 노드 데몬을 실행하지만, 내장 웹 대시보드를 추가하여 브라우저에서 노드와 네트워크를 지켜볼 수 있습니다. 바이너리는 lightnode-ux입니다. SX 에디션과 마찬가지로, 이는 라이트 노드의 v3.1.2 계열입니다(체인 버전과는 별개인 자체 버전).
UX 에디션은 데스크톱 사용과, 명령줄보다 시각적 인터페이스를 선호하는 운영자에게 적합한 선택입니다.
설치
사전 빌드된 바이너리는 네이티브 의존성 없이 여섯 개 플랫폼에서 네이티브로 실행됩니다 — Linux(amd64, arm64), macOS(Intel, Apple Silicon), Windows(amd64, arm64) — 각각 약 16MB입니다. 실행하기 전에 다운로드한 파일의 체크섬을 매니페스트와 대조하여 검증하세요 — 방법은 SX 에디션을 참고하세요.
소스에서 빌드
UX 에디션은 Go 1.26.1이 필요합니다. 포스트 양자 암호화는 순수 Go 구현입니다(CGO 없음, 네이티브 라이브러리 없음):
go build -o build/lightnode-ux ./cmd/lightnode-ux/
이는 build/lightnode-ux를 생성합니다.
Docker
UX 서비스는 Dockerfile.ux에서 빌드됩니다:
docker compose up lightnode-ux
UX 컨테이너는 /root/.qorechain-lightnode의 명명된 볼륨에 데이터를 영속화하며, QORECHAIN_RPC_ADDR 환경 변수에서 체인 RPC 주소를 읽습니다.
실행
UX 노드를 시작하세요:
build/lightnode-ux start
이는 데몬과 내장 대시보드 서버를 함께 실행합니다. UX 에디션은 항상 대시보드를 활성화합니다. 시작 시 바이너리는 대시보드 URL을 출력합니다.
UX 에디션은 SX 에디션과 설정을 공유합니다: ~/.qorechain-lightnode에서 동일한 config.toml을 읽고 동일한 Dilithium-5 키링을 사용합니다. 아직 노드를 구성하지 않았다면, 먼저 SX 마법사(lightnode-sx onboard)를 실행하여 설정을 작성하고 키를 가져오거나 생성하세요 — SX 에디션을 참고하세요.
포트 8420의 웹 대시보드
대시보드는 포트 8420에 노출됩니다. 이는 lightnode-ux Docker 이미지가 선언하는 포트(EXPOSE 8420)이자 바이너리가 기본으로 바인딩하는 값이므로, Docker에서 실행할 때 대시보드는 8420에 게시됩니다:
http://localhost:8420
다른 곳의 일부 설명에서는 대시보드에 대해 포트 8080을 참조합니다. 권위 있는 값은 8420입니다 — 이것이 이미지가 실제로 노출하는 값이자 데몬이 기본으로 바인딩하는 값입니다. 자체 docker-compose.yml이나 리버스 프록시를 조정하는 경우, 8080이 아니라 8420으로 매핑하세요.
포트 8420 뒤에는 로그인이나 접근 제어가 전혀 없습니다 — 여기에 접근할 수 있는 사람은 누구나 회원님의 설정, 위임, 보상을 읽을 수 있습니다. 개인 키가 제공되는 일은 결코 없습니다. 바이너리는 이제 모든 인터페이스가 아니라 기본적으로 루프백에만(127.0.0.1:8420) 바인딩되며, 더 넓게 수신 대기하도록 구성한 경우 시작 시 경고를 출력합니다 — 하지만 이 경고는 거부가 아니며 인증을 추가하지도 않습니다. 바인딩을 의도적으로 넓히는 경우(예: 다른 머신에서 접근하기 위해, 또는 Docker에서 포트를 게시하기 때문에), 직접 노출하는 대신 인증을 요구하는 리버스 프록시 뒤에 두세요. 넓은 네트워크 바인딩만으로는 같은 브라우저에서 열려 있는 다른 페이지가 연결하는 것을 막지 못하므로, WebSocket 텔레메트리 연결도 브라우저의 Origin을 확인합니다.
대시보드가 보여주는 것
대시보드는 다음 뷰로 구성됩니다:
- Overview — 블록 높이와 한눈에 보는 노드 상태.
- Validators — 본딩된 검증자 집합.
- Delegation — 현재 위임과 그 분할.
- Network — 실시간 네트워크 텔레메트리와 최근 동기화된 헤더.
- Bridge — 크로스체인 브리지 텔레메트리.
- Tokenomics — 토큰 이코노믹스 텔레메트리.
- Settings — 노드의 유효 구성.
텔레메트리는 실시간으로 업데이트되며, 데몬이 검증자, 네트워크, 브리지, 토크노믹스 데이터를 독립적인 간격으로 새로 고칩니다(config.toml의 [telemetry] 아래에서 구성 가능).
로컬 전용 배너
노드에 체인 RPC 엔드포인트가 구성되어 있지 않으면, 대시보드는 로컬 전용 모드로 실행되며 그 상태를 설명하는 눈에 띄는 배너를 표시합니다: PQC 스택은 검증되었지만, 노드는 어떤 체인도 동기화하지 않으므로 블록 높이는 0에 머뭅니다. 배너는 호스트에서 온보딩 마법사를 실행하라고 안내합니다:
lightnode-sx onboard
마법사는 PQC 셀프 테스트를 실행하고, 체인 엔드포인트를 요청하며, 검증자 키를 가져오거나 생성합니다. 엔드포인트가 구성되면 노드를 재시작하면 대시보드가 실시간 체인 데이터를 표시하기 시작합니다.