diff --git a/docs/manual/mod/mod_cgi.xml.ko b/docs/manual/mod/mod_cgi.xml.ko new file mode 100644 index 0000000000..3934d7806c --- /dev/null +++ b/docs/manual/mod/mod_cgi.xml.ko @@ -0,0 +1,209 @@ + + + + + + +mod_cgi +CGI 스크립트 실행 +Base +mod_cgi.c +cgi_module + + + + +

서버는 mime type이 application/x-httpd-cgi이거나 + (아파치 1.1 이후) 핸들러가 cgi-script인 모든 + 파일을 CGI 스크립트로 인식하여, 실행하고, 그 결과를 클라이언트에게 + 보낸다. 파일이 AddType + 지시어로 지정한 확장자를 가지거나, ScriptAlias 디렉토리 안에 + 있으면 CGI로 처리된다.

+ +

서버는 CGI 스크립트를 부를때 DOCUMENT_ROOT라는 + 환경변수를 추가한다. 이 변수는 DocumentRoot 설정값을 가진다.

+ +

아파치에서 CGI 스크립트를 사용하는 방법에 대한 소개는 + CGI로 동적내용 투토리얼을 + 참고하라.

+ +

유닉스에서 다중쓰레드 MPM을 사용한다면 이 모듈대신 + mod_cgid 모듈을 사용해야 한다. 사용자 + 입장에서 이 두 모듈은 기본적으로 동일하다.

+ + +AcceptPathInfo +Options +ScriptAlias +AddHandler +다른 사용자 ID로 CGI 프로그램 +실행하기 +CGI 표준 + +
CGI 환경변수 +

서버는 다음과 같은 방법으로 CGI 표준이 설명하는 + CGI 환경변수를 설정한다:

+ +
+
PATH_INFO
+ +
이 변수는 AcceptPathInfo 지시어를 직접 off로 + 지정한 경우에만 설정한다. AcceptPathInfo가 없는 경우 서버는 기본적으로 + 경로 정보가 있는 요청에 대해 404 NOT FOUND 오류를 내지만, + mod_cgi는 경로 정보를 (URI에서 스크립트 + 파일명 뒤에 나오는 /more/path/info) 받는다. + AcceptPathInfo 지시어를 생략하면 + mod_cgi 요청에 대해서 AcceptPathInfo를 On으로 + 설정한 것과 같다.
+ +
REMOTE_HOST
+ +
이 변수는 HostnameLookups가 on이고 (기본값은 + off), 접속한 호스트 주소를 역DNS 검색하여 실제 호스트명을 + 찾은 경우에만 설정한다.
+ +
REMOTE_IDENT
+ +
이 변수는 IdentityCheck가 on이고, 접속한 + 호스트가 ident 프로토콜을 지원하는 경우에만 설정한다. + 쉽게 이 값을 속일 수 있기때문에 이 변수의 내용을 믿으면 + 안되고, 클라이언트와 서버 사이에 프록시가 있다면 변수 + 내용이 완전히 무의미함을 주의하라.
+ +
REMOTE_USER
+ +
CGI 스크립트가 인증을 거쳐야하는 경우에만 설정한다.
+
+
+ +
CGI 디버깅 +

어디에서 잘못 실행되는지 스크립트의 출력을 (표준출력과 + 표준오류) 볼 수 없기때문에 CGI 스크립트는 전통적으로 디버깅하기 + 어려웠다. 아파치 1.2 이후에 추가된 지시어를 사용하면 발생한 + 오류를 자세히 로그에 남길 수 있다.

+ +
CGI 로그파일 형식 +

CGI 오류로그는 정상적으로 실행하지 못한 CGI를 기록한다. + 오류가 발생한 CGI 스크립트는 로그에 여러 줄의 정보를 남긴다. + 첫번째 두 줄은 항상 아래와 같은 형식이다:

+ + + %% [시간] 요청줄
+ %% HTTP-상태 CGI-스크립트-파일명 + + +

CGI 스크립트를 실행할 수 없는 오류인 경우 로그파일에 + 추가로 두 줄을 더 기록한다:

+ + + %%error
+ 오류문 + + +

스크립트가 (보통 스크립트의 버그때문에) 잘못된 헤더 + 정보를 반환하는 경우, 다음 내용을 로그에 기록한다:

+ + + %request
+ 받은 모든 HTTP 헤더
+ (있다면) POST나 PUT 내용
+ %response
+ CGI 스크립트 출력의 모든 헤더
+ %stdout
+ CGI 표준출력
+ %stderr
+ CGI 표준오류
+ + +

(스크립트가 표준출력이나 표준오류에 아무 내용도 출력하지 + 않았다면 %stdout과 %stderr 부분은 생략될 수 있다).

+
+
+ + +ScriptLog +CGI 스크립트 오류로그파일의 위치 +ScriptLog file-path +server config +virtual host +mod_cgimod_cgid + + + +

ScriptLog 지시어는 CGI 스크립트 + 오류로그파일을 지정한다. ScriptLog를 + 사용하지않으면 오류로그를 만들지 않는다. 사용하면 아규먼트로 + 지정한 파일에 CGI 오류를 기록한다. 상대경로를 지정하면 + ServerRoot에 상대경로로 + 받아들인다. +

+ + 예제 + ScriptLog logs/cgi_log + + +

자식 프로세스를 실행하는 사용자, 즉 User 지시어로 지정한 사용자 + 권한으로 로그를 연다. 그래서 그 사용자가 스크립트 로그가 + 있는 디렉토리에 쓰기권한이 있던지, 직접 미리 파일을 만들어서 + 그 사용자에게 쓰기권한을 줘야 한다. 스크립트 로그를 주 로그 + 디렉토리에 둔다면 자식 프로세스를 실행하는 사용자에게 쓰기권한을 + 주기위해 디렉토리 권한을 변경하지 마라.

