아파치 모듈 mod_alias

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

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

설명:	파일시스템의 다른 부분들을 문서 계층구조에 포함하고, URL 리다이렉션을 제공한다
상태:	Base
모듈명:	alias_module
소스파일:	mod_alias.c

요약

이 모듈이 제공하는 지시어들을 사용하여 서버가 요청을 받을때 URL을 수정하거나 조작할 수 있다. Alias와 ScriptAlias 지시어는 URL을 파일시스템 경로로 대응한다. 그래서 DocumentRoot 아래에 없는 내용을 웹으로 서비스할 수 있다. 또, ScriptAlias 지시어는 지정한 디렉토리에 CGI 스크립트밖에 없다고 알린다.

Redirect 지시어는 클라이언트에게 다른 URL로 새로운 요청을 하도록 지시한다. 자원을 새로운 장소로 옮긴 경우 자주 사용한다.

mod_alias는 간단한 URL 조작을 위해 설계되었다. 질의문자열 조작과 같은 복잡한 작업은 mod_rewrite가 제공하는 기능을 이용하라.

주제

처리 순서

Bugfix checklist

참고

처리 순서

서로 다른 사용장소에서 Alias와 Redirect를 사용하면 다른 지시어와 같이 표준 결합 방법에 따라 처리한다. 그러나 같은 사용장소에 (예를 들어, 같은 <VirtualHost> 섹션에) Alias와 Redirect를 사용하면 아래 순서대로 처리한다.

먼저 모든 Redirect를 처리한 후 Alias를 처리한다. 그래서 Redirect나 RedirectMatch에 해당하는 요청은 절대로 Alias하지 않는다. 그리고 Alias와 Redirect는 설정파일에서 첫번째로 나오는 것을 사용한다.

그래서 여러 지시어가 동일한 하위경로에 해당하는 경우 모든 지시어를 적용하기위해서는 가장 상세한 경로를 먼저 사용해야 한다. 예를 들어, 다음 설정은 의도한대로 동작한다:

Alias /foo/bar /baz Alias /foo /gaq

그러나 위의 두 지시어 순서를 바꾸면 /foo/bar Alias 이전에 /foo Alias를 적용하므로 항상 두번째 지시어를 무시한다.

Alias 지시어

설명:	URL을 특정 파일시스템 장소로 대응한다
문법:	`Alias URL-path file-path\|directory-path`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_alias

Alias 지시어를 사용하면 파일시스템에서 DocumentRoot 밖에 있는 문서도 서비스할 수 있다. url-path로 시작하는 (%로 인코딩된) URL을 directory-path로 시작하는 파일에 대응한다.

예제:

Alias /image /ftp/pub/image

https://myserver/image/foo.gif를 요청하면 서버는 /ftp/pub/image/foo.gif 파일을 넘겨준다.

url-path 끝에 /를 포함하면, URL 끝에 /를 사용해야만 영향이 있음을 주의하라. 즉, Alias /icons/ /usr/local/apache/icons/ 설정은 url /icons와 관계가 없다.

대응의 대상을 포함하는 여러 <Directory> 섹션이 필요할지도 모른다. 이 지시어는 <Directory> 섹션을 검사하기 전에 처리하므로, 대응의 대상만 섹션의 영향을 받는다. (그러나 <Location> 섹션은 이 지시어를 처리하기 전에 한번만 검사하므로 지정한 URL 이하 전체에 영향을 준다.)

특히 DocumentRoot 밖에 있는 디렉토리로 Alias를 만들었다면, 직접 대상 디렉토리의 접근을 허용해줘야 한다.

예제:

Alias /image /ftp/pub/image <Directory /ftp/pub/image> Order allow,deny Allow from all </Directory>

AliasMatch 지시어

설명:	정규표현식을 사용하여 URL을 파일시스템 장소로 대응한다
문법:	`AliasMatch regex file-path\|directory-path`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_alias

이 지시어는 Alias와 같지만, 간단히 URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다. 지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로 묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음과 같이 /icons 디렉토리를 사용할 수 있다:

AliasMatch ^/icons(.*) /usr/local/apache/icons$1

Redirect 지시어

설명:	클라이언트가 다른 URL에 접속하도록 요청하는 외부 리다이렉션을 보낸다
문법:	`Redirect [status] URL-path URL`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_alias

Redirect 지시어는 이전 URL을 새로운 URL로 대응한다. 클라이언트에게 새로운 URL을 보내고, 클라이언트는 새로운 주소로 다시 한번 접속한다. (%로 인코딩된) URL-path로 시작하는 요청을 받으면 (%로 인코딩된) URL로 시작하는 새로운 URL로 리다이렉션 오류를 보낸다.

