Nginx 커스텀 에러 페이지: 사용자 경험 향상하기
Nginx 에러(404, 500 등) 발생 시 커스텀 HTML 페이지를 생성하고 설정하여, 사용자에게 유용한 정보를 제공하고 더욱 세련된 사용자 경험을 만들어 보세요.
웹사이트 운영 중 404(Not Found)나 500(Internal Server Error)과 같은 에러는 피할 수 없는 부분입니다. 하지만 기본 브라우저 에러 페이지를 그대로 노출하는 것은 사용자에게 불친절한 인상을 줄 수 있습니다.
이번 가이드에서는 Nginx에서 커스텀 에러 페이지를 설정하여 브랜드 이미지를 유지하고 사용자 경험을 개선하는 방법을 알아봅니다.
1. 커스텀 에러 페이지 생성
먼저, 사용자에게 보여줄 HTML 파일을 생성합니다. 예를 들어 /var/www/html/errors/404.html 경로에 파일을 만듭니다.
<!DOCTYPE html>
<html>
<head>
<title>페이지를 찾을 수 없습니다</title>
</head>
<body>
<h1>앗! 페이지를 찾을 수 없네요.</h1>
<p>찾으시는 페이지가 이동되었거나 삭제되었을 수 있습니다.</p>
</body>
</html>
2. Nginx 설정 수정
Nginx 설정 파일(보통 /etc/nginx/nginx.conf 또는 해당 사이트의 설정 파일)을 열어 error_page 지시어를 추가합니다.
server {
listen 80;
server_name example.com;
# 에러 페이지 경로 설정
error_page 404 /errors/404.html;
error_page 500 502 503 504 /errors/50x.html;
location /errors/ {
alias /var/www/html/errors/;
}
}
3. 설정 적용
설정을 변경한 후에는 문법 오류가 없는지 확인하고 Nginx를 재시작합니다.
sudo nginx -t
sudo systemctl restart nginx
이제 사용자가 잘못된 경로로 접속하면 설정한 깔끔한 커스텀 페이지가 표시됩니다.