QR 코드 생성기 — URL, WiFi, vCard, 이메일, SMS, 위치

QR 코드란 무엇인가요?

// Build a WiFi payload and generate an SVG QR
import QRCode from 'qrcode';

// 1. WIFI: protocol (de facto, recognized by iOS+Android)
const payload = 'WIFI:T:WPA;S:My\\;Network;P:p@ss\\;word;H:false;;';

// 2. Generate SVG (vector, scales without pixelation)
const svg = await QRCode.toString(payload, {
  type: 'svg',
  errorCorrectionLevel: 'M',
  margin: 4,
  color: { dark: '#000000', light: '#ffffff' },
});

// 3. Drop into the DOM (DOMParser-safe, not innerHTML)
const doc = new DOMParser().parseFromString(svg, 'image/svg+xml');
preview.replaceChildren(doc.documentElement);

주요 기능

예시

https://go-tools.org

SSID: Cafe WiFi / WPA2 / 비밀번호: visitor2026

Ada Lovelace / Acme Corp / +1 555 0100 / ada@acme.test

위도 40.7829, 경도 -73.9654 (뉴욕 센트럴파크)

사용 방법

1. 1

   데이터 유형 선택

   인코딩하려는 내용에 맞는 탭을 선택하세요: 웹사이트는 URL, 네트워크 공유는 WiFi, 연락처 정보는 vCard, 미리 채워진 메시지는 Email 또는 SMS, 지도 핀은 Location, 임의의 콘텐츠는 Plain Text.

2. 2

   필드 입력

   각 탭은 해당 유형에 맞는 필드만 표시합니다. WiFi는 SSID, 비밀번호, 보안 유형이 필요합니다. vCard는 이름, 전화번호, 이메일, 회사, 웹사이트를 받습니다. 입력하는 동안 QR 미리보기가 업데이트됩니다.

3. 3

   사용자 정의 (선택)

   Customize 패널을 열어 오류 정정 레벨(대부분의 경우 M, 인쇄물에는 H), 출력 크기(200-1024 px), 전경/배경 색상을 변경하세요. 대비가 너무 낮아 안정적인 스캔이 불가능할 때 도구가 경고합니다.

4. 4

   SVG 또는 PNG 다운로드

   Download SVG를 클릭하면 벡터 출력(확장 가능, 인쇄에 완벽)을 얻거나, 드롭다운에서 PNG 크기(256/512/1024 px)를 선택하세요. Copy SVG로 Figma나 디자인 도구에 바로 붙여넣을 수 있습니다.

일반적인 QR 코드 함정

QR encodes: https://bit.ly/abc → 404 after subscription lapses

QR encodes: https://your-domain.com/menu directly

FG #cccccc on BG #ffffff (ratio 1.6:1)

FG #003366 on BG #ffffff (ratio 12.6:1)

WIFI:T:WPA;S:Cafe;P:p@ss;word;; (parser breaks at the unescaped ;)

WIFI:T:WPA;S:Cafe;P:p@ss\;word;;

Print poster, ECC=L, partially folded → unreadable

Print poster, ECC=H → readable even with 30% damage

40% logo over center → fails on Samsung phones

15% logo, ECC=H → reliable across phones

?utm_source=...&utm_medium=...&utm_campaign=... (350 chars at M → reject)

Use /go/spring (35 chars) with server-side redirect to the long URL

주요 활용 사례

식당 메뉴

테이블에 URL QR을 인쇄하면 — 손님이 휴대폰으로 메뉴를 봅니다. 정적 QR이므로 호스팅 제공업체나 메뉴 도메인을 변경해도 작동합니다.

손님용 WiFi

집, 카페, 회의실 문 옆에 WiFi QR을 붙이세요. 손님은 비밀번호를 입력하지 않고 스캔하여 가입합니다 — 비밀번호를 큰 소리로 알려줄 필요도 없습니다.

행사 체크인

티켓과 표지판에 등록 페이지로 연결되는 URL QR을 인쇄하세요. 사진 인쇄물, 명찰, 끈에 표시됩니다 — 모든 스캔이 추적 가능한 체크인입니다.

명함

