Apache HTTP Server Version 2.4

Apache > HTTP Server > Documentation > Version 2.4 > 가상호스트

# 대량의 가상호스트를 동적으로 설정하기

가능한 언어: en | fr | ko | tr

이 문서는 최신판 번역이 아닙니다. 최근에 변경된 내용은 영어 문서를 참고하세요.

이 문서는 아파치 1.3에서 대량의 가상호스트를 효율적으로 서비스하는 방법을 설명한다.

## 동기 ¶

당신의 `httpd.conf`에 다음과 같이 서로 비슷한 `<VirtualHost>` 섹션들을 많이 있다면 여기서 설명하는 방법이 도움이 될 것이다:

`NameVirtualHost 111.22.33.44
<VirtualHost 111.22.33.44>
ServerName www.customer-1.com
DocumentRoot /www/hosts/www.customer-1.com/docs
ScriptAlias /cgi-bin/ /www/hosts/www.customer-1.com/cgi-bin
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName www.customer-2.com
DocumentRoot /www/hosts/www.customer-2.com/docs
ScriptAlias /cgi-bin/ /www/hosts/www.customer-2.com/cgi-bin
</VirtualHost>
# 바보 바보 바보
<VirtualHost 111.22.33.44>
ServerName www.customer-N.com
DocumentRoot /www/hosts/www.customer-N.com/docs
ScriptAlias /cgi-bin/ /www/hosts/www.customer-N.com/cgi-bin
</VirtualHost>`

기본 개념은 정적인 `<VirtualHost>` 설정 모두를 동적으로 처리하도록 대체하는 것이다. 그러면 많은 장점이 있다:

1. 설정파일이 작아져서 아파치가 빨리 시작하고 메모리를 적게 사용한다.
2. 가상호스트를 추가하기위해 파일시스템에 적당한 디렉토리를 만들고 DNS에 항목을 추가하기만 하면된다. 즉, 아파치를 재설정하고 재시작할 필요가 없다.

단점은 각 가상호스트별로 다른 로그파일을 사용할 수 없다는 점이다. 그러나 매우 많은 가상호스트를 사용한다면 파일기술자를 다 써버리기때문에 서로 다른 로그파일을 사용할 수 없다. 파이프나 fifo로 로그를 보내고, 받는 편에서 로그를 처리하여 나누는 방법이 (통계 등을 모을 수도 있다) 더 낫다.

## 개요 ¶

가상호스트는 IP 주소와 HTTP 요청의 `Host:` 헤더 정보로 정의한다. 기본적으로 대량의 동적 가상호스트 기술은 자동으로 가상호스트 정보를 요청의 파일경로에 포함한다. 이는 대부분 `mod_vhost_alias`를 사용하여 쉽게 해결할 수 있지만, 아파치 1.3.6 이하를 사용한다면 `mod_rewrite`를 사용해야 한다. 이 두 모듈 모두 기본적으로 서버에 포함되지 않는다. 이 방법을 사용하려면 아파치를 구성하고 컴파일할때 포함해야 한다.

동적 가상호스트를 일반적인 가상호스트처럼 보이게하려면 여러가지를 `속여야' 한다. 가장 중요한 것은 아파치가 자기참조 URL 등을 만들때 사용할 서버명이다. 서버명은 `ServerName` 지시어로 설정하며, CGI에는 `SERVER_NAME` 환경변수로 주어진다. 실행중 실제 서버명은 `UseCanonicalName` 설정에 달렸다. `UseCanonicalName Off`이면 요청의 `Host:` 헤더 내용이 서버명이 된다. `UseCanonicalName DNS`이면 가상호스트의 IP 주소를 역DNS 검색하여 서버명을 알아낸다. 전자는 이름기반 동적 가상호스트에서 사용하고, 후자는 IP기반 가상호스트에서 사용한다. `Host:` 헤더가 없거나 DNS 검색이 실패하여 아파치가 서버명을 알아내지 못하면 `ServerName`으로 설정한 값을 대신 사용한다.

다른 `속일' 것은 (`DocumentRoot`로 설정하며, CGI에는 `DOCUMENT_ROOT` 환경변수로 주어지는) 문서루트이다. 일반적인 경우 core 모듈이 이 설정을 사용하여 URI에 해당하는 파일명을 찾지만, 서버를 동적 가상호스팅을 할때는 다른 모듈이 (`mod_vhost_alias`나 `mod_rewrite`) 다른 방법으로 이런 작업을 한다. 두 모듈 모두 `DOCUMENT_ROOT` 환경변수를 사용하지 않으므로 CGI나 SSI 문서가 이 값을 사용한다면 잘못된 결과를 얻을 수 있다.

## 간단한 동적 가상호스트 ¶

