Debian 13 강좌 / Nginx 사이트 구성과 403·404·파일 권한 확인
Debian 13의 Nginx 사이트는 sites-available에 설정을 보관하고 sites-enabled의 심볼릭 링크로 활성화할 수 있습니다. 설정 검사 후 reload로 적용하고, 포트·Host 값·파일 권한·실제 HTTP 응답을 각각 확인해야 합니다. 이 강좌는 기본 사이트를 보존하면서 127.0.0.1:8080에 정적 사이트를 추가하고 200·403·404의 원인을 비교합니다.
실습 범위와 설치 전 확인
Nginx는 HTTP 요청을 받아 파일을 제공하거나 다른 애플리케이션으로 요청을 전달하는 웹 서버입니다. 여기서는 HTML 파일을 직접 제공하는 정적 사이트만 구성합니다. sudo 가능한 Debian 13 일반 사용자와 curl이 필요하며, 모든 HTTP 확인은 Debian VM 안에서 실행합니다. NAT의 호스트 PC에서 접속하려면 별도의 포트 전달이 필요하지만 이 실습은 외부 공개를 하지 않습니다.
패키지 설치 과정에서 기본 사이트가 시작될 수 있습니다. 실제 운영 서버라면 기존 웹 서버와 80·443 포트 충돌을 먼저 조사하고 유지보수 절차를 정합니다. 아래 명령의 출력에 기존 서비스가 보이면 해당 서비스를 임의로 중지하지 않습니다.
ss -ltn
dpkg-query -W nginx nginx-common 2>/dev/null
apt-cache policy nginx
설치되지 않은 패키지의 dpkg-query는 0이 아닌 상태를 반환할 수 있습니다. 그것만으로 시스템 오류는 아닙니다. 실습 VM에서는 Nginx가 없었고 SSH의 22번 포트만 열려 있었습니다. Debian 저장소에서 다음과 같이 설치했습니다.
sudo apt update
sudo apt install nginx curl
nginx -v
systemctl is-active nginx
systemctl is-enabled nginx
sudo nginx -t
이 VM에 설치된 nginx와 nginx-common은 1.26.3-3+deb13u10이었으며 서비스는 active·enabled였습니다. 배포 시점과 보안 업데이트에 따라 패키지 수정 번호는 달라질 수 있습니다. 시작하지 못하면 systemctl status nginx --no-pager와 sudo journalctl -u nginx -n 50 --no-pager에서 바인딩 실패 등 실제 원인을 확인합니다.
Debian의 설정 포함 경로와 백업
sites-available은 설정을 보관하는 디렉터리이고 그 안의 파일이 전부 자동 적용되는 것은 아닙니다. 실습 패키지의 /etc/nginx/nginx.conf는 http 문맥 안에서 /etc/nginx/conf.d/*.conf와 /etc/nginx/sites-enabled/*를 포함했습니다. 이 규칙을 직접 확인한 뒤 진행합니다.
grep -nE 'user |include .*(conf.d|sites-enabled)' /etc/nginx/nginx.conf
ls -l /etc/nginx/sites-enabled
sudo nginx -T | less
nginx -T는 검사와 함께 포함된 설정 전체를 출력합니다. 인증 정보나 내부 주소가 들어 있을 수 있으므로 출력을 그대로 공개하지 않습니다. less에서는 q로 나옵니다. 이 VM에서는 worker 사용자가 www-data였으며 기본 사이트 링크를 유지했습니다.
다음은 실습 경로가 없는지 확인하고 원본을 보관하는 준비 블록입니다. 같은 Bash 터미널에서 실행합니다. 이미 경로가 있으면 삭제하거나 덮어쓰지 않고 중단합니다. 독자가 준비한 운영 설정의 백업에는 모든 관련 include 파일과 인증서도 포함해야 합니다.
set -euo pipefail
for p in /srv/lf-web25 /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25 /var/backups/lf-debian13-25; do
if test -e "$p" || test -L "$p"; then
echo "이미 존재하는 경로입니다: $p" >&2
exit 1
fi
done
sudo install -d -m 700 /var/backups/lf-debian13-25
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/sites-available/default /var/backups/lf-debian13-25/
sudo sha256sum /etc/nginx/nginx.conf /etc/nginx/sites-available/default | sudo tee /var/backups/lf-debian13-25/original.sha256
정적 파일과 가상 호스트 만들기
실습 사이트 파일은 /srv/lf-web25/public에 둡니다. 관리자가 파일을 소유하고 Nginx worker는 읽기만 가능하게 합니다. 디렉터리는 경로를 통과할 실행 권한이 필요하고 파일은 읽기 권한이 필요합니다. 공개용 정적 파일에만 적용하는 예제이며 비밀번호나 비공개 자료를 이 경로에 넣지 않습니다.
sudo install -d -m 755 /srv/lf-web25/public /srv/lf-web25/public/empty
printf '%s
' '<!doctype html><html lang="en"><meta charset="utf-8"><title>Lab 25</title><h1>LF WEB 25</h1></html>' | sudo tee /srv/lf-web25/public/index.html
sudo chmod 644 /srv/lf-web25/public/index.html
다음 블록 전체를 설정 파일에 씁니다. 인용한 heredoc 종료자 CONF는 $uri를 셸 변수가 아니라 Nginx 변수로 보존합니다. Nginx 구문은 공통 하이라이터에서 별도 지원하지 않으므로 일반 텍스트로 보여 줍니다.
sudo tee /etc/nginx/sites-available/lf-web25 > /dev/null <<'CONF'
server {
listen 127.0.0.1:8080 default_server;
server_name _;
return 404;
}
server {
listen 127.0.0.1:8080;
server_name lab25.test;
root /srv/lf-web25/public;
index index.html;
access_log /var/log/nginx/lf-web25-access.log;
error_log /var/log/nginx/lf-web25-error.log;
location / {
try_files $uri $uri/ =404;
}
}
CONF
| 설정 | 이 실습의 역할 |
|---|---|
| listen 127.0.0.1:8080 | VM 자신의 loopback에서만 받습니다. 인터넷에서 직접 연결할 수 없습니다. |
| default_server | 그 주소·포트에서 이름이 맞지 않는 요청의 기본 서버를 지정합니다. |
| server_name lab25.test | 일치하는 Host 요청을 실제 사이트로 보냅니다. DNS 레코드를 만들지는 않습니다. |
| root와 index | 요청 URI를 찾을 파일 경로와 디렉터리의 기본 파일을 정합니다. |
| try_files $uri $uri/ =404 | 파일·디렉터리를 확인하고 찾지 못하면 404를 반환합니다. |
server_name _ 자체가 모든 이름을 잡는 특별한 와일드카드는 아닙니다. 여기서는 default_server가 기본 선택을 결정합니다. 동일 주소·포트에서 이를 중복 지정하면 오류가 날 수 있으므로 기존 설정을 확인합니다. Nginx의 요청 처리 문서는 주소·포트를 먼저 고른 뒤 Host 이름과 기본 서버를 판단하는 순서를 설명합니다.
설정 파일을 연결하고 검사한 뒤 적용합니다. 이 블록은 앞의 set -euo pipefail과 같은 터미널에서 실행하거나, 검사와 reload를 다음처럼 &&로 묶어 검사 실패 시 적용을 막습니다.
sudo ln -s /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
systemctl is-active nginx
ss -ltn | grep '127.0.0.1:8080'
reload는 설정을 다시 읽게 하지만 설정 파일을 저장하는 행위 자체는 실행 중 프로세스에 적용되지 않습니다. 검사를 통과해도 worker의 실제 파일 읽기 권한이나 원하는 Host 응답까지 보장하지 않으므로 HTTP 확인을 이어갑니다. nginx -t와 -T 옵션의 범위는 Debian nginx 명령 설명서에서 확인할 수 있습니다.
Host별 응답과 DNS를 구분하기
다음 명령은 프록시 환경 변수 영향을 배제하기 위해 --noproxy를 사용합니다. 첫 요청은 실제 사이트, 두 번째는 이름이 맞지 않는 기본 서버, 세 번째는 없는 파일, 네 번째는 인덱스가 없는 디렉터리입니다.
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: other.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/missing
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/empty/
| 요청 | 검증한 결과 | 해석 |
|---|---|---|
| lab25.test / | 200, LF WEB 25 | 원하는 사이트와 정적 파일을 선택했습니다. |
| other.test / | 404 | 기본 서버의 명시적 반환값입니다. |
| lab25.test /missing | 404 | 일치하는 사이트에서 대상 파일을 찾지 못했습니다. |
| lab25.test /empty/ | 403 | 디렉터리는 있지만 인덱스가 없고 목록 열람을 허용하지 않았습니다. |
curl은 기본적으로 HTTP 404를 받았다고 프로세스 실패로 처리하지 않습니다. 자동 검증에는 -f 또는 -w로 상태 코드를 확인하는 방식을 선택합니다. 사이트 이름을 URL에 쓰되 공용 DNS를 바꾸지 않고 요청하려면 다음 명령을 사용합니다. --resolve는 이 curl 요청에만 이름·포트·주소 대응을 제공합니다.
curl --noproxy '*' -fsS --resolve lab25.test:8080:127.0.0.1 http://lab25.test:8080/
명령이 성공해도 lab25.test가 인터넷 DNS에 등록된 것은 아닙니다. 외부 서비스를 공개하려면 실제 도메인, 서버까지의 경로, 적절한 listen 주소, 방화벽과 HTTPS가 별도로 필요합니다. 이 실습을 따라 한다고 8080을 외부에 열 필요는 없습니다.
파일 권한 오류와 로그를 대조하기
같은 403이라도 원인이 다를 수 있습니다. 아래는 이 실습에서 직접 만든 root 소유 파일 하나만 600으로 바꿔 worker의 읽기 권한을 없앤 뒤 요청하는 비교입니다. 운영 파일에 적용하지 않습니다. HTTP 상태를 확인한 뒤 즉시 644로 되돌립니다.
sudo chmod 600 /srv/lf-web25/public/index.html
curl --noproxy '*' -sS -o /dev/null -w '%{http_code}
' -H 'Host: lab25.test' http://127.0.0.1:8080/
namei -l /srv/lf-web25/public/index.html
sudo tail -n 10 /var/log/nginx/lf-web25-error.log
sudo chmod 644 /srv/lf-web25/public/index.html
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/
실제 결과는 600일 때 403·Permission denied, 복구 후 200이었습니다. 앞의 /empty/ 요청은 directory index is forbidden이 기록되어 구분됐습니다. namei는 중간 디렉터리까지 권한을 보여 줍니다. 상위 디렉터리에 통과 권한이 없으면 최종 파일이 644여도 읽지 못합니다.
chmod -R 777로 해결하지 않습니다. 경로·소유자·worker 계정·ACL과 필요하면 AppArmor 거부 기록을 확인하고 필요한 권한만 부여합니다. Nginx 설정 검사가 root로 성공해도 www-data worker의 읽기 성공과 같지 않습니다. 접근 로그는 요청과 상태를, error 로그는 거부 이유를 좁히는 데 사용합니다.
적용 실패에 대비하고 전용 사이트 정리하기
설정 변경 전에는 이 사이트의 정상본을 별도로 복사합니다. 검증 과정에서는 알 수 없는 지시어를 추가한 설정이 nginx -t에서 거부되는 동안, reload를 하지 않은 기존 worker는 계속 200을 반환했습니다. 실패한 파일은 정상본으로 복원하고 다시 검사했습니다. 독자는 운영 설정에 오류를 만들 필요 없이 정상본 복사·검사·적용 순서를 습관화하면 됩니다.
sudo cp -a /etc/nginx/sites-available/lf-web25 /var/backups/lf-debian13-25/good-site
sudo nginx -t && sudo systemctl reload nginx
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/
변경한 사이트에 문제가 있으면 방금 저장한 정상본과 현재 파일을 비교하고 해당 사이트 파일만 복원합니다. 공통 설정까지 무작정 덮어쓰지 않습니다. reload의 worker 교체 동작과 실패 시 처리는 Nginx 시작·설정 재적용 안내에서 확인할 수 있습니다.
실습을 끝내려면 링크부터 제거하고 검사·reload로 8080의 전용 서버를 내립니다. 기본 사이트나 Nginx 서비스 전체를 중지하지 않습니다. 아래를 수행하기 전에 로그를 보관하려면 전용 로그 두 개를 백업 폴더에 복사합니다.
sudo cp -a /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log /var/backups/lf-debian13-25/
sudo rm -- /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
ss -ltn
sudo sha256sum -c /var/backups/lf-debian13-25/original.sha256
reload 직후에는 기존 worker가 요청을 마무리할 수 있으므로 잠시 뒤 다시 확인합니다. 127.0.0.1:8080 리스너가 사라지고 원본 해시가 OK인지 확인한 뒤 전용 파일만 정리합니다. 사용 중인 worker가 더 이상 전용 로그를 열고 있지 않은지도 운영 환경에서는 확인합니다.
sudo rm -- /etc/nginx/sites-available/lf-web25 /srv/lf-web25/public/index.html
sudo rmdir /srv/lf-web25/public/empty /srv/lf-web25/public /srv/lf-web25
sudo rm -- /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log
systemctl is-active nginx
최종 검증에서는 전용 리스너와 파일이 제거됐고, nginx.conf와 기본 사이트의 해시는 유지됐으며 Nginx 자체는 active였습니다. 설치한 패키지는 남겼습니다. 패키지 제거는 다른 사이트와 이후 사용 여부를 확인한 뒤 별도로 결정합니다.




