1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
|
<?xml version="1.0" encoding="EUC-KR"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>아파치 투토리얼: .htaccess 파일 - Apache HTTP Server</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/howto/htaccess.html" rel="canonical" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p>
<p class="apache">Apache HTTP Server Version 2.0</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
<p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
<ul><li><a href="http://httpd.apache.org/docs/current/">Current release version of Apache HTTP Server documentation</a></li></ul><p>You may follow <a href="http://httpd.apache.org/docs/current/howto/htaccess.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>아파치 투토리얼: .htaccess 파일</h1>
<div class="toplang">
<p><span>가능한 언어: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" title="Korean"> ko </a></p>
</div>
<div class="outofdate">이 문서는 최신판 번역이 아닙니다.
최근에 변경된 내용은 영어 문서를 참고하세요.</div>
<p><code>.htaccess</code> 파일을 사용하여 디렉토리별로 설정을
변경할 수 있다.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess 파일</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">무엇이며/어떻게 사용하는가</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">언제 .htaccess 파일을 사용하나
(혹은 사용하지 않나)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">어떻게 지시어를 적용하나</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">인증 예제</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Server Side Includes 예제</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI 예제</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">문제해결</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="related" id="related">.htaccess 파일</a></h2>
<table class="related"><tr><th>관련된 모듈</th><th>관련된 지시어</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_auth.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_auth.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">무엇이며/어떻게 사용하는가</a></h2>
<p><code>.htaccess</code> 파일(혹은 "분산 설정파일")을
사용하면 디렉토리별로 설정을 변경할 수 있다. 여러 설정 지시어가
있는 파일을 특정 문서 디렉토리에 두면, 그 디렉토리와 모든
하위디렉토리에 지시어를 적용한다.</p>
<div class="note"><h3>주의:</h3>
<p><code>.htaccess</code> 파일명을 다르게 사용하고 싶다면,
<code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> 지시어를
사용하여 변경할 수 있다. 예를 들어, <code>.config</code>
파일명을 사용하려면 서버 설정파일에 다음과 같이 추가한다.</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>일반적으로 <code>.htaccess</code> 파일은 <a href="../configuring.html#syntax">주설정파일</a>과 문법이
같다. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
지시어가 이 파일에 나올 수 있는 내용을 결정한다. 이 지시어는
<code>.htaccess</code> 파일에서 허용하는 지시어 분류를 지정한다.
지시어를 <code>.htaccess</code> 파일에서 사용할 수 있다면,
해당 지시어 문서의 Override 항목은 지시어를 허용하기위해
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>에 사용할
값을 알려준다.</p>
<p>예를 들어, <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>
지시어 문서를 보면 이 지시어를 <code>.htaccess</code> 파일에서
사용할 수 있다. (지시어 요약에서 사용장소 항목을 보라.)
<a href="../mod/directive-dict.html#Context">Override</a>
줄에 <code>FileInfo</code>가 있다. 그래서 이 지시어를
<code>.htaccess</code> 파일에서 사용하기위해서는 최소한
<code>AllowOverride FileInfo</code>가 필요하다.</p>
<div class="example"><h3>예제:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">사용장소:</a></td>
<td>주서버설정, 가상호스트, directory, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>특정 지시어를 <code>.htaccess</code> 파일에서 사용할
수 있는지 궁금하면 지시어 문서의 사용장소 항목에 ".htaccess"가
있는지 확인한다.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">언제 .htaccess 파일을 사용하나
(혹은 사용하지 않나)</a></h2>
<p>일반적으로 주서버파일에 접근할 수 없는 경우가 아니라면
<code>.htaccess</code> 파일을 사용하면 안된다. 예를 들어,
사용자 인증이 항상 <code>.htaccess</code> 파일에 있어야
한다는 것은 잘못 알려진 오해다. 이는 사실이 아니다. 주서버설정에
사용자 인증 설정을 적을 수 있고, 사실 이러길 권한다.</p>
<p><code>.htaccess</code> 파일은 컨텐츠 제공자가 디렉토리별로
서버 설정을 다르게하고 싶지만 서버 시스템에 root 권한이
없는 경우에 사용한다. 서버 관리자가 설정을 자주 변경하고
싶지 않은 경우 일반 사용자가 직접 <code>.htaccess</code>
파일을 수정하도록 허용하는 것이 바람직하다. 예를 들어, 한
컴퓨터에 여러 사용자 사이트를 서비스하는 ISP에서 사용자가
자신의 설정을 변경하고 싶은 경우가 그러하다.</p>
<p>그러나 일반적으로 <code>.htaccess</code> 파일은 가급적
피해야 한다. <code>.htaccess</code> 파일에서 허용하는 지시어는
주설정파일의 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 섹션과 같은 효과가
있다.</p>
<p>다음 두가지 큰 이유때문에 <code>.htaccess</code> 파일
사용을 피해야 한다.</p>
<p>첫번째는 성능이다. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>가 <code>.htaccess</code>
파일을 사용하도록 허용하면, 아파치는 디렉토리마다
<code>.htaccess</code> 파일을 찾는다. 그래서
<code>.htaccess</code> 파일을 허용하면 실제로 파일을 사용하지
않는 경우에도 성능이 떨어진다! 또, <code>.htaccess</code>
파일은 문서를 요청할때마다 읽어들인다.</p>
<p>게다가 적용해야 하는 전체 지시어를 모으기위해 아파치는
모든 상위 디렉토리에서 <code>.htaccess</code> 파일을 찾는다.
(<a href="#how">어떻게 지시어를 적용하나</a> 절을 참고.)
그래서 <code>/www/htdocs/example</code> 디렉토리에 있는
파일을 요청하면, 아파치는 다음 파일들을 찾아야 한다.</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>그래서 그 디렉토리에 있는 파일을 접근할 때마다 설정파일이
전혀 없어도 파일시스템을 4번 더 접근해야 한다.
(<code>/</code>에서도 <code>.htaccess</code> 파일을 허용한
경우를 말한다. 보통은 허용하지 않는다.)</p>
<p>두번째 이유는 보안이다. 사용자에게 서버설정 변경 권한을
주면 당신이 감당할 수 없는 변화가 일어날 수 있다. 사용자에게
이런 권한을 줄지 곰곰이 생각하라. 또, 사용자가 원하는 것보다
적은 권한을 주면 기술지원요청이 들어온다. 사용자에게 가능한
권한 수준을 명확히 알려라. 사용자에게 <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>를 어떻게 설정하였는지
정확히 알리고 관련 문서를 제공하면 앞으로 혼란을 피할 수
있다.</p>
<p>지시어를 <code>/www/htdocs/example</code> 디렉토리의
<code>.htaccess</code> 파일을 두는 것과 주서버설정의
<code><Directory /www/htdocs/example></code> Directory
설정에 두는 것은 완전히 같다.</p>
<p><code>/www/htdocs/example</code>에 있는
<code>.htaccess</code> 섹션:</p>
<div class="example"><h3><code>/www/htdocs/example</code>에 있는
.htaccess 파일 내용</h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3><code>httpd.conf</code> 파일에 있는 섹션</h3><p><code>
<Directory /www/htdocs/example><br />
<span class="indent">
AddType text/example .exm<br />
</span>
</Directory>
</code></p></div>
<p>그러나 파일을 요청할 때마다 설정을 읽지않고 아파치가
시작할때 한번만 설정을 읽기때문에 같은 설정을 서버설정파일에
사용하면 성능이 더 빠르다.</p>
<p><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> 지시어를
<code>none</code>으로 설정하면 <code>.htaccess</code> 파일을
완전히 사용할 수 없다.</p>
<div class="example"><p><code>
AllowOverride None
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how" id="how">어떻게 지시어를 적용하나</a></h2>
<p><code>.htaccess</code> 파일을 발견한 디렉토리와 그 디렉토리의
모든 하위디렉토리에 <code>.htaccess</code> 파일에 있는 설정
지시어를 적용한다. 그래서 상위디렉토리의 <code>.htaccess</code>
파일을 주의해야 한다. 발견한 순서로 지시어를 적용한다. 특정
디렉토리에 있는 <code>.htaccess</code> 파일은 상위디렉토리에
있는 <code>.htaccess</code> 파일의 지시어를 무효로 만들
수 있고, 상위디렉토리에 있는 지시어는 더 상위디렉토리 혹은
주설정파일에 있는 지시어를 무효로 만들 수 있다.</p>
<p>예제:</p>
<p><code>/www/htdocs/example1</code> 디렉토리에 다음과 같은
<code>.htaccess</code> 파일이 있다.</p>
<div class="example"><p><code>
Options +ExecCGI
</code></p></div>
<p>(주의: <code>.htaccess</code> 파일에 "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" 지시어를 사용하려면
"<code>AllowOverride Options</code>"가 필요하다.)</p>
<p><code>/www/htdocs/example1/example2</code> 디렉토리에는
다음과 같은 <code>.htaccess</code> 파일이 있다.</p>
<div class="example"><p><code>
Options Includes
</code></p></div>
<p>이 두번째 <code>.htaccess</code> 파일의
<code>Options Includes</code>가 이전 설정을 완전히 무효로
만들기때문에 <code>/www/htdocs/example1/example2</code>
디렉토리는 CGI 실행을 허용하지 않는다.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">인증 예제</a></h2>
<p>인증 방법을 알기위해 바로 이곳부터 읽는다면 주의할 것이
있다. 암호 인증을 하려면 <code>.htaccess</code> 파일이
필요하다는 오해가 널리 퍼져있다. 이는 사실이 아니다.
주설정파일의 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 섹션에 인증 지시어를
두는 것이 더 권장하는 방법이고, 서버의 주설정파일을 수정할
수 없는 경우에만 <code>.htaccess</code> 파일을 사용해야
한다. 언제 <code>.htaccess</code> 파일을 사용해야 하는지와
사용하지 말아야 하는지는 <a href="#when">위에서</a>
설명하였다.</p>
<p>앞에서 말했지만 아직도 <code>.htaccess</code> 파일이
필요하다고 생각되면 아래 설정이 도움이 될 것이다.</p>
<p>이 지시어가 동작하려면 "<code>AllowOverride AuthConfig</code>"가
있어야 한다.</p>
<p><code>.htaccess</code> 파일 내용.</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Password Required"<br />
AuthUserFile /www/passwords/password.file<br />
AuthGroupFile /www/passwords/group.file<br />
Require Group admins
</code></p></div>
<p>이 지시어가 동작하기위해서는
<code>AllowOverride AuthConfig</code> 지시어가 필요함을
명심하라.</p>
<p>인증과 권한부여에 대한 자세한 설명은 <a href="auth.html">인증
투토리얼</a>을 보길 바란다.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Server Side Includes 예제</a></h2>
<p>또다른 일반적인 <code>.htaccess</code> 파일의 용도는
특정 디렉토리에서 Server Side Includes를 가능하게 만드는
것이다. 원하는 디렉토리의 <code>.htaccess</code> 파일에
다음과 같은 설정 지시어를 사용하면 된다.</p>
<div class="example"><p><code>
Options +Includes<br />
AddType text/html shtml<br />
AddHandler server-parsed shtml
</code></p></div>
<p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와
<code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p>
<p>server-side includes에 대한 자세한 설명은 <a href="ssi.html">SSI 투토리얼</a>을 보길 바란다.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">CGI 예제</a></h2>
<p>마지막으로 <code>.htaccess</code> 파일을 사용하여 특정
디렉토리에서 CGI 프로그램 실행을 허용하고 싶다면, 다음과
같은 설정을 사용한다.</p>
<div class="example"><p><code>
Options +ExecCGI<br />
AddHandler cgi-script cgi pl
</code></p></div>
<p>혹은 이 디렉토리에 있는 모든 파일을 CGI 프로그램으로
처리하고 싶다면 다음과 같은 설정도 가능하다.</p>
<div class="example"><p><code>
Options +ExecCGI<br />
SetHandler cgi-script
</code></p></div>
<p>이 지시어가 동작하려면 <code>AllowOverride Options</code>와
<code>AllowOverride FileInfo</code>가 모두 필요함을 명심하라.</p>
<p>CGI 프로그래밍과 설정에 대한 자세한 설명은 <a href="cgi.html">CGI 투토리얼</a>을 보길 바란다.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">문제해결</a></h2>
<p><code>.htaccess</code> 파일에 둔 설정 지시어가 원하는
기능을 하지 않는 경우 여러가지 이유가 있을 수 있다.</p>
<p>가장 일반적인 문제는 설정 지시어를 가능하게 만드는 <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>를 설정하지 않은
경우다. 문제가 되는 파일 영역에 <code>AllowOverride None</code>이
없는지 확인한다. <code>.htaccess</code> 파일을 아무렇게나
적은 다음 페이지를 다시 접근하여 쉽게 검사해볼 수 있다.
서버 오류가 나오지 않으면 거의 확실히
<code>AllowOverride None</code>을 사용한 경우다.</p>
<p>반대로 문서에 접근할때 서버 오류가 발생하면 아파치 오류로그를
살펴봐라. 아마도 <code>.htaccess</code> 파일에 있는 지시어를
허용하지 않는다고 할 것이다. 아니고 문법 오류가 있다면 오류를
고친다.</p>
</div></div>
<div class="bottomlang">
<p><span>가능한 언어: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div>
</body></html>
|
