현재 npm에 장애가 있나요?

npm 가용성이 의미하는 것

npm에는 서로 독립적으로 실패할 수 있는 여러 액세스 경로가 있습니다. npm 웹사이트는 npmjs.com을 사용하며, 패키지 설치, 종속성 해결 및 게시에는 일반적으로 registry.npmjs.org가 사용됩니다. 레지스트리 요청이 실패하는 동안 웹사이트는 로드될 수 있으며, 반대로 레지스트리 장애로 인해 웹사이트가 완전히 오프라인으로 보이지 않더라도 패키지 명령이 영향을 받을 수 있습니다.

서비스 전반의 상태를 확인하려면 npm의 공식 상태 페이지를 확인하세요. 모든 npm 기능이 영향을 받는다고 가정하기보다 패키지 가져오기, 인증, 게시, 레지스트리/API 액세스 또는 웹사이트 액세스 등 현재 실패하는 작업과 장애를 일치시켜야 합니다.

상태 페이지는 보고된 플랫폼 문제를 확인하는 데 도움이 되지만 프로젝트별 장애를 진단할 수는 없습니다. 정확한 npm 오류, 구성된 레지스트리, 영향을 받는 패키지, 그리고 동일한 요청이 다른 네트워크에서 작동하는지는 npm 장애와 로컬, 계정 또는 연결 문제를 구분하는 데 더 유용한 경우가 많습니다.

npm 문제 해결

1. 관련 npm 장애 확인

공식 npm 상태 페이지를 열고 레지스트리, 패키지 다운로드, 인증, 게시 또는 웹사이트에 영향을 주는 현재 진행 중이거나 최근 해결된 장애가 있는지 확인하세요. 보고된 문제가 현재 실패하는 작업과 일치한다면 장애가 해결될 때까지 프로젝트에 영향을 줄 수 있는 변경을 피하고 다시 시도하세요. 일치하는 장애가 표시되지 않더라도 지역, 네트워크, 계정 또는 프로젝트별 문제일 가능성은 남아 있습니다.

2. 장애 범위 파악

여러 프로젝트에서 설치 또는 패키지 해결이 실패한다면 레지스트리 액세스, DNS, 프록시, 방화벽 및 npm 구성 확인을 우선하세요. 한 프로젝트 또는 패키지에서만 실패한다면 npm 장애로 판단하기 전에 종속성 선언, lockfile, 패키지 이름, 버전 및 구성된 레지스트리를 점검하세요.

게시 및 로그인 실패는 공개 패키지 다운로드와 별도로 분석해야 합니다. 전체 오류, 사용 중인 계정 또는 토큰, 대상 레지스트리, 그리고 장애가 한 패키지, 조직 또는 계정 작업에만 영향을 미치는지 확인하세요.

3. 네트워크 및 DNS 증상 구분

• Connection timed out: 요청이 차단되었거나 잘못 라우팅되었거나 응답을 받지 못하고 있을 수 있습니다. 다른 네트워크에서 동일한 작업을 비교하고 해당되는 회사 방화벽 또는 프록시 규칙을 확인하세요.
• Connection refused: 구성된 엔드포인트, 프록시 또는 로컬 네트워크 경로가 연결을 거부하고 있을 수 있습니다. npm이 오래된 내부 또는 타사 엔드포인트가 아니라 예상한 레지스트리를 대상으로 하는지 확인하세요.
• NXDOMAIN과 같은 DNS 오류: 확인자가 요청한 호스트를 찾지 못하고 있습니다. 다른 네트워크에서 DNS 동작을 비교하고 VPN, 필터링 및 로컬 확인자 설정을 확인하세요.
• TLS 또는 인증서 오류: 인증서 검증을 변경하기 전에 HTTPS 가로채기, 프록시 인증서, 시스템 시간 및 보안 소프트웨어를 점검하세요.

4. npm 구성 및 인증 검토

특히 네트워크를 변경하거나 VPN을 활성화했거나 private registry를 사용하는 경우 구성된 레지스트리 및 프록시 설정을 확인하세요. 로그인, 게시 또는 private package 액세스의 경우 의도한 계정에 필요한 권한이 있는지, 자격 증명 또는 토큰이 만료되지 않았는지 확인하세요. 터미널 출력, 이슈 보고서 또는 지원 요청에 토큰을 절대 노출하지 마세요.

5. 브라우저에서만 발생하는 실패 확인

패키지 명령은 계속 작동하지만 브라우저에서 npm 웹사이트가 실패한다면 private window 또는 다른 브라우저를 사용해 보고 스크립트나 쿠키를 차단하는 확장 프로그램을 일시적으로 비활성화하세요. 브라우저와 npm 명령이 모두 실패한다면 브라우저 전용 해결 방법보다 상태 페이지와 네트워크 확인을 우선하세요.

6. 레지스트리 및 API 응답 해석

웹사이트는 작동하지만 registry.npmjs.org에 연결할 수 없다면 레지스트리 경로를 별도로 평가하고 정확한 HTTP 상태 또는 npm 오류를 기록하세요. 5xx 응답은 서버 측 또는 upstream 문제를 나타낼 수 있으며, 4xx 응답은 잘못된 요청, 권한 누락, 인증 문제, rate limit 또는 사용할 수 없는 패키지를 가리키는 경우가 더 많습니다. 문제를 에스컬레이션할 때 패키지 이름, 명령, 시간 및 전체 오류를 보존하되 자격 증명과 토큰은 삭제하세요.