+ +

스크립트 로그는 CGI 스크립트를 작성할때 디버깅을 위한 + 용도이지 서버를 실행하는 동안 계속 사용하기위함이 아님을 + 주의하라. 속도와 효율성면에서 최적화가 안되있고, 설계한 + 목적이외의 방법으로 사용하면 보안상 문제가 될 수 있다.

+ + + + +ScriptLogLength +CGI 스크립트 로그파일의 크기 제한 +ScriptLogLength bytes +ScriptLogLength 10385760 +server config +virtual host +mod_cgimod_cgid + + + +

ScriptLogLength는 CGI 스크립트 + 로그파일의 크기를 제한한다. CGI 오류가 발생할때마다 (모든 + 요청 헤더, 모든 스크립트 출력 등) 많은 정보가 로그에 + 기록되기때문에 파일이 매우 커질 수 있다. 파일이 무한히 커지는 + 문제를 막기위해 이 지시어를 사용하여 CGI 로그파일의 최대 + 파일크기를 설정한다. 파일의 크기가 설정한 값을 넘으면 더 + 이상 정보를 기록하지않는다.

+ + + + +ScriptLogBuffer +스크립트 로그에 기록할 PUT 혹은 POST 요청의 최대량 +ScriptLogBuffer bytes +ScriptLogBuffer 1024 +server config +virtual host +mod_cgimod_cgid + + + +

큰 내용을 받아서 로그파일이 너무 빨리 커지는 현상을 막기위해 + 파일에 기록할 PUT 혹은 POST 내용의 크기를 제한한다. 기본적으로 + 1024 바이트까지 로그에 기록하지만, 이 지시어를 사용하여 + 수정할 수 있다.

+ + + + diff --git a/docs/manual/mod/mod_cgid.xml.ko b/docs/manual/mod/mod_cgid.xml.ko new file mode 100644 index 0000000000..5703f3adaf --- /dev/null +++ b/docs/manual/mod/mod_cgid.xml.ko @@ -0,0 +1,74 @@ + + + + + + +mod_cgid +외부 CGI 데몬을 사용하여 CGI 스크립트를 실행 +Base +mod_cgid.c +cgid_module +유닉스에서 쓰레드를 사용하는 MPMs 전용 + + +

아래에서 설명하는 추가된 ScriptSock 지시어를 제외하고 + mod_cgid는 mod_cgi와 + 비슷하게 동작한다. 아파치와 CGI에 대한 자세한 설명은 + mod_cgi를 참고하라.

+ +

어떤 유닉스 운영체제의 경우 다중쓰레드 서버에서 프로세스를 + 포크(fork)하면 새로운 프로세스가 부모 프로세스의 모든 쓰레드를 + 복제해야 하므로 부담이 된다. CGI 실행마다 이런 부담을 주지 + 않기위해 mod_cgid는 CGI 스크립트를 실행하는 + 자식 프로세스를 포크하는 외부 데몬을 만든다. 주서버는 이 + 데몬과 유닉스소켓(unix domain socket)을 사용하여 통신한다.

+ +

컴파일할때 다중쓰레드 MPM을 선택하면 기본적으로 + mod_cgi 대신 이 모듈을 사용한다. 사용자 + 입장에서 이 모듈의 설정과 동작은 mod_cgi와 + 동일하다. 유일한 차이점은 cgi 데몬과 통신을 위해 사용할 + 소켓의 이름을 설정하는 ScriptSock 지시어가 + 추가된 점이다.

+ + +mod_cgi +다른 사용자 ID로 CGI 프로그램 +실행하기 + + +ScriptLog + + + +ScriptLogLength + + + +ScriptLogBuffer + + + +ScriptSock +cgi 데몬과 통신을 위해 사용할 소켓의 이름 +ScriptSock file-path +ScriptSock logs/cgisock +server config +virtual host + + +

이 지시어는 CGI 데몬과 통신을 위해 사용할 소켓의 이름을 + 지정한다. 아파치를 시작한 사용자 (보통 root) 권한으로 소켓을 + 연다. CGI 스크립트와 통신의 보안을 위해 다른 사용자가 소켓이 + 있는 디렉토리에 쓰기권한을 가지지않는 것이 중요하다.

+ + 예제 + ScriptSock /var/run/cgid.sock + + + + + + + diff --git a/docs/manual/mod/mod_charset_lite.xml.ko b/docs/manual/mod/mod_charset_lite.xml.ko new file mode 100644 index 0000000000..7ef386a2b8 --- /dev/null +++ b/docs/manual/mod/mod_charset_lite.xml.ko @@ -0,0 +1,168 @@ + + + + + + +mod_charset_lite +문자집합 변환을 지정 +Experimental +mod_charset_lite.c +charset_lite_module + + +

이 모듈은 실험적인 모듈이고, 주의있게 + 사용해야 한다. 원하는 동작을 하는지 + mod_charset_lite 설정을 시험해봐라.

+ +

mod_charset_lite를 사용하여 문서 원본의 + 문자집합과 문서를 클라이언트로 보내기 전에 변환할 문자집합을 + 지정할 수 있다. mod_charset_lite는 직접 + 자료를 변환하지않고 대신 아파치에게 변환하라고 요청한다. + mod_charset_lite는 EBCDIC과 ASCII 환경에서 + 사용할 수 있다. EBCDIC 환경에서 아파치는 보통 아파치 프로세스의 + 코드페이지에서 ISO-8859-1 문자집합으로 문서를 변환한다. + mod_charset_lite를 사용하여 다른 변환을 + 지시할 수 있다. ASCII 환경에서 아파치는 기본적으로 변환을 + 하지 않기때문에, 어떤 변환을 위해서는 + mod_charset_lite가 필요하다.