예제:

Redirect /service https://foo2.bar.com/service

클라이언트가 https://myserver/service/foo.txt를 요청하면 대신 https://foo2.bar.com/service/foo.txt에 접근하라는 응답을 받는다.

주의

Redirect 지시어는 설정파일에서 나오는 순서와 관계없이 Alias와 ScriptAlias 지시어보다 우선순위가 높다. 또, .htaccess 파일이나 <Directory> 섹션에서 사용하더라도 URL-path에는 상대경로가 아니라 반드시 완전한 URL을 사용해야 한다.

status 아규먼트를 지정하지않으면, "임시 (temporary)" (HTTP 상태 302) 리다이렉션을 보낸다. 즉, 클라이언트에게 자원을 임시로 옮겼다고 알린다. status 아규먼트를 사용하여 다른 HTTP 상태코드를 반환할 수 있다:

permanent: 자원을 완전히 옮겼음을 뜻하는 영구 리다이렉션 상태를 (301) 반환한다.
temp: 임시 리다이렉션 상태를 (302) 반환한다. 기본값이다.
seeother: 자원이 교체되었음을 뜻하는 "참조 (See Other)" 상태를 (303) 반환한다.
gone: 자원이 영구히 삭제되었음을 뜻하는 "소멸 (Gone)" 상태를 (410) 반환한다. 이 상태를 사용하면 URL 아규먼트를 사용할 수 없다.

status에 숫자 상태코드를 사용하여 다른 상태코드도 반환할 수 있다. 상태가 300과 399 사이라면 URL 아규먼트를 사용해야 하고, 아니라면 생략해야 한다. 단, 아파치 코드에 상태가 정의되있어야 한다 (http_protocol.c의 send_error_response 함수 참고).

예제:

Redirect permanent /one https://example.com/two Redirect 303 /three https://example.com/other

RedirectMatch 지시어

설명:	현재 URL이 정규표현식에 해당하면 외부 리다이렉션을 보낸다
문법:	`RedirectMatch [status] regex URL`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_alias

이 지시어는 Redirect와 같지만, 간단히 URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다. 지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로 묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음은 모든 GIF 파일 요청에 대해 다른 서버의 비슷한 이름을 가진 JPEG 파일로 리다이렉션을 보낸다:

RedirectMatch (.*)\.gif$ https://www.anotherserver.com$1.jpg

RedirectPermanent 지시어

설명:	클라이언트가 다른 URL에 접속하도록 요청하는 외부 영구 리다이렉션을 보낸다
문법:	`RedirectPermanent URL-path URL`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_alias

이 지시어는 클라이언트에게 리다이렉션이 영구적임을 (상태 301) 알린다. Redirect permanent와 정확히 같다.

RedirectTemp 지시어

설명:	클라이언트가 다른 URL에 접속하도록 요청하는 외부 임시 리다이렉션을 보낸다
문법:	`RedirectTemp URL-path URL`
사용장소:	주서버설정, 가상호스트, directory, .htaccess
Override 옵션:	FileInfo
상태:	Base
모듈:	mod_alias

이 지시어는 클라이언트에게 리다이렉션이 임시적임을 (상태 302) 알린다. Redirect temp와 정확히 같다.

ScriptAlias 지시어

설명:	URL을 특정 파일시스템 장소로 대응하고 대상이 CGI 스크립트라고 알린다
문법:	`ScriptAlias URL-path file-path\|directory-path`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_alias

ScriptAlias 지시어는 Alias 지시어와 비슷하지만, 추가로 대상 디렉토리에 mod_cgi의 cgi-script 핸들러가 처리할 CGI 스크립트가 있다고 알린다. URL-path로 시작하는 (%로 인코딩된) URL을 파일시스템의 절대경로인 두번째 아규먼트로 시작하는 스크립트에 대응한다.

예제:

ScriptAlias /cgi-bin/ /web/cgi-bin/

https://myserver/cgi-bin/foo를 요청하면 서버는 /web/cgi-bin/foo 스크립트를 실행한다.

ScriptAliasMatch 지시어

설명:	정규표현식을 사용하여 URL을 특정 파일시스템 장소로 대응하고 대상이 CGI 스크립트라고 알린다
문법:	`ScriptAliasMatch regex file-path\|directory-path`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_alias

이 지시어는 ScriptAlias와 같지만, 간단히 URL의 앞부분만 비교하는 대신 표준 정규표현식을 사용한다. 지정한 정규표현식을 URL 경로와 비교하여 맞다면, 서버는 괄호로 묶은 부분을 대체하여 파일명으로 사용한다. 예를 들어, 다음과 같이 표준적인 /cgi-bin을 사용할 수 있다:

ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1