Rocky Linux 10 강좌 / Nginx 사이트 구성과 firewalld·SELinux 연동

Rocky Linux 10에서 Nginx 사이트를 구성하려면 사이트 설정과 문서 디렉터리를 분리하고, Nginx 설정 검사·파일 권한·SELinux 문맥·방화벽을 차례로 확인해야 합니다. 이 강좌에서는 기존 80번 기본 사이트를 유지하면서 18025번 포트에 정적 사이트를 추가하고, 로컬 응답과 다른 컴퓨터에서 들어오는 응답을 비교합니다.

실습 범위와 기존 사이트 확인

Nginx는 요청을 받아 파일을 전달하거나 다른 프로그램으로 요청을 중계하는 웹 서버입니다. 여기서는 파일을 직접 제공하는 정적 사이트만 다룹니다. PHP 실행, 역방향 프록시와 HTTPS 인증서는 별도 구성이 필요합니다.

실습은 sudo 권한이 있는 사용자와 콘솔 접근이 준비된 별도 Rocky Linux 10 가상 머신(VM)에서 진행하세요. 확인 환경은 Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux Enforcing입니다. 이 환경에서는 Apache가 중지되어 있었고 기존 웹 포트 리스너가 없었습니다. 이미 운영 중인 서비스가 있다면 설치·시작 전에 포트와 설정을 먼저 조사해야 합니다.

cat /etc/rocky-release
sudo ss -lntp
systemctl is-active nginx httpd
sudo firewall-cmd --get-active-zones
getenforce
sudo dnf install nginx policycoreutils-python-utils
rpm -q nginx
sudo nginx -t

is-active에서 설치되지 않았거나 중지된 서비스가 나오면 종료 코드가 0이 아닐 수 있습니다. 상태 확인 결과를 읽어 판단하세요. 이미 Apache가 80번을 사용 중이라면 Nginx 기본 설정과 충돌하므로 그대로 시작하지 않습니다.

