Whitelabel Error Page 뜨는 이유와 대처법

서론

인터넷 사용 중에 가끔씩 “Whitelabel Error Page”라는 메시지를 보게 될 수 있습니다. 이러한 에러 페이지는 웹사이트에 문제가 있을 때 표시되는 페이지로, 사용자에게 정보 대신 일반적인 에러 페이지가 보여집니다. 이 글에서는 Whitelabel Error Page가 뜨는 이유와 대처법에 대해 알아보겠습니다.

Whitelabel Error Page란?

Whitelabel Error Page는 기본적으로 웹서버에서 제공하는 일반적인 에러 페이지입니다. 이 페이지는 서버에 오류가 발생하거나 요청한 페이지를 찾을 수 없을 때 나타나며, 기본적으로 서버의 브랜딩이나 사용자 정의 내용이 없이 일반적인 에러 메시지만을 보여줍니다.
그 말은 도메인을 치면 네임버서로 연결되는 DNS 시스템상의 문제라고 말할 수 있습니다.
일반적인 웹서버 에러는 공유 에러코드를 가집니다.

200 OK: 요청이 성공적으로 처리되었음을 나타냅니다. 이는 가장 일반적인 성공 응답 코드입니다.
401 Unauthorized: 클라이언트가 인증되지 않았거나, 요청된 리소스에 접근하기 위한 유효한 자격증명이 필요함을 나타냅니다. 보통 로그인이 필요한 페이지에 접근할 때 발생합니다.
403 Forbidden: 클라이언트가 요청한 리소스에 대한 액세스 권한이 없음을 나타냅니다. 서버가 요청을 이해했지만 요청된 작업을 수행할 권한이 없는 경우 발생합니다.
404 Not Found: 요청한 리소스를 찾을 수 없음을 나타냅니다. 클라이언트가 잘못된 URL을 요청하거나 삭제된 파일에 접근하려고 할 때 주로 발생합니다.
500 Internal Server Error: 서버 내부에서 오류가 발생하여 요청을 처리할 수 없음을 나타냅니다. 주로 서버 설정 오류, 코드 버그 또는 데이터베이스 연결 문제 등이 이에 해당합니다.
503 Service Unavailable: 서버가 현재 요청을 처리할 수 없음을 나타냅니다. 주로 서버 과부하, 유지보수 또는 임시적인 다운타임 등의 이유로 발생합니다.

서버에서의 문제라면 해당 응답코드가 나오는데 도메인이 서버로 접속되는 중에 에러가 난다면?
그렇습니다. 응답코드 없는 Whitelabel Error Page가 뜨는 것입니다.

Whitelabel Error Page가 표시되는 이유

Whitelabel Error Page가 표시되는 주요 이유는 다음과 같습니다:

서버 구성 오류:
웹서버가 적절하게 구성되지 않았거나, 필요한 설정이 누락되었을 때 Whitelabel Error Page가 표시될 수 있습니다.
DNS 설정 문제:
도메인 이름 시스템(DNS) 설정에 문제가 있어 웹페이지의 IP 주소를 찾을 수 없을 때도 Whitelabel Error Page가 표시될 수 있습니다.
파일 및 디렉토리 권한:
웹서버의 파일 및 디렉토리 권한 설정이 잘못되어 필요한 파일이나 리소스에 액세스할 수 없을 때 Whitelabel Error Page가 표시될 수 있습니다.

대처법 1: 서버 구성 확인

Whitelabel Error Page가 표시되는 경우, 먼저 웹서버의 구성을 확인해야 합니다. 웹서버 소프트웨어(예: Apache, Nginx)의 설정 파일을 검토하고 필요한 구성을 적절하게 변경해야 할 수 있습니다. 구체적으로 다음을 확인해야 합니다:

a. 가상 호스트 설정

올바른 도메인 또는 IP 주소에 대한 가상 호스트 설정이 있는지 확인합니다.

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/example
    ErrorLog ${APACHE_LOG_DIR}/example_error.log
    CustomLog ${APACHE_LOG_DIR}/example_access.log combined
