이 문서는 로드되지 않는 사이트를 위한 제품 전반의 분류 트리입니다. KapsuleHost는 여러 제품을 운영하며, 원인을 가장 빨리 찾는 방법은 어떤 제품의 문제인지 추측하는 것이 아니라 브라우저가 화면에 정확히 무엇을 표시하는지 자세히 보는 것입니다. 아래의 각 분기는 1분 안에 직접 보거나 테스트할 수 있는 것을 기준으로 하며, 각 분기는 나머지를 배제합니다.
위에서 아래로 진행하세요. 처음 네 가지 질문으로 트리의 대부분이 걸러지며, 그 뒤의 분기들은 서로 겹치지 않도록 되어 있습니다. 정확히 하나의 분기에 도달해야 합니다.
트리 전체를 나누는 네 가지 질문
무엇이든 바꾸기 전에 이 질문에 답하세요. 각각은 직접 해 볼 수 있는 테스트이며, 각각이 원인의 범주를 통째로 제거합니다.
1. 차분한 안내 페이지인가요, 오류인가요? 사이트가 일시 중지되었다는 깔끔한 페이지가 나타난다면 이는 기술적 결함이 전혀 아닙니다. 결제 상태이며, 해결책은 코드가 아니라 계정에 있습니다. 바로 아래의 분기 A로 가세요.
2. Wi-Fi뿐 아니라 모바일 데이터에서도 실패하나요? 휴대폰의 Wi-Fi를 끄고 모바일 네트워크로 사이트를 불러와 보세요. 모바일 데이터에서는 되는데 Wi-Fi에서는 안 된다면 사이트에는 아무 문제가 없습니다. 원인은 로컬 네트워크, 공유기, 또는 기기의 오래된 DNS 캐시입니다. 둘 다에서 실패한다면 문제는 실제이며 방문자도 같은 문제를 겪고 있습니다.
3. 한 페이지인가요, 모든 페이지인가요? 홈 페이지, 내부 페이지, 그리고 /this-page-does-not-exist처럼 일부러 만든 주소를 차례로 시도해 보세요. 세 가지 중 어느 것이 작동하는지, 그리고 만든 주소가 무엇을 반환하는지가 이 가이드에서 가장 많은 정보를 주는 테스트입니다. 아래의 두 분기는 이것만으로 결정됩니다.
4. 오류가 보이나요, 다른 사람의 웹사이트가 보이나요? 로드되지 않는 사이트와 잘못된 콘텐츠가 로드되는 사이트는 완전히 다른 문제입니다. 이전 웹사이트가 나타난다면 망가진 것은 없습니다. 도메인이 아직 이전 호스트를 가리키고 있는 것입니다. 이는 분기 D이며, 가장 흔히 잘못 해석되는 증상입니다.
건너뛰어도 되는 테스트가 하나 있습니다. 주소에 ?cachebust=1을 붙여도 당사 네트워크에서는 사람들이 생각하는 대로 작동하지 않습니다. 당사 엣지는 캐시 키에서 쿼리 문자열을 제외하므로, 그 주소는 이전과 같은 캐시 사본을 반환합니다. 새 응답을 강제하려면 yourdomain.com/anything-random-here처럼 무작위 경로 세그먼트를 붙이세요. 이는 추측이 아니라 측정된 동작이며, 분기 H에서 중요합니다.
0단계: 당사 문제인지 확인하기
더 읽기 전에 플랫폼이 문제를 보고하고 있는지 확인하세요. 당사 상태 페이지는 공개되어 있고, 로그인이 필요 없으며, 계속 업데이트됩니다.
KPanel 사이드바 하단의 시스템 상태에서도 접근할 수 있습니다.
제목만 읽지 마세요. 사이트가 실행되는 제품에 해당하는 행 하나를 찾으세요. 각 행은 서로 독립적으로 장애가 나기 때문입니다.
| 사이트가 다음과 같다면 | 이 행을 보세요 |
|---|---|
| 웹사이트 또는 WordPress 사이트 | 웹 호스팅 또는 Managed WordPress |
| 당사 CDN 뒤에 있음 | Kapsule CDN |
| 당사 네임서버 사용 | 프리미엄 DNS |
| HTTPS에서만 실패 | SSL 인증서 |
상태 페이지가 모두 정상이라고 해서 사이트가 괜찮다는 뜻은 아닙니다. 공유 플랫폼이 정상이라는 뜻이며, 이는 실제로 유용합니다. 원인이 계정, 구성, 또는 코드에 있다는 것을 알려 주고 바로 아래 분기로 안내하기 때문입니다. 상태 페이지는 당사 구성 요소를 보고할 뿐, 개별 사이트는 보고하지 않습니다.
플랫폼이 아니라 특정 프로젝트 자체의 가용성은 가동 시간 모니터링을 참조하세요. 가동 시간 모니터링은 정확성이 아니라 도달 가능성을 측정합니다. 망가진 페이지를 빠르게 반환하는 사이트도 여전히 가동 중으로 계산됩니다.
A: 오류가 아닌 차분한 대기 페이지
보이는 것: 사이트가 오류를 내지 않습니다. "이 사이트는 현재 일시 중지되었습니다."라는 제목의 일부러 차분하게 만든 페이지가 로드됩니다. 호스팅이 보류 중이고 잃은 것은 없다고 설명하며, 로그인 버튼을 제공합니다.
의미: 기술적 결함이 아니라 결제 상태입니다. 서버는 정상이며 의도적으로 이렇게 응답하고 있습니다. 캐시를 지우거나, DNS를 다시 지정하거나, 다시 배포해도 바뀌지 않습니다.
해야 할 일: 로그인해서 계정을 정산하세요. 결제가 완료되면 몇 분 안에 사이트가 돌아오며, 데이터는 전혀 건드려지지 않았습니다. 계정이 정지된 이유에서 시작하고, 어느 날 무슨 일이 일어나는지 전체 일정은 결제를 중단하면 어떻게 되나요를 참조하세요.
이것으로 제품도 좁혀집니다. 대기 페이지는 호스팅 구독에 있는 웹사이트에만 표시됩니다. 따라서 대기 페이지는 어떤 종류의 문제인지뿐 아니라 어떤 제품인지도 알려 줍니다.
대기 페이지는 검색 엔진에 대해 일부러 임시 상태로 표시되며, 색인하지 말라고 요청합니다. 짧은 정지로 검색 순위를 잃지는 않습니다. 인증서 검증은 예외이므로 결제를 정리하는 동안에도 갱신은 계속 작동하고 HTTPS가 끊기지 않습니다.
서비스 복귀는 즉시 이루어지지 않습니다. 결제하면 계정은 즉시 업데이트되지만, 웹 서버의 차단을 해제하는 것은 백그라운드 조정 작업이며 몇 분 주기로 실행됩니다. 결제 직후에도 대기 페이지가 보인다면, 티켓을 열기 전에 몇 분 기다렸다가 비공개 창에서 다시 불러오세요.
A2: 로그인할 수 없지만 사이트는 정상인 경우
보이는 것: 분기 A의 반대입니다. 방문자는 웹사이트를 아주 정상적으로 이용하지만, 여러분은 KPanel에 들어갈 수 없습니다. 로그인 페이지에 "계정이 정지되었습니다. 고객 지원팀에 문의하세요."라고 표시됩니다.
의미: 이것도 결제 문제이며, 대부분의 사람들이 잘못 해석하는 경우입니다. 여러 계정 수준 정지는 웹사이트를 전혀 건드리지 않습니다. 직접 결제하는 연간 청구서, 당사 팀이 제기한 정지, 리셀러를 통해 청구되는 계정은 모두 패널을 잠그지만 모든 사이트는 계속 서비스됩니다. 사이트만 봐서는 이런 일이 일어났는지 알 수 없으며, 바로 그래서 여기서 짚어 둘 가치가 있습니다.
해야 할 일: 청구서를 정산하는 것은 필요하지만, 이런 경우에는 그것만으로 패널 접근이 복구되지 않는 경우가 많습니다. 계정 이메일 주소로 support@kapsulehost.com에 이메일을 보내 결제했다고 알리고 접근을 복구해 달라고 요청하세요. 청구서 번호를 포함하세요.
정지가 적용될 때 이미 로그인해 있었다면, 기존 세션은 만료될 때까지 계속 작동합니다. 지금 패널을 쓸 수 있다고 해서 계정이 정상 상태라는 증거는 아닙니다. 로그인되어 있다는 사실로 판단하지 말고 결제를 직접 확인하세요.
C: 모든 주소가 홈 페이지를 반환하는 경우
보이는 것: 홈 페이지가 로드됩니다. 내부 페이지도 자체 콘텐츠 대신 홈 페이지를 반환하며, /this-page-does-not-exist처럼 일부러 만든 주소도 404 대신 홈 페이지로 응답합니다.
올바른 경우: 앱이 클라이언트 라우팅이고 라우터가 주소와 일치하지 않을 뿐입니다. 결함은 호스팅이 아니라 프런트엔드 코드에 있습니다.
잘못된 경우: 클라이언트 라우팅 프레임워크를 쓰지 않는데 잘못된 주소가 조용히 홈 페이지로 응답하고 있습니다. 이 경우 망가진 내부 링크가 모든 크롤링에서 살아남고 검색 엔진이 이를 나쁘게 취급하므로 고칠 가치가 있습니다. 프로젝트의 프레임워크 프리셋을 확인하세요. 선택한 프리셋이 당사가 감지한 것보다 우선하므로, 잘못 선택한 프리셋이 정확히 이 증상을 만듭니다.
그 밖의 모든 경우의 정상 동작: 알 수 없는 주소는 빌드에 자체 404.html이 있으면 실제 404 상태와 함께 그것을 반환하고, 없으면 당사의 404 페이지를 반환합니다.
D: 새 웹사이트 대신 이전 웹사이트가 나타나는 경우
보이는 것: 무언가 로드되지만 잘못된 것입니다. 이전 웹사이트, 이전 호스트의 파킹 페이지, 또는 알아보지 못하는 "출시 예정" 페이지입니다. 오류는 없습니다.
의미: 도메인이 아직 이전 호스트를 가리키고 있습니다. 요청이 KapsuleHost에 전혀 도달하지 않으므로, 당사 쪽에서 무엇을 바꿔도 방문자가 보는 것에 영향을 줄 수 없습니다. 작동하는 페이지가 진전처럼 느껴지기 때문에 호스팅에서 가장 흔히 잘못 해석되는 증상입니다.
한곳에서 확인하는 방법:
- 당사에 등록된 도메인이라면 도메인을 열고 해당 도메인을 여세요. 그곳의 카드에 다섯 가지 중 무엇이 사실인지 분명히 표시되며, 그중 하나가 "연결 안 됨"입니다. 내용은 "확인한 모든 리졸버가 저희 것이 아닌 네임서버를 반환하므로, 이 도메인의 트래픽이 KapsuleHost에 도달하지 않습니다."입니다. 대신 "전파 중"이라고 표시되면 이미 일치하는 리졸버 수가 나오며, 대개 몇 시간 안에 저절로 끝납니다.
해야 할 일: 도메인을 관리하는 곳에서 레코드를 바꾼 다음 기다리세요.
E: 브라우저가 도메인을 전혀 찾지 못하는 경우
보이는 것: 브라우저가 서버에 전혀 도달하지 못합니다. 주소를 찾을 수 없다거나 서버 IP 주소를 찾을 수 없다고 표시하며, 모바일 데이터와 Wi-Fi, 비공개 창, 다른 사람에게서도 똑같이 실패합니다.
의미: 그 이름이 누구에게도 확인되지 않습니다. 따라갈 레코드가 없으므로 요청이 느리거나 거부되는 것이 아니라 그냥 갈 곳이 없습니다. 흔한 원인은 만료된 도메인, 네임서버가 한 번도 설정되지 않은 도메인, 삭제된 레코드, 또는 당사 패널에만 입력했을 뿐 등록 기관에서는 한 번도 만들지 않은 이름입니다.
해야 할 일(순서대로):
- 도메인이 만료되지 않았는지 확인하세요. 도메인을 열고 도메인 상태를 보세요. 만료된 도메인은 호스팅이 아무리 정상이어도 확인되지 않으며, 갱신만이 유일한 해결책입니다. 당사의 시계는 레지스트리의 시계와 다릅니다. 도메인 갱신 및 만료를 참조하세요.
- 도메인 카드에서 위임 상태를 확인하세요. 그곳에 "응답 없음"이 표시되면 어떤 리졸버도 도메인을 찾을 수 없다는 뜻이며, 대개 새로 등록되었거나, 만료되었거나, 네임서버가 설정되지 않았다는 뜻입니다.
각 레코드 유형의 역할은 DNS 기초와 CNAME 레코드를 참조하세요.
F: 사이트 대신 인증서 경고가 나타나는 경우
보이는 것: 브라우저가 페이지를 로드하지 않고 연결이 비공개가 아니라는 보안 경고로 막습니다. 그 경고 뒤의 사이트 자체는 정상입니다. 서버가 아니라 인증서 문제입니다.
의미: 이 호스트명에 대한 인증서가 아직 발급되지 않았거나, 있는 인증서가 만료되었거나, 입력한 이름과 다른 이름을 다루고 있습니다. 매우 흔한 경우는 www.yourdomain.com과 yourdomain.com이 둘 다 포함되지 않아 하나는 되고 다른 하나는 안 되는 것입니다. 두 표기를 모두 명시적으로 테스트하세요. 하나는 로드되고 다른 하나는 경고가 뜬다면, 서버 문제가 아니라 그 이름 하나에 대한 인증서 및 레코드 문제입니다.
호스팅의 웹사이트라면 사이트 개요 화면을 믿지 마세요. 개요 화면은 인증서를 활성 또는 대기 중으로만 표시하며, 만료되거나 실패한 인증서에도 "대기 중, 인증서 발급 중"이라고 표시합니다. 정작 가장 안심하면 안 될 순간에 안심시키는 셈입니다. 사이트에서 보안으로 가세요. 인증서가 며칠 남았는지와 지금 갱신 버튼 등 실제 상태가 표시됩니다. 그 화면이 정직한 화면이며, 확인해야 할 곳입니다.
인증서 발급에는 먼저 DNS가 올바라야 하므로, 분기 D나 E에 해당한다면 무엇이든 다시 발급하기 전에 그것부터 고치세요. SSL 인증서를 참조하고, 자물쇠가 없는 것이 아니라 깨져 있다면 혼합 콘텐츠 경고 해결하기를 참조하세요.
G: 5xx 오류 페이지
보이는 것: 500, 502, 503, 504처럼 숫자가 있는 실제 HTTP 오류입니다. 도메인이 확인되었고, 인증서가 수락되었고, 서버가 응답했습니다. 트리의 상당 부분이 이미 배제된 것입니다.
의미: 요청이 당사에 도달했고 그 뒤의 애플리케이션이 실패했거나 제시간에 응답하지 않았습니다. 숫자가 중요합니다. 500은 애플리케이션이 오류를 낸 것이고, 502와 504는 웹 서버 뒤의 프로세스에 도달할 수 없거나 너무 느린 것이며, 503은 의도적인 거부로, 호스팅에서는 분기 A의 대기 페이지 아래에 있는 정지가 이렇게 보입니다.
해야 할 일: 숫자를 읽은 다음 자신의 로그를 읽으세요. 사이트를 열고 로그로 가서 가장 최근 항목을 보세요. PHP 치명적 오류에는 파일과 줄이 표시되므로 원인이 된 플러그인이나 코드를 알 수 있습니다. 코드별 자세한 내용은 HTTP 오류 코드에 있고, 흔한 애플리케이션 수준 원인은 웹사이트가 로드되지 않을 때에 있습니다.
직접 한 변경 직후에 시작되었다면 그 변경이 첫 번째 용의자이며, 디버깅보다 복원이 빠릅니다. 백업에서 복원하기를 참조하세요.
H: 사이트는 로드되지만 콘텐츠가 잘못되었거나 오래된 경우
보이는 것: 사이트는 작동하지만 오래된 것을 제공합니다. 삭제한 페이지, 이전 스타일시트, 한 시간 전에 배포했는데 반영되지 않는 수정, 또는 이미 고친 망가진 페이지입니다.
의미: 사이트의 새 응답이 아니라 당사 엣지의 캐시 사본을 받고 있습니다. 당사 CDN은 뒤의 원본에 도달할 수 없을 때 마지막 정상 사본을 계속 제공하도록 설계되어 있습니다. 대개는 배려지만 가끔은 혼란스럽습니다. 멀쩡해 보이는 사이트가 실제로는 다운된 원본 앞에 있을 수 있기 때문입니다.
사이트가 아니라 캐시라는 것을 증명하는 방법: yourdomain.com/anything-random-here처럼 캐시될 수 없는 무작위 경로를 불러오세요. ?cachebust=1은 쓰지 마세요. 당사 엣지는 캐시에서 무엇을 제공할지 정할 때 쿼리 문자열을 무시하므로, 캐시 사본이 반환되어 아무것도 증명하지 못합니다. 무작위 경로에서는 새로운 동작이 보이는데 실제 페이지에서는 그렇지 않다면 캐시를 보고 있는 것입니다. 브라우저 개발자 도구의 응답 헤더 cdn-cache에 HIT, MISS, BYPASS가 표시되며, 같은 질문에 바로 답해 줍니다.
해야 할 일: 캐시를 비우세요. CDN 캐시 비우기를 참조하세요. 캐싱 플러그인과 사이트 캐시도 비운 다음, 자신의 브라우저 캐시에 속지 않도록 비공개 창에서 확인하세요. 사이트 캐싱에서 각 계층을 순서대로 설명합니다.
대역폭은 원인이 아닙니다. 당사 CDN 대역폭은 무제한입니다. 예상 사용량을 넘어도 사이트가 일시 중지되거나, 호스트명이 엣지에서 제거되거나, 조용히 더 느린 경로로 바뀌는 일은 없습니다. 사이트가 느리거나 오래된 내용을 보여 준다면, 사용한 트래픽 양이 아니라 캐시와 사이트 자체를 보세요.
그래도 해결되지 않을 때 지원팀에 보낼 내용
이 과정을 모두 거쳤는데도 원인을 찾지 못했다면, 잘 쓴 메시지 하나가 하루 동안의 주고받기를 줄여 줍니다. 다음을 포함하세요.
- 불러오는 정확한 주소.
https://를 포함하고www유무도 입력한 그대로. - 정확한 오류. 설명하지 말고 텍스트로 복사하세요.
{"error":로 시작하는 줄이라면 원인을 알려 주므로 그 줄을 그대로 보내세요. - 위에서 도달한 분기와 패널 화면에 표시된 내용.
- Wi-Fi뿐 아니라 모바일 데이터에서도 실패하는지, 다른 사람에게도 실패하는지.
- 언제 시작되었고 그 무렵 무엇이 바뀌었는지.
support@kapsulehost.com으로 이메일을 보내거나 KPanel의 지원에서 티켓을 여세요. 지원 티켓 열기를 참조하세요.