Rocky 패키지의 /etc/nginx/nginx.conf에는 http 구역 안에 include /etc/nginx/conf.d/*.conf;가 들어 있었습니다. Debian·Ubuntu의 sites-available 구조를 그대로 전제하지 말고 실제 패키지 설정을 확인합니다. sudo nginx -T는 적용할 전체 설정을 출력하지만 설정에 비밀값이 있다면 외부에 공유하지 마세요.

sudo test ! -e /root/lf-course25-before
sudo install -d -m 0700 /root/lf-course25-before
sudo cp -a /etc/nginx /root/lf-course25-before/nginx
sudo nginx -t && sudo systemctl start nginx
curl -sS -o /tmp/lf25-default-before.html -w 'HTTP %{http_code}\n' http://127.0.0.1/

첫 번째 검사에서 이미 백업 디렉터리가 있다고 나오면 멈추고 이전 실습 상태를 확인하세요. 위 명령은 빈 포트의 새 실습 환경을 기준으로 합니다. 이 환경의 기본 사이트는 HTTP 200을 반환했습니다. 기본 설정 파일을 통째로 교체하지 않고 별도 파일 하나를 추가하겠습니다.

문서 디렉터리와 사이트 설정 작성

이번 실습에서 사용할 이름은 course25.test, 문서 디렉터리는 /srv/lf-web25입니다. .test는 시험용 이름이며 이 이름을 server_name에 적는다고 도메인 이름을 IP 주소에 연결하는 DNS 레코드가 만들어지지는 않습니다. 우선 curl의 Host 헤더로 사이트 이름을 지정해 시험합니다.

sudo test ! -e /srv/lf-web25
sudo test ! -e /etc/nginx/conf.d/lf-course25.conf
sudo ss -lntp 'sport = :18025'
sudo install -d -m 0755 /srv/lf-web25
printf 'LF25 nginx site works\n' | sudo tee /srv/lf-web25/index.html > /dev/null
sudo chmod 0644 /srv/lf-web25/index.html
sudo tee /etc/nginx/conf.d/lf-course25.conf > /dev/null <<'EOF'
server {
    listen 18025;
    server_name course25.test;
    root /srv/lf-web25;
    index index.html;
    access_log /var/log/nginx/lf-course25-access.log;
    error_log /var/log/nginx/lf-course25-error.log;
    location / {
        try_files $uri $uri/ =404;
    }
}
EOF

기존 경로가 있거나 18025번을 다른 프로그램이 사용하고 있다면 이 예제를 그대로 덮어쓰지 마세요. 디렉터리 0755는 경로를 통과할 권한과 목록 읽기를, 파일 0644는 내용 읽기를 제공합니다. Nginx가 읽기만 하는 정적 파일의 소유자를 웹 서버 계정으로 바꾸거나 0777로 열 필요는 없습니다. 상위 경로에도 통과 권한이 있어야 합니다.

설정 역할과 확인할 점
listen 18025 요청을 받을 TCP 포트입니다. IPv4 주소를 특정하지 않았으므로 이 실습에서는 외부 인터페이스에서도 수신합니다. 외부 공개 범위는 방화벽과 VM 네트워크로 제한합니다.
server_name 같은 주소·포트로 들어온 요청의 이름에 맞는 server 구역을 고르는 조건입니다. DNS 등록이나 접근 인증 기능은 아닙니다.
root와 index 파일 기준 경로와 디렉터리 요청의 기본 문서를 정합니다. 여기서 / 요청은 index.html로 처리됩니다.
try_files 요청 URI에 맞는 파일이나 디렉터리를 찾고, 없으면 404를 반환합니다. $uri는 셸 변수가 아니라 Nginx 변수이므로 따옴표가 있는 heredoc으로 그대로 저장합니다.
사이트별 로그 다른 사이트 요청과 섞이지 않도록 접근·오류 로그 파일을 구분합니다.

Nginx의 공식 입문 문서는 설정 구역과 정적 파일 제공 방식을 설명합니다. try_files 지시어 문서에서 파일 탐색과 마지막 처리의 의미를 확인할 수 있습니다.

SELinux 경로 문맥과 포트 허용

일반 파일 권한이 맞아도 SELinux가 접근을 허용해야 합니다. SELinux는 프로세스와 파일 등에 붙은 보안 문맥을 정책과 비교합니다. 이 환경의 Nginx 프로세스는 httpd_t 도메인에서 실행되었으며, 새 /srv 문서는 처음에 var_t였습니다.

ls -Zd /srv/lf-web25 /srv/lf-web25/index.html
sudo semanage fcontext -l -C
sudo semanage port -l | grep http_port_t
sudo semanage fcontext -a -t httpd_sys_content_t '/srv/lf-web25(/.*)?'
sudo restorecon -Rv /srv/lf-web25
sudo semanage port -a -t http_port_t -p tcp 18025
sudo nginx -t && sudo systemctl reload nginx
sudo ss -lntp 'sport = :18025'

semanage fcontext는 경로에 적용할 영구 규칙을 등록하고, restorecon은 그 규칙을 실제 파일에 적용합니다. 규칙만 등록했다고 기존 파일의 문맥이 즉시 바뀌는 것은 아닙니다. httpd_sys_content_t는 이 정적 사이트에서 읽을 문서에 사용하며 업로드 등 쓰기 권한이 필요한 경로와 구분합니다. 자세한 원리는 Rocky Linux SELinux 문서를 참고하세요.

18025번은 실습 시작 시 기존 HTTP 허용 포트에 없었기 때문에 새로 등록했습니다. 이미 다른 유형에 등록된 포트라면 오류를 보고 무조건 -m으로 바꾸지 마세요. 기존 서비스를 확인한 뒤 빈 포트를 선택하거나 필요한 범위의 정책을 검토해야 합니다. SELinux의 포트 허용은 firewalld에서 네트워크 패킷을 허용하는 작업과 별개입니다.

실제 비교에서는 포트만 먼저 허용한 상태에서 문서가 var_t일 때 HTTP 403이 발생했고, 감사 로그에는 httpd_t가 var_t 파일을 조회하지 못한 AVC(접근 벡터 캐시) 거부 기록이 남았습니다. 경로 규칙과 restorecon 적용 뒤 200으로 바뀌었습니다. SELinux를 끄거나 전체 서비스를 permissive로 바꾸지 않았습니다.

로컬 응답과 다른 컴퓨터의 응답 비교

curl -sS -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/
curl -sS -o /dev/null -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/missing

첫 요청은 LF25 nginx site works와 200, 없는 경로는 404가 예상 결과입니다. 200이라는 숫자만 보지 말고 기대한 사이트의 본문인지도 확인하세요. 로컬 성공은 Nginx와 문서 접근이 가능하다는 증거이며, 외부 네트워크 경로까지 성공했다는 뜻은 아닙니다.

외부 인터페이스가 속한 zone을 확인한 뒤 그 zone의 실습 포트만 허용합니다. 아래 public은 이 VM에서 확인한 값이므로 다른 환경에서는 실제 값으로 바꾸세요. 기존 SSH 허용 규칙은 건드리지 않습니다.

sudo firewall-cmd --get-active-zones
sudo firewall-cmd --zone=public --add-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

같은 네트워크의 다른 컴퓨터에서는 실제 서버 IPv4 주소를 넣어 요청합니다. 다음 IP는 예시이므로 그대로 사용하지 마세요. Windows에서는 PowerShell 별칭과 구별하기 위해 curl.exe를 사용할 수 있습니다.

curl --max-time 5 -sS -H 'Host: course25.test' http://192.0.2.10:18025/

VirtualBox의 NAT(네트워크 주소 변환) 환경은 게스트 주소에 호스트에서 바로 접근하는 구조가 아닙니다. VM 설정의 네트워크 → 어댑터 1 → 고급 → 포트 포워딩에서 TCP, 호스트 IP 127.0.0.1, 호스트 포트 18025, 게스트 포트 18025인 실습 규칙을 추가하면 호스트에서 http://127.0.0.1:18025/로 확인할 수 있습니다. 호스트 IP를 비우면 노출 범위가 넓어질 수 있으므로 로컬 실습에서는 명시합니다. 게스트 방화벽 허용도 여전히 필요합니다.

이 실습은 Windows의 curl에서 로컬호스트 NAT 포워딩을 거쳐 VM으로 요청했습니다. 방화벽 허용 전에는 4초 동안 응답 없이 시간 초과했고, 런타임 포트 허용 후에는 같은 본문과 200을 확인했습니다. 인터넷 공개 접근이나 실제 DNS 질의 성공을 시험한 결과는 아닙니다.

sudo firewall-cmd --permanent --zone=public --add-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --query-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

두 조회 모두 yes여야 현재 설정과 저장 설정에 반영된 것입니다. 현재 허용과 영구 허용을 각각 추가하므로 이를 위해 전체 방화벽을 reload할 필요는 없습니다. 이 단계에서는 재부팅 유지 시험까지 수행하지 않았습니다. 두 설정의 구분은 firewalld 공식 포트 허용 문서에도 설명되어 있습니다. 표준 HTTP의 http 서비스 정의는 일반적으로 80번을 뜻하므로 이번 비표준 포트 허용과 혼동하지 마세요.

403·404·설정 오류를 구분해서 진단

연결 자체가 거부되거나 시간 초과하면 먼저 리스너, 주소와 VM 네트워크, 실제 zone을 확인합니다. HTTP 응답이 도착했다면 그 요청을 처리한 사이트와 로그를 확인합니다. 403만으로 SELinux 문제라고 단정하지 않습니다.

sudo nginx -t
sudo systemctl status nginx --no-pager
sudo journalctl -u nginx -b -n 30 --no-pager
sudo tail -n 20 /var/log/nginx/lf-course25-access.log
sudo tail -n 20 /var/log/nginx/lf-course25-error.log
namei -l /srv/lf-web25/index.html
ls -Z /srv/lf-web25/index.html
sudo ausearch --input-logs -m AVC -c nginx -ts recent -i

실습에서는 올바른 SELinux 문맥을 유지해도 파일을 root 소유 0600으로 바꾸면 403이었고, 다시 0644로 되돌리면 200이었습니다. 오류 로그의 Permission denied는 일반 권한과 SELinux 양쪽에서 나올 수 있으므로 경로 권한과 같은 시각의 AVC를 함께 봅니다. 아무 로그가 없다는 사실 하나만으로 특정 원인을 확정하지 마세요. 없는 경로의 404는 이번 try_files가 의도한 결과입니다.

설정을 수정한 뒤에는 sudo nginx -t && sudo systemctl reload nginx처럼 검사 성공과 적용을 연결합니다. 실습에서 파일에 존재하지 않는 지시어를 추가하자 설정 검사는 종료 코드 1로 실패했지만, 아직 적용하지 않은 기존 Nginx 프로세스는 같은 PID로 200을 계속 반환했습니다. 잘못된 파일은 즉시 원래 내용으로 돌리고 다시 검사했습니다. 기존 응답이 된다는 이유로 저장된 설정도 정상이라고 판단하면 안 됩니다.

또한 이번 18025번에 server 구역이 하나뿐이어서 Host: another.test로 요청해도 같은 사이트가 200을 반환했습니다. 일치하는 이름이 없으면 해당 주소·포트의 기본 server가 선택될 수 있기 때문입니다. server_name은 접근 제한 장치가 아니며, 알 수 없는 이름을 거부하려면 별도 기본 server와 명시적인 응답 정책을 설계해야 합니다. 이름 선택의 자세한 규칙은 Nginx server names 문서를 참고하세요.

기존 사이트 보존 확인과 실습 되돌리기

새 사이트가 된 뒤에는 원래 80번 기본 사이트도 확인합니다. 처음 저장한 응답과 비교했을 때 본문이 같아야 이번 정적 기본 페이지가 바뀌지 않았다고 판단할 수 있습니다. 실제 운영 사이트의 동적 응답은 시간에 따라 달라질 수 있으므로 핵심 기능·상태·콘텐츠를 별도로 비교해야 합니다.

curl -sS -o /tmp/lf25-default-after.html -w 'HTTP %{http_code}\n' http://127.0.0.1/
cmp /tmp/lf25-default-before.html /tmp/lf25-default-after.html
sudo diff -u /root/lf-course25-before/nginx/nginx.conf /etc/nginx/nginx.conf

실습의 세 차례 요청에서 기본 사이트는 모두 200이었고 응답 본문도 같았습니다. nginx.conf를 비롯한 기존 설정 파일은 유지했습니다. 계속 사용할 서버라면 필요한 사이트만 유지하고, 재부팅 후 자동 시작이 필요할 때 sudo systemctl enable nginx를 선택한 뒤 별도로 재부팅 검증을 하세요.

실습을 제거할 때는 먼저 자신이 추가한 사이트 파일을 백업 위치로 옮기고 검사 후 reload합니다. 다음 명령은 이 강좌에서 새로 만든 파일·규칙에만 적용합니다. 기존에 존재하던 경로·포트 규칙을 재사용했다면 삭제하면 안 됩니다.

sudo mv /etc/nginx/conf.d/lf-course25.conf /root/lf-course25-before/site.conf
sudo nginx -t && sudo systemctl reload nginx
sudo firewall-cmd --zone=public --remove-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --remove-port=18025/tcp
sudo semanage fcontext -d '/srv/lf-web25(/.*)?'
sudo semanage port -d -p tcp 18025
sudo rm -- /srv/lf-web25/index.html
sudo rmdir /srv/lf-web25

설정이 적용된 뒤 18025번 리스너가 사라졌는지 확인하고 VM에 추가한 포트 포워딩 규칙도 삭제합니다. 실습 로그는 필요하면 백업해 두세요. 이 전용 VM에서는 새 로그를 보관하고 사이트 파일·문서·정책·방화벽·NAT 규칙을 정리한 뒤 Nginx를 중지했습니다. 기존 설정과 방화벽은 원래 상태와 비교했고, SSH·firewalld 활성 상태와 SELinux Enforcing을 유지했습니다. Nginx 패키지는 후속 실습을 위해 남겼습니다.