React2Shell Checker

Next.js 및 React 애플리케이션에서 React2Shell 취약점(CVE-2025-55182)을 탐지하는 보안 취약점 스캐너입니다.

개요

React2Shell Checker는 웹사이트를 스캔하여 취약한 버전의 Next.js 또는 React Server Components를 실행 중인지 감지할 수 있게 해줍니다. 이 도구는 헤드리스 브라우저 기술을 사용하여 프레임워크 버전을 감지하고, 이를 알려진 취약 버전 범위와 비교합니다.

기능

• 🔍 자동 감지 — 브라우저 기반 분석을 통해 Next.js 및 React 버전 감지
• ⚠️ 취약점 평가 — 공식 영향 버전 목록과 대조
• 📋 상세 보고서 — 프레임워크, 버전, 심각도 및 조치 단계 표시
• 🔗 공식 참조 — Vercel 및 React 보안 권고 링크
• 📱 반응형 UI — 데스크톱 및 모바일 기기 지원

시작하기

사전 요구 사항

• Node.js 20+
• npm 또는 yarn
• Puppeteer 호환 브라우저 엔드포인트(버전 감지용)

설치

# 저장소 클론
git clone https://github.com/muthaiyanmani/react2shell-checker.git
cd react2shell-checker

# 의존성 설치
npm install

환경 변수

루트 디렉터리에 .env.local 파일을 생성하세요:

# 필수: Puppeteer 브라우저 WebSocket 엔드포인트
BROWSER_WS_ENDPOINT=wss://your-browser-endpoint

개발

# 개발 서버 시작
npm run dev

# 린트 실행
npm run lint

# 코드 포맷
npx prettier --write .

프로덕션 빌드

# 프로덕션용 빌드
npm run build

# 프로덕션 서버 시작
npm start

영향 받는 버전

Next.js

React RSC

보안 고려 사항

• 승인된 사용만 — 소유하거나 테스트 권한이 있는 웹사이트만 스캔하세요
• 데이터 저장 없음 — 이 도구는 스캔한 URL이나 결과를 저장하지 않습니다
• 공개 정보 — 모든 취약점 데이터는 공식 공개 권고에서 가져옵니다

공식 참조

• Vercel 보안 게시판 - React2Shell
• React 보안 권고

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.

면책 조항

이 도구는 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 개발자는 이 도구 사용으로 인해 발생하는 손해에 대해 책임을 지지 않습니다. 결과는 공개적으로 이용 가능한 정보를 기반으로 하며, 자격을 갖춘 보안 전문가가 검증해야 합니다.

Vercel, Next.js 또는 React와 제휴 관계가 아닙니다.

저자: Muthaiyan Mani

교육 및 보안 연구 목적으로만 사용하세요.