+ +

이 모듈은 러시아판 아파치의 mod_charset이 + 제공하는 설정의 일부를 제공한다.

+ + +
일반적인 문제점 + +
잘못된 문자집합 이름 + +

mod_charset_lite를 사용하는 시스템의 + ARP 번역기능이 CharsetSourceEnc와 + CharsetDefault의 + 파라미터인 문자집합 이름을 처리할 수 있어야 한다. 문자집합 + 이름은 표준화되지 않았고, http 헤더에 사용하는 값과 항상 + 같지는 않다. 현재 APR은 iconv(3)만을 사용하기때문에, + 다음과 같이 iconv(1) 프로그램을 사용하여 특정 문자집합 + 이름을 사용할 수 있는지 쉽게 알 수 있다:

+ + + iconv -f charsetsourceenc-value -t charsetdefault-value + +
+ +
내용과 변환규칙의 문자집합이 서로 다름 + +

변환규칙이 상황에 맞지않으면 다음과 같은 여러 방식으로 + 변환이 실패할 수 있다:

+ +
    +
  • 변환기능이 실패 반환코드를 반환하고 연결이 끊어질 + 수 있다.
    • + +
  • 입력버퍼를 변환하지 못할때 출력버퍼에 대신 특별한 + 문자를 (예, 물음표) 적을 수 있다.
    • +
+
+
+ + +CharsetSourceEnc +파일 원본의 문자집합 +CharsetSourceEnc charset +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

CharsetSourceEnc 지시어는 지시어를 + 사용한 위치에 있는 파일들 원본의 문자집합을 지정한다.

+ +

charset 아규먼트에는 APR이 지원하는 문자집합 + 이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을 + 의미한다.

+ + 예제 + <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+ + </Directory> + + +

Solaris 8의 iconv가 이 예제의 문자집합을 지원한다.

+ + + + +CharsetDefault +변환할 문자집합 +CharsetDefault charset +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

CharsetDefault 지시어는 지시어를 + 사용한 위치에 있는 원본을 변환할 문자집합을 지정한다.

+ +

charset 아규먼트에는 APR이 지원하는 문자집합 + 이름을 사용해야 한다. 일반적으로 iconv가 지원하는 문자집합을 + 의미한다.

+ + 예제 + <Directory /export/home/trawick/apacheinst/htdocs/convert>
+ + CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+ + </Directory> + + + + + +CharsetOptions +문자집합 변환 기능을 설정 +CharsetOptions option [option] ... +CharsetOptions DebugLevel=0 NoImplicitAdd +server config +virtual hostdirectory +.htaccess + +FileInfo + + +

CharsetOptions 지시어는 + mod_charset_lite의 기능을 설정한다. + Option에는 아래 항목들을 사용할 수 있다

+ +
+
DebugLevel=n
+ +
DebugLevel 키워드는 + mod_charset_lite가 기록하는 디버그문구의 + 수준을 설정한다. 기본적으로 어떤 것도 기록하지 않는다. + 이는 DebugLevel=0과 같다. 높은 숫자를 사용할수록 + 더 많은 디버그문구를 기록하게되어 서버 성능이 떨어진다. + 숫자값의 실제 의미는 mod_charset_lite.c 앞부분의 + DBGLVL_ 상수 정의를 참고하라.
+ +
ImplicitAdd | NoImplicitAdd
+ +
ImplicitAdd 키워드는 내용을 변환할 + 문자집합을 지정하면 자동으로 mod_charset_lite를 + 필터에 추가한다. AddOutputFilter 지시어로 필터순서를 직접 + 지정한다면, NoImplicitAdd를 사용하여 + mod_charset_lite가 자동으로 필터에 + 추가되지않도록 해야 한다.
+
+ + + + diff --git a/docs/manual/mod/mod_dav.xml.ko b/docs/manual/mod/mod_dav.xml.ko new file mode 100644 index 0000000000..9e8f775995 --- /dev/null +++ b/docs/manual/mod/mod_dav.xml.ko @@ -0,0 +1,230 @@ + + + + + + +mod_dav +Distributed Authoring and Versioning +(WebDAV) 기능 +Extension +mod_dav.c +dav_module + + +

이 모듈은 아파치에 WebDAV + ('Web-based Distributed Authoring and Versioning') class 1과 + class 2 기능을 추가한다. WebDAV는 원격 웹서버의 자원과 + 콜렉션(collection)을 콜렉션은 파일시스템의 디렉토리와 + 같은 개념이다 만들고, 옮기고, 복사하고, 지울 + 수 있도록 HTTP 프로토콜을 확장한 것이다.

+ +DavLockDB +LimitXMLRequestBody +WebDAV 정보 + +
WebDAV 사용하기 +

mod_dav를 사용하려면 httpd.conf + 파일에 아래과 같이 추가한다:

+ + Dav On + +

그러면 mod_dav_fs 모듈이 구현하는 DAV + 파일시스템 제공자(provider)를 사용한다. 그러므로 이 모듈도 + 서버에 같이 컴파일되있거나 LoadModule 지시어로 실행중에 + 읽어들여야 한다.

+ +

또, DAV 잠금(lock) 데이터베이스의 위치를 httpd.conf + 파일의 전역 부분에 DavLockDB 지시어를 사용하여 + 지정해야 한다:

+ + + DavLockDB /usr/local/apache2/var/DavLock + + +