위 동기 절의 가상호스트 설정을 `mod_vhost_alias`를 사용하여 더 일반적으로 구현했다.

`# Host: 헤더에서 서버명을 알아낸다
UseCanonicalName Off
# 첫번째 필드를 사용하여 이 로그를 가상호스트별로 나눌 수 있다
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog logs/access_log vcommon
# 요청을 처리하기위해 파일명에 서버명을 포함한다
VirtualDocumentRoot /www/hosts/%0/docs
VirtualScriptAlias /www/hosts/%0/cgi-bin`

이 설정에서 `UseCanonicalName Off`를 `UseCanonicalName DNS`로 변경하기만 하면 IP기반 가상호스트가 된다. 가상호스트의 IP 주소를 가지고 파일명에 추가할 서버명을 알 수 있다.

## 가상으로 호스트하는 홈페이지 시스템 ¶

ISP 홈페이지 서버를 위해 위의 설정을 수정했다. 조금 더 복잡한 설정을 사용하면 `www.user.isp.com`의 문서를 `/home/user/`에 두는 식으로 서버명의 일부를 가지고 파일명을 만들 수 있다. 이 설정은 `cgi-bin`을 각 가상호스트가 따로 가지지않고 모든 가상호스트가 같이 사용한다.

`# 기본적인 내용은 위와 같다. 그리고
# 파일명에 서버명의 일부를 포함한다
VirtualDocumentRoot /www/hosts/%2/docs
# 하나의 cgi-bin 디렉토리
ScriptAlias /cgi-bin/ /www/std-cgi/
`

`mod_vhost_alias` 문서에는 더 복잡한 `VirtualDocumentRoot` 설정의 예가 있다.

## 한 서버에 여러 가상호스트 시스템 사용하기 ¶

더 복잡한 설정의 예로 아파치의 일반적인 `<VirtualHost>` 지시어를 사용하여 여러 가상호스트 설정의 범위를 조절할 수 있다. 예를 들어, 다음과 같은 설정은 홈페이지 고객에 IP 주소 한개, 상업적인 고객에게 다른 IP 주소 한개를 부여한다. 물론 이전처럼 `<VirtualHost>` 설정 섹션에 모두 묶을 수도 있다.

`UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
<Directory /www/commercial>
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /www/homepages>
Options FollowSymLinks
AllowOverride None
</Directory>
<VirtualHost 111.22.33.44>
ServerName www.commercial.isp.com
CustomLog logs/access_log.commercial vcommon
VirtualDocumentRoot /www/commercial/%0/docs
VirtualScriptAlias /www/commercial/%0/cgi-bin
</VirtualHost>
<VirtualHost 111.22.33.45>
ServerName www.homepages.isp.com
CustomLog logs/access_log.homepages vcommon
VirtualDocumentRoot /www/homepages/%0/docs
ScriptAlias /cgi-bin/ /www/std-cgi/
</VirtualHost>`

## 더 효율적인 IP기반 가상호스트 ¶

첫번째 예에서 나는 설정을 간단히 IP기반 가상호스트로 바꿀 수 있다고 말했다. 불행히도 그런 설정은 매 요청마다 DNS를 찾아야하므로 매우 비효율적이다. 이름대신 IP 주소로 파일시스템을 구성하고 같은 방식으로 로그를 수정하면 문제를 해결할 수 있다. 아파치는 서버명을 다룰 필요가 없어지고, DNS 검색도 하지 않게 된다.

`# IP 주소를 역DNS 검색하여 서버명을 알아낸다
UseCanonicalName DNS
# 로그를 나눌 수 있도록 IP 주소를 포함한다
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
CustomLog logs/access_log vcommon
# 파일명에 IP 주소를 포함한다
VirtualDocumentRootIP /www/hosts/%0/docs
VirtualScriptAliasIP /www/hosts/%0/cgi-bin
`

## 아파치 이전 버전 사용하기 ¶

위 예들은 아파치 버전 1.3.6 이후에 포함된 `mod_vhost_alias`을 사용한다. `mod_vhost_alias`가 없는 아파치 버전을 사용한다면 이미 말했듯이 `mod_rewrite`를 사용하여, 단 Host:-헤더기반 가상호스트만을, 구현할 수 있다.

또 로그에 관하여 주의할 점이 있다. 아파치 1.3.6에서 로그형식 지시어 `%V`가 포함되었고, 버전 1.3.0 - 1.3.3에서 이 기능을 `%v` 옵션이 대신 했다. 그러나 버전 1.3.4에는 이런 기능이 없다. 어떤 아파치 버전에서도 `.htaccess` 파일에서 `UseCanonicalName` 지시어를 사용할 수 있으므로 로그에 이상한 내용이 기록될 수 있다. 그러므로 가장 좋은 방법은 `%{Host}i` 지시어를 사용하여 `Host:` 헤더를 직접 로그에 남기는 것이다. 또, 이 방법은 `%V`는 포함하지않는 `:port`를 뒤에 추가할 수 있다.

