SNSCDN 네트워크 점검 결과 읽는 법: PASS, FAIL, SKIP

SNSCDN netcheck는 한 번의 진단에서 가장 먼저 이상이 나타난 단계를 확인하는 도구입니다. 속도 측정 도구가 아니며, 구독이나 클라이언트 설정 또는 모든 지역에서의 접속 가능 여부를 검증하지 않습니다.

공개 도구 저장소를 다운로드하거나 복사한 뒤 저장소의 루트 디렉터리를 여세요. macOS 또는 Linux에서는 다음 명령을 실행합니다.

bash bin/netcheck.sh example.com 443

Windows PowerShell에서는 다음 명령을 실행합니다.

.\bin\netcheck.ps1 example.com 443

example.com은 점검할 공개 호스트 이름으로 바꾸세요. 구독 URL, 토큰이 포함된 URL, 관리자 주소, 사설 IP 주소 또는 기타 비공개 대상을 사용하면 안 됩니다.

스크립트는 진단 결과를 SNSCDN에 업로드하지 않습니다. 다만 선택한 대상에 일반적인 DNS 질의와 연결을 수행하므로, DNS 리졸버와 대상 서버가 정상적인 질의 또는 연결 메타데이터를 볼 수 있습니다.

실행한 버전 확인하기

일부 서비스는 HEAD 요청을 허용하지 않습니다. 따라서 브라우저에서 GET으로 열 수 있어도 Windows 버전에서 403, 405 또는 일반 HTTP 오류가 표시될 수 있습니다. 이 차이만으로 사이트가 오프라인이라고 판단할 수는 없습니다.

출력을 위에서 아래로 읽기

DNS lookup failed

이번 이름 확인에서 호스트 이름의 IP 주소를 얻지 못했습니다. 먼저 호스트 이름의 철자를 확인하고, 다른 조건은 바꾸지 않은 채 Wi-Fi와 모바일 데이터에서 비교해 보세요. 한 네트워크에서만 실패하면 해당 네트워크 또는 DNS 경로를 먼저 점검합니다. 여러 네트워크에서 실패하면 도메인의 공개 DNS 상태도 확인합니다. 이 행만으로 서버가 오프라인이라고 단정할 수는 없습니다.

TCP port ... is unreachable

기기가 제한 시간 안에 대상 포트에 연결하지 못했습니다. 기기의 방화벽, 접속 네트워크, 경로, 포트 정책 또는 원격 서비스가 원인일 수 있습니다. 이로 인해 뒤의 HTTP 점검도 실패할 수 있으므로, 각각의 실패 행을 별개 문제로 취급하지 말고 가장 먼저 나타난 TCP 오류부터 확인하세요.

TLS certificate received

이는 Bash 스크립트가 TLS 연결을 통해 OpenSSL이 해석할 수 있는 인증서 정보를 받았다는 뜻일 뿐입니다. 이 점검은 인증서 신뢰 체인, 호스트 이름 일치, 유효 기간 또는 브라우저 호환성을 완전히 검증하지 않습니다. 따라서 이 행을 “인증서가 완전히 유효하다”는 의미로 해석하면 안 됩니다.

브라우저에 인증서 경고가 계속 표시된다면 기기의 시간, 호스트 이름, 인증서 유효 기간과 신뢰 체인을 별도로 확인하세요. 경고를 무시하거나 인증서 검증을 끄는 방식으로 해결하면 안 됩니다.

TLS handshake or certificate check failed

Bash 스크립트가 해석 가능한 인증서 정보를 얻지 못했습니다. 호스트 이름, 중간 네트워크 장비, TLS 설정 또는 원격 서비스가 원인일 수 있으며, 이 행만으로 인증서가 만료되었다고 판단할 수는 없습니다. Windows 버전에는 별도의 TLS 행이 없으므로 관련 예외는 일반적으로 HTTP request failed: ...에 표시됩니다.

명확한 HTTP 4xx 또는 HTTP 5xx

도구가 명확한 HTTP 상태 코드를 받은 경우에만 HTTP 응답을 받았다고 확인할 수 있습니다. 4xx는 일반적으로 요청이 거부되었거나 엔드포인트 요구 사항을 충족하지 못했음을 뜻합니다. 5xx는 서비스가 요청을 정상적으로 처리하지 못했음을 뜻합니다. 어느 쪽도 “네트워크에 전혀 연결할 수 없다”는 의미는 아닙니다.

Bash 버전은 2xx/3xx를 PASS로, 그 밖의 명확한 상태 코드를 FAIL로 표시합니다. 리디렉션을 자동으로 따라가지 않으므로 [PASS] HTTP 301 또는 302는 리디렉션 응답을 받았다는 사실만 보여 줄 뿐, 이동할 대상이 작동한다는 것을 증명하지 않습니다. Windows 버전은 HEAD를 사용하며 성공 이외의 응답을 예외 요약에 포함할 수 있습니다.

일반적인 HTTP request failed

이는 요청이 HTTP 서비스에 도달했다는 증거가 아닙니다. DNS, TCP, TLS, 시간 초과, 연결 중단, 거부된 HEAD 요청 또는 성공 이외의 상태 모두 일반 오류를 만들 수 있습니다. PowerShell 버전에서는 같은 행에 있는 예외 요약을 확인하세요. Bash 버전은 curl 오류 요약을 표시하지 않으므로 위쪽의 DNS, TCP, TLS 결과 중 가장 먼저 이상이 나타난 항목으로 돌아가 확인합니다.

[SKIP]과 마지막 [PASS]

[SKIP]은 해당 점검을 실행하지 않았다는 뜻이며, 통과했다는 뜻이 아닙니다. Bash 스크립트는 [FAIL]만 집계하므로 위에 하나 이상의 [SKIP]이 있어도 마지막에 [PASS] No blocking problem detected를 표시할 수 있습니다. 마지막 요약만 보지 말고 모든 행을 확인하세요. 현재 Windows 버전에는 SKIP 출력이 없습니다.

실행 가능한 모든 점검이 PASS여도 이번 진단에서 연결을 막는 문제가 발견되지 않았다는 뜻일 뿐입니다. 대역폭을 측정하거나 클라이언트 설정을 검증하지 않으며, 다른 네트워크, 지역, 경로 또는 시간대에서도 안정적임을 증명하지 않습니다. 더 폭넓은 점검은 연결 문제 해결 및 지원 안내를 참조하세요.

개인정보를 보호하는 지원 요청 작성하기

다음 정보만 제공하는 것을 권장합니다.

• 기기 OS와 버전
• 가정용 Wi-Fi, 모바일 데이터 등의 네트워크 유형
• 점검 날짜, 시간, 시간대
• 사용한 공개 호스트 이름과 포트
• 각 항목의 [PASS], [FAIL]과 Bash 버전에 표시된 경우 [SKIP]
• 같은 시점에 브라우저 또는 클라이언트에 표시된 짧은 오류 메시지

공유하기 전에 이름 확인으로 얻은 IP 주소, 전체 URL, 인증서 세부 정보, 계정 이메일, 주문 정보, 구독 URL, QR 코드, 액세스 토큰 및 기타 인증 정보를 삭제하세요. PowerShell 예외 요약에도 URL이나 내부 정보가 포함될 수 있으므로 먼저 확인하고 가려야 합니다. 전체 로그를 공개 Issue, 포럼 또는 그룹 채팅에 게시하지 마세요. 계정, 주문 및 구독 관련 문의는 로그인 후 지원 티켓으로 제출하세요.