아파치를 실행하는 User와 Group은 잠금 데이터베이스가 + 있는 디렉토리에 쓰기 권한을 가져야 한다.

+ +

DAV를 사용하는 위치에 접근을 제한하기위해 Location 지시어 + 안에 Limit + 지시어를 사용할 수 있다. DAV 클라이언트가 한번의 요청에 + 보낼 수 있는 최대 바이트수를 제한하려면 LimitXMLRequestBody 지시어를 사용한다. + "일반적인" LimitRequestBody + 지시어는 DAV 요청과 관계없다.

+ + 전체 예제 + DavLockDB /usr/local/apache2/var/DavLock
+
+ <Location /foo>
+ + Dav On
+
+ AuthType Basic
+ AuthName DAV
+ AuthUserFile user.passwd
+
+ <LimitExcept GET OPTIONS>
+ + require user admin
+ + </LimitExcept>
+ + </Location>
+ + +

mod_dav는 Greg Stein이 만든 Apache 1.3용 mod_dav를 + 기반으로 만들었다. 모듈에 대한 더 자세한 정보는 그 사이트를 + 참고하라.

+
+ +
보안 문제 + +

DAV를 사용하면 원격 클라이언트가 서버의 파일을 조작할 + 수 있기때문에, mod_dav를 사용하기 전에 + 서버가 안전한지 특별히 관심을 가져야 한다.

+ +

서버에서 DAV가 가능한 위치는 인증으로 보호해야 한다. + HTTP Basic Authentication는 추천하지 않는다. 최소한 + mod_auth_digest 모듈이 제공하는 HTTP Digest + Authentication을 사용해야 한다. 거의 모든 WebDAV 클라이언트는 + 이 인증 방식을 지원한다. 아니면 SSL + 연결에서 Basic Authentication을 사용할 수도 있다.

+ +

mod_dav가 파일을 조작하려면, 아파치를 + 실행하는 User와 + Group은 해당 + 디렉토리와 파일에 쓰기 권한을 가져야 한다. 또, 새로 생성한 + 파일은 User와 + Group이 소유하게 + 된다. 그래서 아무나 이 계정에 접근할 수 없도록 하라. DAV + 저장소는 아파치만 접근할 수 있다고 가정한다. 아파치를 통하지않고 + (예를 들어 FTP나 파일시스템 도구를 사용하여) 파일을 수정함을 + 허용하면 안된다.

+ +

mod_dav는 여러 서비스거부 공격의 대상이 + 될 수 있다. LimitXMLRequestBody 지시어를 + 사용하여 큰 DAV 요청을 읽을때 메모리량을 제한할 수 있다. + DavDepthInfinity + 지시어를 사용하여 많은 메모리를 소모하기위한 매우 큰 저장소의 + PROPFIND 요청을 막을 수 있다. 단순히 클라이언트가 + 여러 큰 파일들로 디스크공간을 채우는 서비스거부 공격도 가능하다. + 아파치에서 이를 막을 직접적인 방법은 없다. 그러므로 신뢰하지않는 + 사용자에게 DAV 접근을 허용하지 않도록하라.

+
+ +
복잡한 설정 + +

일반적인 질문중 하나는 (PHP 스크립트, CGI 스크립트 등) + 동적파일 작업을 위해 mod_dav를 사용하는 + 방법이다. 이는 GET 요청이 파일 내용을 다운로드하지 + 않고 항상 스크립트를 실행하므로 어렵다. 해결방법중 하나는 + 내용에 두개의 URL을 대응하는 것이다. 한 URL은 스크립트를 + 실행하고, 다른 URL로는 파일을 다운로드하여 DAV로 작업할 + 수 있다.

+ + +Alias /phparea /home/gstein/php_files
+Alias /php-source /home/gstein/php_files
+<Location /php-source> + + DAV On
+ ForceType text/plain
+ +</Location> + + +

이 설정에서 http://example.com/phparea는 + PHP 스크립트의 결과를 보여주고, + http://example.com/php-source로는 DAV 클라이언트에서 + 스크립트를 수정할 수 있다.

+
+ + +Dav +WebDAV HTTP 메써드를 시작한다 +Dav On|Off|provider-name +Dav Off +directory + + +

지정한 위치에서 WebDAV HTTP 메써드를 사용하려면 + Dav 지시어를 사용한다:

+ + + <Location /foo>
+ + Dav On
+ + </Location> + + +

On 값은 실제로 mod_dav_fs + 모듈이 제공하는 기본 제공자인 filesystem의 + 별칭이다. 어떤 위치에서 DAV를 시작하면 하위공간에서 DAV를 + 사용안하도록 설정할 수 없음을 주의하라. 완전한 + 설정예는 위의 절을 참고하라.

+ + + 서버를 안전하게 구성할때까지 WebDAV을 사용하지 마라. 그렇지 + 않으면 누구라도 서버를 통해 파일을 분배할 수 있게 된다. + + + + + +DavMinTimeout +서버가 DAV 자원에 대해 유지할 잠금의 최소시간 +DavMinTimeout seconds +DavMinTimeout 0 +server configvirtual host +directory + + +

클라이언트가 DAV 자원에 잠금(lock)을 요청할때 서버가 + 알아서 잠금을 제거할 수 있는 시간을 같이 알려줄 수 있다. 이 값은 + 단지 요청일뿐이며, 서버는 클라이언트가 요청한 값을 무시하고 + 클라이언트에게 임의의 시간을 알려줄 수 있다.

+ +

