4장. 가상호스트

이 장에서는 가상호스트와 URL표현에 대해 설명한다. 가상호스트는 서비스의 기본단위로 vhosts.xml을 통해 설정하며 개수제한은 없다.

가상호스트가 생성되면 멀티프로토콜이 사용하는 포트(HTTP/HLS=80, RTMP=1935)가 오픈된다. 가상호스트 설정에 따라 제공되는 멀티프로토콜 URL(Uniform Resource Locator)표현이 조금씩 차이난다. 가상호스트는 클라이언트가 요청하는 URL을 통해 어떤 프로토콜을 사용해야 하는지 알 수 있다.

프로토콜에 따라 지원되는 미디어 포맷은 아래와 같다.

프로토콜 확장자 Video Codec Audio Codec
RTMP .mp4 H.264 AAC
Apple HLS .mp4 H.264 AAC
HTTP Pseudo-Streaming .mp4 H.264 AAC

생성/파괴

<Vhosts> 하위에 <Vhost> 로 가상호스트를 설정한다.

# vhosts.xml

<Vhosts>
    <Vhost Name="www.example.com"> ... </Vhost>
    <Vhost Name="/foo" Status="Active"> ... </Vhost>
    <Vhost Name="www.example.com/bar" Status="Inactive"> ... </Vhost>
    <Vhost Name="/foobar" Prefix="http/"> ... </Vhost>
</Vhosts>

  • <Vhost> 가상호스트를 설정한다.

    • Name 가상호스트 이름. 중복될 수 없으며 3가지 형태로 구성이 가능하다.

      • 도메인 (www.example.com)
      • 1 depth 디렉토리 (/foo)
      • 도메인 (www.example.com) + 1depth 디렉토리(/bar)

    • Status (기본: Active) Inactive인 경우 해당 가상호스트는 임시적으로 서비스되지 않는다.

    • Prefix 기존주소와 호환성을 맞추기 위한 문자열 설정

가상호스트가 생성되면 멀티프로토콜(HTTP, HLS, RTMP) 서비스가 기본으로 활성화된다.

주석

1 depth 디렉토리 Name 표현은 Adobe 미디어 서버의 Application과 같은 개념이다. RTMP 클라이언트는 URL의 첫번째 디렉토리를 Application으로 인식한다.

rtmp://www.example.com/mp4:1.mp4

위 주소로 재생을 요청할 경우 RTMP 클라이언트는 아래와 같이 Connect 하여 재생이 실패하게 된다.

../_images/rtmp_invalid_connect.jpg

따라서 RTMP 서비스를 제공한다면 아래와 같이 1 depth 디렉토리 표현을 추가해야 한다.

rtmp://www.example.com/bar/mp4:1.mp4

<Vhost> 를 삭제하면 해당 가상호스트가 삭제된다. 삭제된 가상호스트의 모든 콘텐츠는 삭제된다. 다시 추가해도 콘텐츠는 되살아나지 않는다.

원본서버 주소

가상호스트는 원본서버에 저장된 미디어 콘텐츠를 멀티 프로토콜로 서비스하는 것이 목적이다. 서비스 형태에 맞게 다양하게 주소 표현이 가능하다.

<Vhosts>
    <Vhost Name="www.example.com">
        <Origin>
            <Address>1.1.1.1</Address>
            <Address>1.1.1.2</Address>
        </Origin>
    </Vhost>
</Vhosts>
  • <Address> 가상호스트가 콘텐츠를 복제 할 원본서버 주소. 개수제한은 없다. 주소가 2개 이상일 경우 Active/Active방식(Round-Robin)으로 선택된다. 원본서버 주소 포트가 80인 경우 생략할 수 있다.

예를 들어 다른 포트(8080)로 서비스되는 경우 1.1.1.1:8080과 같이 포트번호를 명시해야 한다. 주소는 {IP|Domain}{Port}{Path}형식으로 8가지 형식이 가능하다.

Address Host헤더
1.1.1.1 가상호스트명
1.1.1.1:8080 가상호스트명:8080
1.1.1.1/account/dir 가상호스트명
1.1.1.1:8080/account/dir 가상호스트명:8080
www.example.com www.example.com
www.example.com:8080 www.example.com:8080
www.example.com/account/dir www.example.com
www.example.com:8080/account/dir www.example.com:8080