종이 명함에 vCard QR을 추가하면 — 스캔으로 즉시 연락처가 저장됩니다. 받는 사람에게 휴대폰에 정보를 직접 입력하라고 하는 것보다 약 4배 더 높은 저장률을 보입니다.

매장 위치 핀

Geo QR은 핀이 이미 설정된 기본 지도 앱을 엽니다. 부동산 광고, 식당 전단, 컨퍼런스 표지판, 결혼식 청첩장에 활용하세요.

마케팅 포스터

UTM 매개변수가 있는 URL QR은 인쇄 캠페인 기여도를 추적합니다. 정적 QR은 캠페인 분석 서비스가 종료되거나 계정이 만료되어도 살아남습니다.

제품 포장

박스에 보증, 사용 설명서, 등록 URL을 인코딩하세요. 운송 손상, 긁힘, 접히는 플랩에서도 QR이 살아남도록 오류 정정 H를 사용하세요.

박물관과 전시 라벨

오디오 가이드 URL, 더 깊은 맥락, 다국어 대안 — 방문자가 부피가 큰 인쇄 책자를 들고 다니는 대신 자신의 휴대폰으로 풍부한 콘텐츠를 얻습니다.

기술 세부사항

ISO/IEC 18004:2015 호환

출력은 국제 QR 코드 표준을 따릅니다. 콘텐츠 크기와 선택된 오류 정정 레벨에 따라 버전 1~40(21×21~177×177 modules)이 자동으로 선택됩니다.

Reed-Solomon 오류 정정

QR 코드는 손상이나 가림으로부터 복구하기 위해 Reed-Solomon 코딩을 사용합니다. L/M/Q/H 레벨은 손상된 데이터의 약 7%, 15%, 25%, 30%를 복구합니다. 더 높은 레벨은 같은 콘텐츠에 대해 더 큰 QR을 의미합니다.

표준 URI 스킴

WIFI: 프로토콜(사실상 표준, iOS와 Android가 인식), mailto: (RFC 6068), sms: (RFC 5724), geo: (RFC 5870). 연락처 카드는 vCard 3.0 (RFC 2426)을 사용합니다 — vCard 4.0 (RFC 6350)보다 스캐너 호환성이 더 넓습니다. iOS와 Android의 기본 카메라 앱이 모두 인식합니다.

자동 인코딩 모드

qrcode 라이브러리는 각 입력에 가장 효율적인 인코딩(numeric, alphanumeric, byte 또는 kanji)을 선택합니다. UTF-8 byte 모드는 이모지와 CJK 문자를 포함한 비ASCII 텍스트를 처리합니다.

모범 사례

정적 영역(quiet zone)을 잘라내지 마세요

QR 코드는 주변에 4 module 너비의 배경색 여백이 필요합니다. 이 도구는 기본으로 포함합니다 — 레이아웃에 QR을 배치할 때 빈 공간 낭비처럼 보여도 잘라내지 마세요.

인쇄용 QR에는 ECC 레벨 H 사용

인쇄는 가혹합니다 — 변색, 긁힘, 접힘선 모두 코드를 손상시킵니다. 오류 정정 레벨 H(약 30% 복구)가 구해줍니다. 변형되지 않는 화면에는 레벨 M으로 충분합니다.

명도 대비 4.5:1 이상 유지

QR 스캐너는 어두운 모듈과 밝은 모듈 사이의 대비를 측정합니다. 밝은 배경에 어두운 전경을 고수하세요. 반전(어두운 배경에 밝은 전경)은 일부 휴대폰에서는 작동하지만 다른 휴대폰에서는 실패합니다.

iOS와 Android 모두에서 테스트

iOS Camera는 iOS 11부터 기본으로 QR 코드를 읽습니다. Android는 제조사에 따라 다릅니다 — Samsung, Pixel, Xiaomi가 모두 약간 다르게 동작합니다. 전단 10,000장을 인쇄하기 전에 양쪽에서 테스트하세요.

HTTPS와 짧은 URL 사용

긴 URL은 QR을 더 조밀하게 만듭니다(modules가 더 작아져 → 스캔이 더 어려워집니다). 추적 URL이 200자 이상이면, 직접 통제하는 정적 URL 단축 서비스를 통과시키세요 — 만료되는 Bitly 같은 서비스는 사용하지 마세요.

자주 묻는 질문