DavMinTimeout 지시어는 클라이언트에게 + 보낼 최소 잠금 시간을 (초단위) 지정한다. Microsoft Web Folders는 + 기본값으로 120 초를 사용한다. DavMinTimeout에 + (600 초와 같이) 더 높은 값을 사용하면 클라이언트가 네트웍 + 지연때문에 잠금을 잃게되는 경우를 줄일 수 있다.

+ + 예제 + <Location /MSWord>
+ + DavMinTimeout 600
+ + </Location> + + + + + +DavDepthInfinity +PROPFIND의 Depth: Infinity 요청을 허가한다 +DavDepthInfinity on|off +DavDepthInfinity off +server configvirtual host +directory + + +

DavDepthInfinity 지시어를 사용하면 + 'Depth: Infinity' 헤더를 가진 PROPFIND 요청을 + 허가한다. 이런 요청을 사용하여 서비스거부 공격이 가능하기 + 때문에 기본적으로 허용하지 않는다.

+ + + + + + diff --git a/docs/manual/mod/mod_dav_fs.xml.ko b/docs/manual/mod/mod_dav_fs.xml.ko new file mode 100644 index 0000000000..7201b2c07c --- /dev/null +++ b/docs/manual/mod/mod_dav_fs.xml.ko @@ -0,0 +1,65 @@ + + + + + + +mod_dav_fs +mod_dav을 위한 파일시스템 제공자 +Extension +mod_dav_fs.c +dav_fs_module + + +

이 모듈은 mod_dav 서비스에 필요하다. + mod_dav를 지원하는 모듈로 서버의 파일시스템에 + 있는 자원을 접근할 수 있도록 한다. 이 제공자(provider)의 + 정식명칭은 filesystem이다. Dav 지시어를 지정하여 + mod_dav 뒷단 제공자를 사용한다:

+ + 예제 + Dav filesystem + + +

filesystem이 mod_dav의 + 기본 제공자이므로 대신 On을 사용할 수 있다.

+ +mod_dav + + +DavLockDB +DAV 잠금 데이터베이스 위치 +DavLockDB file-path +server configvirtual host + + + +

DavLockDB 지시어는 잠금 데이터베이스의 + 전체 경로를 확장자를 제외하고 지정한다. 절대경로가 아니면 + ServerRoot에 상대경로로 + 처리한다. mod_dav_fs는 잠금을 SDBM 데이터베이스에 + 기록한다.

+ + + + 예제 + DavLockDB var/DavLock + + +

아파치를 실행하는 User와 + Group은 잠금 + 데이터베이스가 있는 디렉토리에 쓰기 권한을 가져야 한다. + 보안상 이유로 기존 디렉토리의 권한을 바꾸기보다는 잠금 + 데이터베이스용 디렉토리를 만들어야 한다. 위의 경우 아파치는 + ServerRoot 아래 + var/ 디렉토리에 서버가 선택한 확장명을 가진 + DavLock 파일을 만든다.

+ + + + + + diff --git a/docs/manual/mod/mod_deflate.xml.ko b/docs/manual/mod/mod_deflate.xml.ko new file mode 100644 index 0000000000..70b5edfd06 --- /dev/null +++ b/docs/manual/mod/mod_deflate.xml.ko @@ -0,0 +1,294 @@ + + + + + + +mod_deflate +내용을 클라이언트로 보내기 전에 압축한다 +Extension +mod_deflate.c +deflate_module + + +

mod_deflate 모듈은 서버의 출력을 네트웍으로 + 클라이언트에 보내기 전에 압축하는 DEFLATE 출력필터를 + 제공한다.

+ +필터 + + + +
압축하기 + +
출력 압축 +

DEFLATE 필터가 + 압축을 한다. 다음 지시어는 지시어가 있는 위치의 문서를 + 압축한다:

+ + + SetOutputFilter DEFLATE + + +

모든 내용을 압축하면 처리하지 못하는 브라우저가 있기때문에 + html 파일만을 압축하기위해 (아래 참고) + gzip-only-text/html을 1로 설정할지도 + 모른다. 이를 1이 아닌 값으로 설정하면 + 무시한다.

+ +

보통 특별한 MIME type만 압축하려면 AddOutputFilterByType 지시어를 사용한다. + 다음 설정은 html 파일만을 압축한다:

+ + + <Directory "/your-server-root/manual">
+ + AddOutputFilterByType DEFLATE text/html
+ + </Directory> + + +

압축한 파일을 처리하지 못하는 브라우저에게는 압축하지않고 + 보내길위해 BrowserMatch 지시어에 no-gzip을 + 설정한다. 최적의 결과를 얻기위해 no-gzip과 + gzip-only-text/html을 같이 사용할 수 있다. + 이 경우 전자가 후자를 무시한다. 위 절의 설정 예제 일부를 살펴보자:

+ + + BrowserMatch ^Mozilla/4 gzip-only-text/html
+ BrowserMatch ^Mozilla/4\.0[678] no-gzip
+ BrowserMatch \bMSIE !no-gzip !gzip-only-text/html + + +

먼저 User-Agent 문자열을 보고 Netscape + Navigator 버전 4.x인지 검사한다. 이 버전은 text/html이 + 아닌 type의 압축을 처리하지 못한다. 버전 4.06, 4.07, 4.08은 + html 파일 압축을 처리하는대도 문제가 있다. 그래서 우리는 + 이 경우 deflate 필터를 완전히 사용하지않는다.

+ +

세번째 BrowserMatch + 지시어는 Microsoft Internet Explorer가 자신을 "Mozilla/4"로 + 알리지만 압축된 요청을 처리할 수 있기때문에 user agent + 추측을 수정한다. User-Agent 헤더에서 "MSIE" + (\b는 "단어 경계"를 뜻한다) 문자열을 발견하면 + 앞에서 설정한 제약을 푼다.