HTTP 요청헤더 중 Host헤더를 별도로 설정하지 않는한 표의 Host헤더를 전송한다.

<Vhosts>
    <Vhost Name="www.example.com">
        <Origin>
            <Address>origin.com:8888/account/dir</Address>
        </Origin>
    </Vhost>
</Vhosts>

예를 들어 위와같이 설정하면 원본으로 다음과 같이 요청한다.

GET /trip.mp4 HTTP/1.1
Host: origin.com:8888

보조 주소

보조 원본서버를 설정한다.:

<Vhosts>
    <Vhost Name="www.example.com">
        <Origin>
            <Address>1.1.1.1</Address>
            <Address>1.1.1.2</Address>
            <Address2>1.1.1.3</Address2>
            <Address2>1.1.1.4</Address2>
        </Origin>
    </Vhost>
</Vhosts>

  • <Address2>

    모든 <Address> 가 정상동작하고 있다면 <Address2> 는 서비스에 투입되지 않는다. Active서버에 장애가 감지되면 해당 서버를 대체하기 위해 투입되며 Active서버가 복구되면 다시 Standby상태로 돌아간다. 만약 Standby서버에 장애가 감지되면 해당 Standby서버가 복구되기 전까지 서비스에 투입되지 않는다.

Alias

하나의 가상호스트를 여러 이름으로 서비스하고 싶다면 <Alias> 를 사용한다.

# vhosts.xml - <Vhosts>

<Vhost Name="www.example.com">
    <Alias>sample.com</Alias>
    <Alias>*.sub.example.com</Alias>
    <Alias>/myvideo</Alias>
</Vhost>

  • <Alias>

    가상호스트의 별명(Alias)을 설정하며 개수에 제한은 없다. 명확한 표현(sample.com)과 패턴표현(*.sub.example.com)을 지원한다. 패턴은 복잡한 정규표현식이 아닌 prefix에 * 표현을 하나만 붙일 수 있는 간단한 형식만을 지원한다.

가상호스트 검색 순서는 다음과 같다.

  1. <Vhost> 의 Name 과 일치하는가?
  2. 명시적인 <Alias> 와 일치하는가?
  3. 패턴 <Alias> 를 만족하는가?

Default 가상호스트

클라이언트 요청을 처리할 가상호스트를 찾지못한 경우 서비스를 제공할 기본 가상호스트를 지정한다. 클라이언트 요청을 처리하고 싶지 않다면 설정하지 않아도 된다.

# vhosts.xml

<Vhosts>
    <Vhost Name="www.example.com"> ... </Vhost>
    <Vhost Name="/foo"> ... </Vhost>
    <Vhost Name="www.example.com/bar"> ... </Vhost>
    <Default>/foo</Default>
</Vhosts>

  • <Default>

    기본 가상호스트 이름을 설정한다. 반드시 <Vhost> 의 Name 속성과 같아야 한다.

서비스 포트

프로토콜별로 서비스 포트를 설정한다. 기본 포트로 HTTP는 80, RTMP는 1935를 사용한다.

# vhosts.xml - <Vhosts>

<Vhost Name="www.example.com">
    <Listen>
      <Http>*:80</Http>
      <Rtmp>*:1935</Rtmp>
    </Listen>
</Vhost>

포트설정에 제한은 없지만, 이미 특정 프로토콜에 바인딩된 포트를 다른 프로토콜에서 열 수 없다.

# vhosts.xml - <Vhosts>

<Vhost Name="/foo">
    <Listen>
        <Http>*:80</Http>
        <Rtmp>*:1935</Rtmp>
    </Listen>
</Vhost>

<Vhost Name="www.example.com/bar">
    <Listen>
        <Http>*:8080</Http>   // 가능
        <Rtmp>*:80</Rtmp>     // 불가능 - 이미 HTTP에서 사용
    </Listen>
</Vhost>

목록조회

가상호스트 목록을 조회한다.

http://127.0.0.1:20040/monitoring/vhostslist

결과는 JSON형식으로 제공된다.

{
   "version": "1.0.0",
   "method": "vhostslist",
   "status": "OK",
   "result": [ "www.example.com","/foo", "www.example.com/bar" ]
}