작동 원리 및 구조
업로드하거나 붙여넣은 이미지를 오프스크린 HTML5 Canvas에 그려 원본 `RGBA` 픽셀 버퍼를 읽습니다. 먼저 지원 브라우저의 하드웨어 가속 네이티브 `BarcodeDetector` API로 QR과 1차원 바코드(EAN-13, Code-128, UPC, PDF417)를 스캔하고, 동시에 또는 범용 폴백으로 순수 JS `jsQR` 엔진이 정방향 및 흑백 반전 이미지를 모두 스캔합니다. 해독된 문자열은 자동 이동 없이 안전 카드 형태로 분류됩니다.
단계별 사용 방법
이미지 파일을 끌어다 놓거나 `Ctrl+V` / `Cmd+V`로 스크린샷을 바로 붙여넣고, 또는 '웹캠으로 스캔'을 클릭합니다.
해독된 원본 텍스트와 분류 결과(웹사이트 URL 주의 배지, Wi-Fi SSID/비밀번호 필드, vCard 요약 또는 일반 텍스트)를 확인합니다.
해독된 텍스트나 Wi-Fi 비밀번호를 안전하게 복사하세요 — HTTP 링크는 사용자가 직접 클릭하기 전까지 절대 열리지 않습니다.
주요 기능 및 장점
- 안전 최우선 링크 검사: 해독된 URL로 절대 자동 이동하거나 프리페치(Prefetch)하지 않습니다
- 흑백 반전 스캔 패스 지원으로 어두운 배경 위 흰색 QR 코드도 깔끔하게 인식
- `WIFI:T:WPA;S:...;P:...;;` 문자열을 읽기 쉬운 네트워크 이름과 비밀번호 복사 상자로 자동 파싱
- 클립보드 이미지 붙여넣기(`Cmd+V`/`Ctrl+V`) 및 실시간 웹캠 스캔 지원
- 하이브리드 엔진: 범용 `jsQR` + Chromium/macOS 네이티브 `BarcodeDetector`(EAN/Code128/QR)
계산 방식, 공식 및 기술 표준
QR 디코딩은 2D `ImageData`에 `inversionAttempts: "attemptBoth"` 옵션을 적용한 `jsqr`을 사용합니다. 구조화 분류기는 `WIFI:` 키-값 토큰을 파싱하고 `new URL()`로 `http:`/`https:` 스킴을 명시적으로 검증하며, `javascript:` 또는 `data:` 페이로드는 실행되지 않는 순수 텍스트 경고로 처리합니다.
실제 활용 사례
- 스마트폰으로 열기 전, 전단지나 결제용 QR 코드의 실제 목적지 도메인이 피싱 사이트가 아닌지 안전하게 사전 확인
- 매장이나 카페의 게스트 Wi-Fi QR 카드 이미지에서 네트워크 이름(SSID)과 비밀번호만 깔끔하게 추출
- 스크린샷 속 제품 바코드(Code-128, EAN-13) 번호 판독 (`BarcodeDetector` 지원 Chromium 브라우저)
- 인쇄소에 전단지 시안을 넘기기 전 직접 만든 QR 코드가 정상 인식되는지 최종 검증
입출력 예시 및 엣지 케이스
Guest Wi-Fi QR Card
Image encoding: WIFI:T:WPA;S:CafeGuest;P:espresso2026;;
Type: Wi-Fi Credentials | SSID: CafeGuest | Encryption: WPA | Password: espresso2026
Separate copy button grabs the password cleanly without hidden semicolons.
Safe URL Inspection
QR encoding: https://phish-example.test/login?ref=qr
Type: External URL (Inspect Host: phish-example.test) — Not opened automatically.
Always check the root domain before opening untrusted QR links.
제한 사항 및 정확도 안내
- • 1차원 선형 바코드(EAN-13, UPC-A, Code 128)는 데스크톱 및 Android Chrome/Edge에서 지원하는 네이티브 `BarcodeDetector` Web API에 의존하며, Firefox와 Safari에서는 `jsQR`을 통해 QR 코드 인식이 안정적으로 동작합니다.
- • 심하게 기울어졌거나 해상도가 너무 낮은 이미지, 반사광이 심한 사진은 코드 주변만 잘라내어(Crop) 올리면 인식이 훨씬 잘 됩니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. 오프라인 QR 코드 · 바코드 이미지 스캐너 (링크 안전 검사) 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
악성 QR 코드를 스캔하면 자동으로 해당 웹사이트가 열리나요?
아니요. 해독된 전체 텍스트와 도메인 주소를 화면에 명확히 보여주기만 할 뿐 절대 자동으로 리다이렉트하지 않습니다.
파일로 저장하지 않고 캡처한 스크린샷을 바로 붙여넣을 수 있나요?
네. 클립보드에 이미지가 복사된 상태에서 도구 화면 어디서나 `Ctrl+V` 또는 `Cmd+V`를 누르면 즉시 스캔됩니다.
Chrome에서는 EAN-13 바코드가 읽히는데 Firefox에서는 QR 전용으로 나오는 이유는 무엇인가요?
`jsQR`은 모든 최신 브라우저에서 QR 코드를 해독할 수 있지만, 1차원 선형 바코드 인식은 Chromium 계열 브라우저에 내장된 `BarcodeDetector` 엔진을 사용하기 때문입니다.
웹캠으로 스캔할 때 카메라 영상이 서버로 전송되나요?
아니요. 카메라 프레임은 오직 사용자의 브라우저 탭 내부 오프스크린 `<canvas>` 루프에서만 로컬로 처리됩니다.