정적 파일 서빙 Path Matching 기법 - root와 alias

Nginx에서 정적 파일을 서빙할 때, 경로 설정에 있어 사용되는 옵션들에 대해서 알아보자.

 

정적 파일 서빙에 있어서, 특정 요청을 특정 파일 경로에 도달하도록 설정하는 것은 중요한 부분이다. 

그리고 이 부분을 결정해주는 것이 Nginx에서는 root 와 alias라는 개념이다.

 

두 옵션 모두 '클라이언트가 요청한 URI를 디스크의 어느 경로에서 찾을지'를 지정하지만,

경로를 조합하는 방식에 있어 차이가 있다. 이 두 옵션의 차이와 설정법에 대해 정리해보겠다.

 

root 옵션 설정

root 옵션은 설정한 경로 뒤에 요청 URI를 그대로 이어 붙여서 최종 파일 경로를 만든다.

 

이를 실습하기 위해서 아래와 같이 conf 파일을 삭제하고 다시 생성하여 접근한다.

 

아래는 conf 파일의 설정 내용이다. 

 

이처럼 conf 파일을 설정한 경우 /images/logo.png 경로로 요청이 오면 

root 경로로 설정한 /var/www/static 경로가 붙고, 요청 경로가 뒤에 붙은 경로로 디스크의 파일에 접근한다. 

따라서 실제 파일 구조가 해당 결과 값에 맞는 형태가 되어야한다. 

(아래의 이미지와 같다.)

 

요청: /images/logo.png
root: /var/www/static
결과: /var/www/static/images/logo.png

 

 

alias 옵션 설정

앞서 root 옵션은 URI와 폴더 구조가 동일하다면, 하나의 경로 옵션을 사용하여 디스크의 파일에 접근할 수 있다.

 

그러나 만약에 URI와 디스크의 폴더 구조가 다르다면, 해당 경로로 찾아갈 수 있도록 설정이 필요하다.

그리고 이에 사용 가능한 옵션이 alias 옵션이다. 

 

alias는 root와 다르게 location에서 매칭된 경로 부분을 제거하고 alias 경로로 대체한다. 

예를 들어, URI와 폴더 구조가 다른 경우 아래와 같은 상황이 있을 수 있다. 

 

요청: /images/logo.png → location /images 제거
alias: /var/www/static/img
결과: /var/www/static/img/logo.png

 

아래는 conf 파일 설정 예시이다.

 

이와 같이 설정한 경우에는 /static/style.css 경로로 URI 요청이 오는 경우,

/var/www/assets/style.css의 경로로 디스크 파일을 조회하게 된다. 

 

 

자주하는 실수

root에서 경로 중복

root는 URI를 그대로 붙이기 때문에, location 경로가 이미 URI에 포함되어 있다는 점을 반드시 기억해야 한다.

# ❌ 잘못된 예시
location /images {
    root /var/www/static/images;
    # 요청: /images/logo.png
    # 결과: /var/www/static/images/images/logo.png ← images가 두 번!
}

# ✅ 올바른 예시
location /images {
    root /var/www/static;
    # 요청: /images/logo.png
    # 결과: /var/www/static/images/logo.png ✅
}

root 경로에 location 경로를 다시 포함시키면 경로가 중복되어 파일을 찾지 못한다.

 

alias 끝 슬래시(/) 처리

# location 끝에 / 없을 때
location /static {
    alias /var/www/assets;   # ✅
}

# location 끝에 / 있으면 alias도 맞춰줘야 함
location /static/ {
    alias /var/www/assets/;  # ✅ 슬래시를 맞춰줘야 경로가 올바르게 조합됨
}

location의 슬래시 유무와 alias의 슬래시 유무를 일치시켜야 경로가 올바르게 조합된다.