+ + 주의 + DEFLATE 필터는 항상 PHP나 SSI와 같은 RESOURCE + 필터 뒤에 들어간다. 또, 내부 하위요청(subrequest)에 영향을 + 주지 않는다. + +
+ +
입력 압축풀기 +

mod_deflate 모듈은 요청의 gzip 압축된 + 내용을 푸는 필터도 제공한다. 이 기능을 사용하려면 다음과 + 같이 SetInputFilter나 + AddInputFilter를 + 사용하여 입력필터순서에 DEFLATE 필터를 + 추가해야한다:

+ + + <Location /dav-area>
+ + SetInputFilter DEFLATE
+ + </Location> + + +

요청에 Content-Encoding: gzip 헤더가 있다면 + 자동으로 압축된 내용을 푼다. gzip 요청을 할 수 있는 + 브라우저는 드물다. 그러나 어떤 WebDAV 클라이언트와 같은 + 특별한 프로그램은 요청 압축을 지원한다.

+ + Content-Length에 대한 주의 +

요청 내용을 직접 살펴본다면, Content-Length + 헤더를 믿지마라! Content-Length 헤더는 클라이언트가 + 보낸 내용의 길이이지, 압축을 푼 결과의 바이트수가 + 아니다.

+ +
+
+ +
프록시 서버 다루기 + +

mod_deflate 모듈은 프록시가 자신이 캐쉬한 + 응답을 적절한 Accept-Encoding 요청 헤더를 보낸 + 클라이언트에게만 보내도록 Vary: + Accept-Encoding HTTP 응답 헤더를 추가한다. 그래서 + 압축된 내용을 이해할 수 없는 클라이언트에 압축된 내용을 + 보내지않도록 한다.

+ +

예를 들어, User-Agent 헤더 등에 따라 특별히 + 필터 적용을 취소한다면, 프록시에게 이러한 제한을 알려주기위해 + 직접 Vary 헤더에 추가해야 한다. 예를 들어, + 설정이 User-Agent에 따라 DEFLATE + 필터를 추가한다면 다음을 사용한다:

+ + + Header append Vary User-Agent + + +

요청 헤더외의 다른 정보에 (예를 들어, HTTP 버전) + 따라 압축 여부가 결정된다면, Vary 헤더값을 + *로 설정해야 한다. 그러면 표준을 따르는 프록시는 + 캐싱을 하지 않게 된다.

+ + 예제 + Header set Vary * + +
+ + +DeflateFilterNote +압축률을 로그에 기록한다 +DeflateFilterNote [type] notename +server configvirtual host + +type is available since Apache 2.0.45 + + +

DeflateFilterNote 지시어는 요청의 + 압축률을 로그에 기록하는 기호를 지정한다. 기호 이름은 지시어로 + 지정한 값이다. 통계를 위해 접근 + 로그에서 기호를 사용할 수 있다.

+ + 예제 + DeflateFilterNote ratio
+
+ LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
+ CustomLog logs/deflate_log deflate + + +

로그에서 더 정확한 값을 추출하려면 type 아규먼트로 + 기록할 자료를 선택한다. type는 다음중 하나이다:

+ +
+
Input
+
필터 입력스트림의 바이트수를 저장한다.
+ +
Output
+
필터 출력스트림의 바이트수를 저장한다..
+ +
Ratio
+
압축률을 (output/input * 100) 저장한다. + type 아규먼트를 생략하면 사용하는 기본값이다.
+
+ +

그래서 이렇게 로그에 기록할 수 있다:

+ + 정밀한 로그 + DeflateFilterNote Input instream
+ DeflateFilterNote Output outstream
+ DeflateFilterNote Ratio ratio
+
+ LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
+ CustomLog logs/deflate_log deflate + + +mod_log_config + + + +DeflateBufferSize +zlib이 한번에 압축할 크기 +DeflateBufferSize value +DeflateBufferSize 8096 +server configvirtual host + + + +

DeflateBufferSize 지시어는 zlib이 + 한번에 압축할 바이트수를 지정한다.

+ + + + +DeflateWindowSize +Zlib 압축 window size +DeflateWindowSize value +DeflateWindowSize 15 +server configvirtual host + + + +

DeflateWindowSize 지시어는 zlib + 압축 window size를 (1과 15 사이의 값) 지정한다. 일반적으로 + window size가 클수록 압축률이 증가한다.

+ + + + + +DeflateMemLevel +zlib이 압축할때 사용하는 메모리량 +DeflateMemLevel value +DeflateMemLevel 9 +server configvirtual host + + + +

DeflateMemLevel 지시어는 zlib이 + 압축할때 얼마만큼 메모리를 사용할지 결정한다. (1과 9 사이의 + 값)

+ + + + +DeflateCompressionLevel +출력을 얼만큼 압축하는가 +DeflateCompressionLevel value +Zlib's default +server configvirtual host + +This directive is available since Apache 2.0.45 + + +

DeflateCompressionLevel 지시어는 + 사용할 압축수준을 선택한다. 값이 클수록 압축률이 증가하지만, + CPU를 더 많이 사용한다.

+

(가장 덜 압축) 1과 (가장 많이 압축) 9 사이의 값을 지정한다.

+ + + + + + diff --git a/docs/manual/mod/mod_dir.xml.ko b/docs/manual/mod/mod_dir.xml.ko new file mode 100644 index 0000000000..f348fdbc5c --- /dev/null +++ b/docs/manual/mod/mod_dir.xml.ko @@ -0,0 +1,76 @@ + + + + + +mod_dir +"마지막 슬래쉬" 리다이렉션을 제공하고 디렉토리 +index 파일을 서비스한다 +Base +mod_dir.c +dir_module + + +

