CSS CDN 연결과 재생 주소
On this page
CSS CDN이 StreamPackage 엔드포인트를 원본으로 사용하도록 연결합니다. 도메인 문자열만 바꾸는 작업이 아니라 서비스 간 권한, 도메인 설정, DNS, 인증과 실제 재생을 확인하는 과정입니다.
사전 준비
- StreamPackage 채널과 엔드포인트를 준비합니다.
- CSS 활성화와 재생 도메인 사용 권한을 확인합니다.
- 도메인 소유권 / DNS 설정 권한 및 HTTPS 인증서를 준비합니다.
- 원본 엔드포인트의 접근 정책을 확인합니다.
콘솔 연결 순서
- StreamPackage 채널 상세의 CDN 탭에서 Authorization 절차를 확인합니다.
- StreamPackage가 CSS를 구성할 수 있도록 서비스 역할 권한을 승인합니다.
- CSS가 StreamPackage 원본에 접근할 수 있도록 반대 방향의 권한도 확인합니다.
- 재생 도메인을 연결합니다. 현재 화면에서 CSS 콘솔 설정으로 안내하면 해당 경로로 이동합니다.
- 안내된 CNAME을 DNS에 등록합니다.
- HTTPS 인증서와 원본 요청 설정을 확인합니다.

콘솔 Enabled 상태와 함께 인증서 유효성 / 실제 영상 재생을 확인합니다.
재생 URL 구성
도메인 연결 후 엔드포인트 URL의 호스트를 재생 도메인으로 바꾸고 경로를 유지합니다.
| 구분 | 형식 예시 |
|---|---|
| 원본 | https://PACKAGE_HOST/v1/CHANNEL/ENDPOINT/index.m3u8 |
| CDN | https://PLAYBACK_HOST/v1/CHANNEL/ENDPOINT/index.m3u8 |
경로와 파일명은 실제 엔드포인트 값을 사용합니다. 원본 접근 인증과 시청자 접근 인증은 서로 다른 구간의 정책입니다.
API 연결 예시
API 연결에는 대상 채널 ID와 도메인을 사용하고, 연결 후 실제 재생을 확인합니다.
LANGUAGE
tccli mdp BindNewLVBDomainWithChannel --region ap-seoul \
--ChannelId YOUR_CHANNEL_ID \
--LVBDomain YOUR_PLAYBACK_DOMAIN원본과 CDN 비교
LANGUAGE
STREAM_ORIGIN_URL='https://PACKAGE_HOST/YOUR_ENDPOINT/index.m3u8'
STREAM_CDN_URL='https://PLAYBACK_HOST/YOUR_ENDPOINT/index.m3u8'
curl --silent --show-error --fail-with-body --max-time 20 "$STREAM_ORIGIN_URL"
curl --silent --show-error --fail-with-body --max-time 20 "$STREAM_CDN_URL"필요한 인증을 각각 적용합니다. 마스터가 열리면 목록 안에 실제로 적힌 미디어 URL을 사용하고, 세그먼트 요청까지 확인합니다.
| 현상 | 먼저 확인할 항목 |
|---|---|
| 원본부터 결과 확인 | 입력 송출, 출력 목적지, 엔드포인트 경로와 원본 인증 |
원본 정상 / CDN 403 |
양방향 서비스 권한, 원본 요청 Host / 경로 / 인증, 시청자 접근 정책 |
| TLS | 인증서 유효 기간, 호스트 이름, 인증서 체인 |
| 마스터 정상 / 하위 목록 결과 확인 | 상대 URI 해석, 요청 경로와 쿼리/헤더 전달 |
| 목록 갱신 중단 | 원본 송출 상태, CDN 목록 캐시 정책 |
| 응답 시간 | DNS / 네트워크 / 원본 지연과 구간별 응답 |
403 또는 접근 응답은 해당 도메인의 인증 / 오리진 경로 / 권한을 확인합니다. 설정 전파 후 같은 경로로 다시 검증합니다.
종료 및 연결 해제
다른 시청자가 사용 중인지 확인한 뒤 테스트 연결만 해제합니다.
LANGUAGE
tccli mdp UnbindCdnDomainWithChannel --region ap-seoul \
--ChannelId YOUR_CHANNEL_ID \
--LVBDomain YOUR_PLAYBACK_DOMAIN연결 해제는 기존 재생에 영향을 줄 수 있습니다. 불필요한 채널 / 전송과 CDN 사용량은 별도로 확인합니다.