</VirtualHost>

Whitelabel Error와 직접적인 관련설정은 따로 존재하지 않으나 가상호스트에서의 디렉토리 설정부분이 바르지 않으면 Whitelabel Error Page가 뜰수 있으니 설정 값에 문제가 없는지 확인합니다.

b. 오류 페이지 설정

올바른 오류 페이지 설정이 있는지 확인하고 사용자 정의 에러 페이지를 설정할 수 있는지 확인합니다.

먼저, 웹 서버의 설정 파일을 엽니다. 일반적으로 Apache 웹 서버의 경우, 설정 파일은 httpd.conf 또는 apache2.conf와 같은 이름을 가지고 있습니다. Nginx 웹 서버의 경우, nginx.conf 파일을 수정해야 합니다.
설정 파일에서 ErrorDocument라는 지시어를 찾습니다. 이 지시어를 사용하여 오류 페이지를 지정할 수 있습니다. 일반적으로 지시어는 다음과 같은 형식을 가집니다:

ErrorDocument 404 /오류페이지.html

404는 응답코드를 말하니 해당 설정 항목이 존재한다면 바르게 설정되어 있는지 체크해 봅니다.
/오류페이지.html은 오류 페이지 파일의 경로입니다. 실제로 존재하는 파일 경로를 지정해야 합니다.

설정 파일을 저장한 후 웹 서버를 재시작하거나 재로드하여 변경 사항을 적용합니다. 웹 서버의 종류에 따라 명령은 다를 수 있습니다. 일반적으로는 service httpd restart (Apache) 또는 service nginx restart (Nginx)와 같은 명령을 사용합니다.

대처법 2: DNS 설정 확인

Whitelabel Error Page가 표시되는 경우, DNS 설정에 문제가 있을 수 있습니다. DNS 레코드와 도메인 등록 정보를 확인하여 올바른 IP 주소로 연결되어 있는지 확인해야 합니다. 다음을 확인해야 합니다:

A 레코드: 올바른 IP 주소로 도메인이 연결되어 있는지 확인합니다. A레코드 설정이 없는 곳에서는 네임서버 설정항목과 같습니다.
도메인 구입 사이트에서 가끔 네임서버를 수정했음에도 파킹서비스를 설정해 놓은 경우에도 부분적으로 Whitelabel Error page가 뜹니다.
CNAME 레코드: 필요한 경우, CNAME 레코드를 사용하여 올바른 도메인으로 리디렉션되도록 설정합니다.

대처법 3: 파일 및 디렉토리 권한 확인

Whitelabel Error Page가 표시되는 경우, 웹서버의 파일 및 디렉토리 권한 설정을 확인해야 합니다. 파일 및 디렉토리에 올바른 권한이 부여되어 있는지 확인하고 필요한 파일에 웹서버가 액세스할 수 있는 권한을 제공해야 합니다.
보통 서버상의 권한 설정은 소유자/그룹/공개 항목을 숫자로 표현합니다. 예를 들어 소유자/그룹/공개가 모두 읽기,쓰기, 실행 권한이 있다면 777이 됩니다.

Whitelabel Error Page 를 호출하는 것은 여기서 그룹과 공개항목입니다. 예) 디렉토리나 파일의 권한이 700.
이를 해결하기 위해서는 다음을 참고해 주세요.

chmod 755 <파일 또는 디렉토리 경로>

일반적인 경우 폴더는 755, 파일은 644의 권한설정을 가집니다.

결론

Whitelabel Error Page는 도메인에서 웹서버로 연결되는 과정에서 발생하는 에러 페이지입니다. 이 페이지가 표시되는 이유는 서버 구성 오류, DNS 설정 문제, 파일 및 디렉토리 권한 등 여러 가지 요인에 의해 발생할 수 있습니다. Whitelabel Error Page를 해결하기 위해 웹서버의 구성을 확인하고 필요한 조치를 취해야 합니다. 또한, 커스텀 에러 페이지를 생성하여 사용자들에게 더 나은 사용자 경험을 제공할 수 있습니다.

서론