디렉토리의 index는 다음 둘중 한가지 방법으로 제공된다:

+ + +

두 기능은 서로 별개로 원한다면 자동 index 생성을 완전히 + 없앨 (혹은 교체할) 수 있다.

+ +

dirname이 디렉토리라면 서버는 URL + http://servername/foo/dirname 요청을 받으면 + "마지막 슬래쉬" 리다이렉션을 보낸다. 디렉토리에는 마지막 + 슬래쉬가 필요하다. 그래서 mod_dir은 + http://servername/foo/dirname/로 리다이렉션을 + 보낸다.

+ + + +DirectoryIndex +클라이언트가 디렉토리를 요청할때 찾아볼 자원 목록 +DirectoryIndex + local-url [local-url] ... +DirectoryIndex index.html +server configvirtual host +directory.htaccess +Indexes + + +

DirectoryIndex 지시어는 클라이언트가 + 디렉토리명 끝에 /를 붙여서 디렉토리의 index를 요청할때 찾아볼 + 자원 목록을 지정한다. Local-url은 요청한 디렉토리에 + 상대적인 문서의 (%로 인코딩된) URL이다. 보통은 디렉토리에 + 있는 파일명이다. 여러 URL을 지정할 수 있고, 이 경우 서버는 + 첫번째로 찾은 파일을 보낸다. 자원을 찾을 수 없고 + Indexes 옵션을 설정하였다면 서버는 직접 디렉토리 + 목록을 만든다.

+ + 예제 + DirectoryIndex index.html + + +

이 경우 http://myserver/docs/를 요청할때 + http://myserver/docs/index.html이 있으면 이를 + 보내고, 없다면 디렉토리 목록을 보낸다.

+ +

문서가 반드시 디렉토리에 상대적일 필요는 없다.

+ + + DirectoryIndex index.html index.txt /cgi-bin/index.pl + + +

이 경우 디렉토리에 index.html이나 + index.txt가 없으면 CGI 스크립트 + /cgi-bin/index.pl을 실행한다.

+ + + + diff --git a/docs/manual/mod/mod_disk_cache.xml.ko b/docs/manual/mod/mod_disk_cache.xml.ko new file mode 100644 index 0000000000..45cb14e7a4 --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.xml.ko @@ -0,0 +1,317 @@ + + + + + + +mod_disk_cache +Content cache storage manager keyed to URIs +Experimental +mod_disk_cache.c +disk_cache_module + + + + 이 모듈은 실험적인 상태이다. 문서는 아직 작업중이다... + + +

mod_disk_cache는 디스크기반 저장관리자를 + 구현한다. 이 모듈은 기본적으로 mod_proxy와 + 같이 사용한다.

+ +

내용을 URI를 토대로 만든 키로 캐쉬에 저장하고 가져온다. + 접근보호가 된 내용은 캐쉬하지않는다.

+ + 주의: +

mod_disk_cache는 + mod_cache가 필요하다.

+ + + + +CacheRoot +캐쉬 파일을 저장할 디렉토리 root +CacheRoot directory +server configvirtual host + + + +

CacheRoot 지시어는 디스크에서 + 캐쉬 파일을 저장할 디렉토리를 지정한다. mod_disk_cache 모듈을 아파치 서버와 같이 컴파일하였거나 + 읽어들인 경우 반드시 이 지시어를 정의해야 한다. + CacheRoot에 값이 없으면 설정파일을 + 처리하지 않는다. CacheDirLevels와 CacheDirLength 지시어는 + 이 지시어로 지정한 root 디렉토리의 하위디렉토리 구조를 지시한다.

+ + + CacheRoot c:/cacheroot + + + + + +CacheSize +캐쉬로 사용할 최대 디스크공간 (KByte 단위) +CacheSize KBytes +CacheSize 1000000 +server configvirtual host + + + +

CacheSize 지시어는 캐쉬로 사용할 + 디스크공간 크기를 KByte (1024 바이트) 단위로 지정한다. 이 + 지시어는 캐쉬 크기를 제한하지 않는다. 가비지컬랙터가 캐쉬 + 사용량이 설정한 값보다 작게될때까지 파일을 지운다. 항상 + 사용가능한 디스크공간 보다 작은 값을 사용하라.

+ + + CacheSize 5000000 + + + + + +CacheGcInterval +가비지컬랙터를 실행하는 간격. +CacheGcInterval hours +server configvirtual host + + + +

CacheGcInterval 지시어는 카비지컬랙터가 + 디스크공간을 비우는 시간 간격을 시간단위로 지정한다.

+

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheGcInterval 24
+ + + + CacheGcInterval 지시어는 현재 구현되지 + 않았다. + + + + + +CacheDirLevels +캐쉬의 하위디렉토리 깊이. +CacheDirLevels levels +CacheDirLevels 3 +server configvirtual host + + + +

CacheDirLevels 지시어는 캐쉬의 + 하위디렉토리 깊이를 지정한다. 캐쉬된 자료를 CacheRoot 디렉토리 + 아래 이 깊이까지 저장한다.

+ + +

CacheDirLevels와 CacheDirLength를 + 곱하여 20 보다 크면 안된다.

+ + + + CacheDirLevels 5 + + + + + +CacheDirLength +하위디렉토리명의 문자개수 +CacheDirLength length +CacheDirLength 2 +server configvirtual host + + + +

CacheDirLength 지시어는 캐쉬 + 계층구조에서 각 하위디렉토리명의 문자수를 지정한다.

+ + +

