홈
XtreamUIPro

튜토리얼

스트리밍 노드 등록

가까운 시청자에게 전송하는 엣지 서버를 추가합니다. 패널에서 SSH로, 또는 노드에서 일회용 코드로 등록한 다음 시청자가 연결되는지 확인합니다.

마지막에는 두 번째 서버가 실시간 채널을 오리진에서 한 번만 받고, 주문형 파일을 캐시하며, 연결된 시청자에게 전송합니다. API에 https 주소를 설정해 설치한 패널, 노드용 Ubuntu 장비, 그리고 그 장비에 대한 SSH 접근 또는 셸이 필요합니다.

패널에 서버 추가

Servers를 열고 노드용 서버를 추가합니다. 이름, IP, IP와 다를 경우 시청자가 접속할 Server URL을 입력합니다. SSH 방식에서는 SSH 탭에 root 또는 비밀번호 없는 sudo가 가능한 계정을 입력합니다. 비밀번호나 키는 암호화되어 저장되며 워커가 저장 직후 접근을 확인합니다.

Servers 페이지: 메인 서버와 노드의 주소, 상태, 작업.
Servers 페이지: 메인 서버와 노드의 주소, 상태, 작업.

방법 A: 패널에서 SSH로 설치

Servers → Install Load Balancer: 서버를 고르고 Check SSH(운영체제, CPU 아키텍처, sudo, 디스크, 시계, 8080 포트, API 접근 가능 여부)를 실행한 다음 Install을 실행합니다. 워커가 패키지 폴더의 노드 패키지를 업로드해 설치하며, 첫 연결에서 장비의 호스트 키를 고정합니다. 각 단계는 실행되는 대로 페이지에 표시되고 Servers → Jobs에는 비밀 정보가 걸러진 로그가 남습니다. 같은 페이지에서 나중에 Upgrade, Restart services, Enroll again, Uninstall도 할 수 있습니다.

방법 B: 일회용 코드로 등록

Cluster Nodes → Create enrol code가 30분간 유효한 코드를 발급합니다. 노드에서 설치 프로그램을 노드 모드로 실행합니다: sudo ./install.sh --role node --main-url https://media.example.com --api-url https://api.example.com --public-url https://edge1.example.com --enroll-code XCE-… 노드는 등록할 때 자체 비밀 값과 키를 받으며, 패널의 마스터 비밀 값은 받지 않습니다. 사설 네트워크에서 --allow-insecure를 전달하지 않는 한 API 주소는 https여야 합니다.

하트비트 확인

Cluster Nodes에서는 첫 하트비트 후 노드가 부하, 시청자, 캐시와 함께 ok로 표시됩니다. 노드에서는 journalctl -u xtream-cluster-agent -f가 "config applied"를 보여줍니다. 대시보드에서 취소된 노드는 스스로 멈추며, 다시 참여시키려면 새 코드를 만들어 다시 등록하세요.

Cluster Nodes 페이지: 등록된 노드와 하트비트, 부하, 시청자.
Cluster Nodes 페이지: 등록된 노드와 하트비트, 부하, 시청자.

시청자가 연결되는지 확인

시청자는 GeoIP(워커가 내려받는 국가 파일 사용) 또는 설정한 배정에 따라 노드로 연결됩니다. 노드는 실시간 채널을 오리진에서 한 번만 받아 분배하고, VOD 캐시는 필요할 때 오리진에서 채웁니다. Monitoring에는 노드별 시청자가 표시되며, 드레인 중인 노드는 새 시청자를 받지 않습니다.

Monitoring 페이지: 채널별, 노드별 시청자.
Monitoring 페이지: 채널별, 노드별 시청자.

관련 도움말

다음 튜토리얼