StreamLinkLast Updated 2026-09-30

StreamLink Overview

On this page

StreamLink는 현장 인코더 / 스튜디오 / 클라우드 처리 시스템 사이에서 라이브 신호를 전송합니다. 이 문서에서는 콘솔의 메뉴를 먼저 살펴보고 Event → Flow → Input → Output 순서로 전송 경로를 구성합니다. 해상도별 트랜스코딩은 StreamLive에서 수행하며, 시청자용 HLS 배포는 StreamPackage와 CDN에서 구성합니다.

콘솔 메뉴 지도

메뉴 / 화면	역할	여기서 수행할 작업
Flow의 Event 목록	행사 / 서비스별 전송 경로 묶음	Create event, Event 선택, Flow management 진입
Flow management	Event에 속한 개별 전송 경로 관리	Flow 생성, Input / Output 연결, 개별 시작 / 정지
Security Group	입력 / 출력의 접근 허용 IP 관리	송출자 또는 수신자의 공인 IP 범위 등록
Usage statistics	사용량 조회	조회 기간과 대상에 따른 전송 사용량 확인
Gateway	Gateway 구성 관리	Gateway를 사용하는 전송 설계에서 설정

Event는 관리 묶음, Flow는 전송 경로입니다. Input과 Output을 생성하면 송출 / 수신 연결 지점을 확인할 수 있습니다.

1. Event 생성과 선택

StreamLink 콘솔에서 Create event를 선택합니다. 이름에는 행사나 서비스 식별값을, 설명에는 용도를 입력합니다. 예를 들어 demo_event와 Encoder to processing service를 사용할 수 있습니다.

Event 생성 화면

저장한 Event의 Flow management를 선택합니다. Start all은 Event 안의 여러 Flow에 영향을 주므로 처음에는 개별 Flow의 시작 버튼을 사용합니다.

Event에서 Flow 관리 화면으로 이동

캡처의 이름 / 리전 / 입력값은 화면 설명용 예시입니다. 사용하는 전송 경로에 맞춰 지정합니다.

2. Flow 생성

Flow management에서 Create를 선택하고 전송 경로를 생성합니다.

Flow 이름 / 대역폭 / 리전 설정

입력란	설정 방법	주의 사항
Flow name	`demo_flow` 등 경로 식별 이름	주 / 예비 경로는 이름으로 구분
Max bandwidth	원본 비트레이트와 전송 여유를 수용할 값	영상뿐 아니라 오디오 / 오버헤드와 변동량도 고려
Region	해당 입력 경로를 구성할 리전	송출 장비의 위치와 네트워크 경로를 고려

API의 MaxBandwidth는 bps 단위입니다. 생성 후 상태와 Flow 이름을 확인하고 Input을 추가합니다.

3. 지원 입력 프로토콜과 선택 기준

아래 표는 공식 콘솔 가이드의 입력 유형을 기준으로 합니다. 계정 / 서비스 업데이트에 따라 추가 유형이 표시될 수 있으므로 실제 콘솔과 API 버전의 지원 범위를 함께 확인합니다.

입력 프로토콜	원본이 들어오는 방식	주로 사용하는 상황
SRT Listener	송출 장비가 Caller로 StreamLink에 연결	외부 인코더의 SRT Push 수신
SRT Caller	StreamLink가 원본 Listener에 연결	수신 대기 중인 SRT 원본에서 가져오기
RTMP_PUSH	인코더가 생성된 입력 주소로 전송	RTMP 송출 프로그램 / 장비 연결
RTMP_PULL	StreamLink가 원본 RTMP 주소에 연결	외부 RTMP 원본에서 가져오기
RTP	송출 측이 생성된 입력 주소로 전송	RTP 기반 장비 연결
RTSP_PULL	StreamLink가 원본 RTSP 주소에 연결	RTSP 원본 연동
RIST Listener	원본 Caller의 연결을 수신	RIST를 지원하는 송출 장비 연결

SRT의 Caller/Listener는 연결을 시작하는 역할입니다. 입력 / 출력은 데이터 방향, Caller / Listener는 연결 수립 역할로 구분합니다.

4. Input 추가

Flow를 선택하고 Add input을 엽니다. 이름, 프로토콜, 입력 리전 / 가용 영역을 선택한 뒤 해당 프로토콜의 필드를 설정합니다.

Flow에서 Input 추가 위치

선택한 방식	준비할 값
Push 또는 Listener	실제 송출 공인 IP, 허용 정책, 필요한 암호화 설정
Pull 또는 Caller	원본 주소 / 포트, 필요한 Stream Key 또는 Stream ID, 원본 인증 정보
SRT	연결 역할, 지연 버퍼, 암호화 키와 키 길이
Failover 지원 입력	생성된 두 주소에 보낼 주 / 예비 송출과 전환 검증 계획

IP 허용 목록은 접근 제한이고 암호화는 전송 내용 보호입니다. 입력을 저장한 뒤 Addresses에서 송출에 필요한 주소를 확인합니다.

5. 출력 프로토콜과 연결 방향

입력과 출력의 지원 조합을 먼저 확인합니다.

입력 유형	공식 콘솔 가이드의 출력 유형
RTMP_PUSH / RTMP_PULL	RTMP_PUSH, RTMP_PULL, SRT
SRT	SRT, RTMP_PUSH, RTMP_PULL
RTP	RTP
RTSP_PULL	RTSP_PULL
RIST	RIST

출력 방식	연결을 시작하는 쪽	설정할 목적지
RTMP_PUSH	StreamLink	수신 플랫폼의 URL과 Stream Key
RTMP_PULL	수신 시스템	StreamLink가 생성한 주소를 수신 시스템에 입력
SRT Caller	StreamLink	상대 Listener의 주소 / 포트 / Stream ID
SRT Listener	수신 시스템의 Caller	StreamLink가 생성한 출력 주소

StreamLive의 RTMP_PUSH 입력에 연결할 때는 StreamLink의 RTMP_PUSH 출력을 사용합니다. 송출용 StreamLink Input 주소와 목적지 StreamLive Input 주소는 서로 다른 주소입니다.

6. Output 추가와 동시 연결 수

Add output에서 출력 유형, 이름, 리전 / 가용 영역, 프로토콜과 목적지를 지정합니다.

SRT 출력 설정 화면

출력 유형	용도와 한도
Pinpoint	출력당 `1개` Push 또는 최대 `4개` Pull. 프로토콜별 연결 수 적용
MultiMesh	다수 수신자가 Pull하는 SRT Listener 출력. 공식 문서는 Pull 수 제한이 없다고 설명하지만 접근 제어와 사용량 관리 필요

Pinpoint RIST Listener는 공식 문서상 동시 Pull 1개를 지원합니다. 출력 노드와 연결 수가 늘면 비용도 달라집니다.

7. 시작 / 로그 / 상태 확인

Flow의 Start를 선택한 뒤 원본 송출과 목적지 수신을 시작합니다. 목적지 서버 또는 수신기가 준비되어 있어야 합니다.

화면	확인할 내용
Addresses	입력 / 출력 주소, 노드 IP, 포트, 프로토콜
Log	연결 / 종료 / 재연결과 응답 기록
Health	입력 / 출력 비트레이트, 프로토콜별 손실 / 재전송 지표
수신 시스템	실제 영상 / 오디오, 끊김과 지연

입력 신호, 출력 전송, 수신 시스템의 재생을 각각 확인합니다.

기능별 상세 절차

종료와 공식 문서

테스트 종료 후 해당 Flow와 전용 리소스를 정리합니다. Event 단위 작업은 포함된 Flow 목록을 확인한 뒤 진행합니다.