CacheDirLevels와 + CacheDirLength를 곱하여 20 보다 + 크면 안된다.

+ + + + CacheDirLength 4 + + + + + +CacheExpiryCheck +캐쉬에서 파일을 찾을때 만기시간을 고려할지 여부 +CacheExpiryCheck On|Off +CacheExpiryCheck On +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheExpiryCheck Off
+ + + + CacheExpiryCheck 지시어는 현재 + 구현되지 않았다. + + + + + +CacheMinFileSize +캐쉬에 저장할 문서의 최소크기 (바이트 단위) +CacheMinFileSize bytes +CacheMinFileSize 1 +server configvirtual host + + + +

CacheMinFileSize 지시어는 캐쉬에 + 저장할 문서의 최소크기를 바이트 단위로 지정한다.

+ + + CacheMinFileSize 64 + + + + + +CacheMaxFileSize +캐쉬에 저장할 문서의 최대크기 (바이트 단위) +CacheMaxFileSize bytes +CacheMaxFileSize 1000000 +server configvirtual host + + + +

CacheMaxFileSize 지시어는 캐쉬에 + 저장할 문서의 최대크기를 바이트 단위로 지정한다.

+ + + CacheMaxFileSize 64000 + + + + + +CacheTimeMargin +문서를 캐쉬할 최소시간 한계 +CacheTimeMargin ? +CacheTimeMargin ? +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheTimeMargin X + + + + CacheTimeMargin 지시어는 현재 + 구현되지 않았다. + + + + + +CacheGcDaily +매일 가비지컬랙터를 실행할 반복 시간 (24시 시계) +CacheGcDaily time +CacheGcDaily ? +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheGcDaily 23:59 + + + + CacheGcDaily 지시어는 현재 구현되지 + 않았다. + + + + + +CacheGcUnused +URL에 해당하는 참조되지않은 캐쉬파일을 유지할 기간. +CacheGcUnused hours url-string +CacheGcUnused ? +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheGcUnused 12 /local_images + + + + CacheGcUnused 지시어는 현재 구현되지 + 않았다. + + + + + +CacheGcClean +URL에 해당하는 변하지않은 캐쉬파일을 유지할 시간 +CacheGcClean hours url-string +CacheGcClean ? +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheGcClean 12 /daily_scripts + + + + CacheGcClean 지시어는 현재 구현되지 + 않았다. + + + + + +CacheGcMemUsage +가비지컬랙터가 사용할 최대 메모리량 (kilobyte 단위) +CacheGcMemUsage KBytes +CacheGcMemUsage ? +server configvirtual host + + + +

함수가 구현되면 더 자세한 내용이 여기 나온다.

+ + + CacheGcMemUsage 16 + + + + CacheGcMemUsage 지시어는 현재 + 구현되지 않았다. + + + + + diff --git a/docs/manual/mod/mod_echo.xml.ko b/docs/manual/mod/mod_echo.xml.ko new file mode 100644 index 0000000000..cd4a46623c --- /dev/null +++ b/docs/manual/mod/mod_echo.xml.ko @@ -0,0 +1,40 @@ + + + + + + +mod_echo +프로토콜 모듈을 설명하기위한 간단한 echo 서버 +Experimental +mod_echo.c +echo_module +Apache 2.0 이후부터 + + +

이 모듈은 프로토콜 모듈의 개념을 설명하기위한 예제이다. + 이 모듈은 간단한 echo 서버를 구현한다. 이 서버로 telnet하여 + 무언가를 입력하면, 서버는 입력한 내용이 그대로 반환한다.

+ + + + +ProtocolEcho +echo 서버를 키고 끈다 +ProtocolEcho On|Off +server config +virtual host +ProtocolEcho는 2.0 이후에만 있다. + + +

ProtocolEcho 지시어는 echo 서버를 + 키고 끈다.

+ + 예제 + ProtocolEcho On + + + + + + diff --git a/docs/manual/mod/mod_env.xml.ko b/docs/manual/mod/mod_env.xml.ko new file mode 100644 index 0000000000..731355f8cd --- /dev/null +++ b/docs/manual/mod/mod_env.xml.ko @@ -0,0 +1,75 @@ + + + + + + +mod_env +CGI 스크립트나 SSI 페이지에 전달할 환경변수를 +수정한다 +Base +mod_env.c +env_module + +

이 모듈은 CGI 스크립트나 SSI 페이지에 전달할 환경변수를 + 조절한다. 웹서버를 시작한 쉘에서 환경변수를 가져올 수 있다. + 아니면 설정과정중에 환경변수를 설정하고 제거할 수 있다.

+ +환경변수 + + +PassEnv +쉘에서 환경변수를 가져온다 +PassEnv env-variable [env-variable] +... +server configvirtual host +directory.htaccess +FileInfo + + +

웹서버를 실행한 쉘의 특정 환경변수를 CGI 스크립트나 + SSI 페이지로 전달한다.

+ + 예제 + PassEnv LD_LIBRARY_PATH + + + + + +SetEnv +환경변수를 설정한다 +SetEnv env-variable value +server configvirtual host +directory.htaccess +FileInfo + + +

CGI 스크립트나 SSI 페이지에 전달할 환경변수를 설정한다.

+ + 예제 + SetEnv SPECIAL_PATH /foo/bin + + + + + +UnsetEnv +환경변수를 제거한다 +UnsetEnv env-variable [env-variable] +... +server configvirtual host +directory.htaccess +FileInfo + + +

CGI 스크립트나 SSI 페이지에 환경변수를 전달하지 않는다.

+ + 예제 + UnsetEnv LD_LIBRARY_PATH + + + + + +