CVE-2026-111497에 대한 패시브 Node2Shell 노출 검사기 및 브랜드 HTML 보고서를 포함한 오프라인 Node.js 런타임 평가. Python 3.10+, 의존성 없음, 익스플로잇 페이로드 없음.
Node.js 런타임 및 웹사이트의 Node2Shell(CVE-2026-111497)에 대한 버전 기반 분류
오프라인 런타임 평가 · 수동적 웹사이트 메타데이터 · 단일 파일, 의존성 없는 Python
node2shell-check는 런타임이나 웹사이트가 보고하는 Node.js 버전을 각 지원 브랜치의 공식 업스트림 수정 버전과 비교합니다. 이미 알고 있는 버전을 평가하거나, 배포된 서비스 내부에서 메타데이터를 수집하거나, 웹사이트의 일반적인 공개 응답을 검사할 수 있습니다.
이 도구는 익스플로잇 페이로드를 전송하지 않으며, Brotli를 절대 디코딩하지 않고, 불확실성을 정직하게 보고합니다. 숨겨진 버전, 벤더가 빌드한 버전, 또는 상충하는 버전은 unknown으로 표시되며, 절대 "안전"으로 표시되지 않습니다.
[!IMPORTANT] 잠재적 노출은 확인된 익스플로잇 가능성이 아닙니다. 모든 결과는 익스플로잇 가능성을
not_tested로 유지합니다. 이 취약점은 공격자가 제어하는 Brotli 데이터의 디코딩과 관련되며, 버전만으로는 애플리케이션이 해당 코드 경로에 도달하는지 여부를 보여줄 수 없습니다.fixed_version_reported는 배포된 패치의 검증이 아닙니다. 모든 결과를 관리자가 확인해야 할 신호로 취급하십시오.
평가 권한이 있는 대상만 검사하고, 실제 대상 목록, 인벤토리, 보고서는 버전 관리에서 제외하십시오.
python이 Python 3가 아닌 경우 python3를 사용하십시오.collect-runtime.cjs를 실행하는 경우에만 Node.js가 필요합니다.git clone https://github.com/completetech-security/node2shell-check.git
cd node2shell-check
# Compare a known version. Offline, no network calls.
python node2shell_check.py --node-version 24.22.0
# Collect metadata where the service runs (same Node.js binary), then assess it offline.
node collect-runtime.cjs > runtime.json
python node2shell_check.py --inventory runtime.json --format html --output report.html
# Check authorized websites listed one per line (start from websites.example.txt).
cp websites.example.txt websites.txt # then replace the entries with your own authorized targets
python node2shell_check.py --input websites.txt --format html --output websites-report.html
--format 없이 실행하면 결과가 CSV 형식으로 stdout에 기록됩니다. 전체 옵션 목록은 python node2shell_check.py --help를 실행하거나 전체 레퍼런스를 참조하세요.
세 가지 모드를 한 번의 실행에서 모두 조합할 수 있습니다. 각 입력은 자체적인 증거를 가진 별도의 관찰 결과가 되며, 제공된 런타임 버전이 제공된 URL에 속한다고 가정하지 않습니다.
| 모드 | 옵션 | 네트워크 | 수행 내용 |
|---|---|---|---|
| 알려진 버전 | --node-version VERSION (반복 가능) | 없음 | 다른 곳에서 확보한 버전과 비교합니다. |
| 런타임 인벤토리 | --inventory FILE (반복 가능) | 없음 | collect-runtime.cjs가 생성한 수집기 호환 JSON(스키마 1)을 읽습니다. |
| 웹사이트 메타데이터 | 인수로 전달된 URL 또는 도메인, 또는 --input FILE | 있음 | 각 제공된 대상에서 공개 응답 메타데이터를 읽습니다. |
런타임 인벤토리. collect-runtime.cjs는 자신을 실행하는 Node.js 바이너리에서 버전 및 빌드 메타데이터를 기록합니다. 애플리케이션 코드를 로드하거나, 환경 변수를 읽거나, 데이터를 압축 해제하거나, 연결을 열지 않습니다. 벤더 패치 출처를 입증할 수 없으며, build_source는 기본값이 unknown입니다. 평가하려는 실제 컨테이너 또는 런타임에서 실행하세요. 호스트 설치 환경은 모든 컨테이너, 함수, 워커를 설명하지 않습니다.
웹사이트 메타데이터. 각 대상에 대해 검사기는 robots.txt를 읽고, 정책이 허용하는 경우 제공된 페이지에 일반 GET 요청을 보냅니다. 검증된 TLS, 정직한 User-Agent, 제한된 응답 크기, 요청 페이싱을 사용합니다. 리다이렉트는 동일 호스트 또는 그 www 대응 호스트 내에 머물며, HTTPS 다운그레이드는 중단됩니다. 그 외에는 아무것도 가져오지 않으며, 압축된 본문, 자격 증명, 조작된 요청을 보내지 않습니다. Express 또는 Next.js 힌트는 결코 Node.js 버전 증거가 되지 않으며, Brotli 응답 압축은 애플리케이션이 요청 본문을 디코딩한다는 것을 증명하지 않습니다. 전체 규칙은 웹사이트 모드에서 수행되는 요청을 참조하세요.
각 관찰 결과에는 네 가지 평가 상태 중 하나가 부여됩니다.
| 상태 | 의미 |
|---|---|
potentially_affected | 해당 브랜치의 수정 버전보다 낮은 일반 Node.js 버전이 보고되었습니다. 배포된 빌드를 확인하고 교정을 우선시하세요. |
unsupported_runtime | 버전이 지원이 종료된 이전 업스트림 라인에 있습니다. 벤더 지원을 확인하고 지원되는 패치된 런타임으로 이동하세요. |
fixed_version_reported | 보고된 버전이 수정 버전을 충족합니다. 이는 설치된 패치에 대한 독립적인 검증이 아닙니다. |
unknown | 버전이 누락되었거나, 형식이 잘못되었거나, 충돌하거나, 벤더 한정이거나, 커스텀 빌드이거나, 사전 릴리스이거나, 백포트되었을 가능성이 있거나, 이 규칙 스냅샷 범위를 벗어났습니다. |
내장된 규칙 스냅샷의 업스트림 수정 버전:
| Node.js 브랜치 | 22.x | 24.x | 26.x |
|---|---|---|---|
| 수정 버전 | 22.23.4 | 24.22.1 | 26.12.1 |
임계값은 Node.js 2026년 10월 보안 릴리스와 2026-10-21에 릴리스된 22.23.4, 24.22.1, 26.12.1의 릴리스 노트에서 가져옵니다. 내장된 규칙 스냅샷의 날짜는 2026-10-23입니다. 검사기는 규칙을 다운로드하거나 새로 고치지 않으므로, 오래된 사본을 다시 실행해도 규칙이 업데이트되지 않습니다.
보고서를 읽을 때 다음 구분을 유념하세요:
fixed_version_reported 관찰 결과가 실패한 웹사이트 검사를 지우지는 않습니다. 각 결과의 가져오기 결과와 실행의 완전성, 그리고 평가를 함께 검토하세요.unknown으로 유지됩니다. 수집기의 Brotli 메타데이터는 맥락 정보일 뿐 패치 판정이 아닙니다.평가 방법론은 각 분류 규칙과 관리자가 수행해야 하는 점검을 문서화합니다. 결과 및 증거 필드는 참조에 나열되어 있습니다.
--format html은 로고, 요약 타일, 각 결과와 그 증거 및 다음 단계, 업스트림 수정 표, 실행 완전성 정보를 포함하는 단일 오프라인, 스크립트 없는 파일을 생성합니다. 이는 독자의 라이트 또는 다크 테마를 따르며 깔끔하게 인쇄됩니다.
예약된 example.* 도메인과 가상의 런타임으로 구성된 합성 예시입니다. HTML 보기.
--logo path/to/logo.png와 --brand "Your Company"를 사용하여 자체 조직에 맞게 보고서를 브랜딩하세요.
CSV(기본값)와 JSON은 스프레드시트와 파이프라인에 적합합니다. 진행 상황과 진단 정보는 stderr로 전달되어 stdout을 데이터용으로 사용할 수 있습니다.
보고서 스키마 1.1은 검사기의 실행 파일 SHA-256(tool_sha256, 게시자 서명 아님)과 JSON, CSV, HTML의 명시적 실행 완전성을 기록합니다. 기존 관찰 열과 인벤토리 스키마 1은 호환성을 유지합니다. 빈 CSV 보고서는 조작된 대상 대신 하나의 요약 행을 포함합니다. JSON 보고서는 최상위 tool, tool_version, tool_sha256, report_schema_version, rules_as_of, generated_at, complete, results 필드를 가진 객체입니다. complete: true는 입력 루프가 완료되었음을 의미하며, 모든 요청이 성공했거나 모든 버전이 식별되었음을 의미하지는 않습니다. 자세한 내용은 CSV, JSON, 결과 필드를 참조하세요.