## `mod_rewrite`를 사용한 간단한 동적 가상호스트 ¶

다음은 첫번째 예와 같은 일을 하는 `httpd.conf` 예이다. 처음 절반은 첫번째 예와 거의 비슷하지만, 이전 버전과의 호환성과 `mod_rewrite`의 적절한 동작을 위해 수정되었다. 나머지 절반은 실제 작업을 하는 `mod_rewrite`를 설정한다.

특별히 주의해야 할 사항이 있다. 기본적으로 `mod_rewrite`는 (`mod_alias` 등) 다른 URI 번역 모듈 이전에 실행된다. 그래서 다른 URI 번역 모듈들과 같이 동작할 것을 고려하여 `mod_rewrite`를 설정해야 한다. 또, 동적 가상호스트에서 `ScriptAlias`과 같은 기능을 위해서는 특별한 작업이 필요하다.

`# Host: 헤더에서 서버명을 얻는다
UseCanonicalName Off
# splittable logs
LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon
CustomLog logs/access_log vcommon
<Directory /www/hosts>
# ScriptAlias 식으로 CGI 실행을 강제할 수 없기때문에
# 여기에 ExecCGI를 사용한다
Options FollowSymLinks ExecCGI
</Directory>
# 이제 어려운 부분이다
RewriteEngine On
# Host: 헤더에서 가져온 서버명에는 대소문자가 뒤섞여있을 수 있다
RewriteMap lowercase int:tolower
## 일반 문서를 먼저 처리한다:
# Alias /icons/ 가 동작하도록 - 다른 alias에 대해서도 반복
RewriteCond %{REQUEST_URI} !^/icons/
# CGI가 동작하도록
RewriteCond %{REQUEST_URI} !^/cgi-bin/
# 특별한 작업
RewriteRule ^/(.*)$ /www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1
## 이제 CGI를 처리한다 - MIME type을 강제해야 한다
RewriteCond %{REQUEST_URI} ^/cgi-bin/
RewriteRule ^/(.*)$ /www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1 [T=application/x-httpd-cgi]
# 끝!`

## `mod_rewrite`를 사용한 홈페이지 시스템 ¶

다음은 두번째 예와 같은 일을 한다.

`RewriteEngine on
RewriteMap lowercase int:tolower
# CGI가 동작하도록
RewriteCond %{REQUEST_URI} !^/cgi-bin/
# RewriteRule이 동작하도록 호스트명이 올바른지 검사한다
RewriteCond ${lowercase:%{SERVER_NAME}} ^www\.[a-z-]+\.isp\.com$
# 가상호스트명을 URI 앞에 붙인다
# [C]는 이 결과를 가지고 다음 재작성을 수행함을 뜻한다
RewriteRule ^(.+) ${lowercase:%{SERVER_NAME}}$1 [C]
# 이제 실제 파일명을 만든다
RewriteRule ^www\.([a-z-]+)\.isp\.com/(.*) /home/$1/$2
# 전체 CGI 디렉토리를 정의한다
ScriptAlias /cgi-bin/ /www/std-cgi/`

## 별도의 가상호스트 설정파일 사용하기 ¶

다음은 `mod_rewrite`의 고급 기능을 사용하여 별도의 설정파일을 가지고 가상호스트의 문서루트를 알아낸다. 더 유연하지만 더 복잡한 설정이 필요하다.

`vhost.map` 파일은 다음과 같다:

`www.customer-1.com /www/customers/1
www.customer-2.com /www/customers/2
# ...
www.customer-N.com /www/customers/N
`

`http.conf`는 다음과 같다:

`RewriteEngine on
RewriteMap lowercase int:tolower
# 대응파일을 정의한다
RewriteMap vhost txt:/www/conf/vhost.map
# 위와 같이 alias들을 처리한다
RewriteCond %{REQUEST_URI} !^/icons/
RewriteCond %{REQUEST_URI} !^/cgi-bin/
RewriteCond ${lowercase:%{SERVER_NAME}} ^(.+)$
# 파일 내용을 가지고 찾는다
RewriteCond ${vhost:%1} ^(/.*)$
RewriteRule ^/(.*)$ %1/docs/$1
RewriteCond %{REQUEST_URI} ^/cgi-bin/
RewriteCond ${lowercase:%{SERVER_NAME}} ^(.+)$
RewriteCond ${vhost:%1} ^(/.*)$
RewriteRule ^/(.*)$ %1/cgi-bin/$1`

가능한 언어: en | fr | ko | tr