와이파이 QR코드 만들기

QR 코드에 들어가는 내용

와이파이 QR 코드에는 WIFI:로 시작하는 한 줄의 문자열이 들어 있습니다. 이 형식은 ZXing 프로젝트의 Barcode Contents에서 처음 제안되었고, 이후 Wi-Fi Alliance가 WPA3 Specification v3.5 7절에 WIFI URI로 넣었습니다. 도구는 규격의 필드 순서대로 씁니다.

ZXing은 \, ;, ,, ", : 다섯 글자 앞에 백슬래시를 붙이도록 정했습니다. Android의 해석 코드(AOSP WifiUriParser)는 이 백슬래시를 지우고 읽으며, Android 설정에서 네트워크를 공유할 때도 같은 형식으로 씁니다.

예시

공유기의 게스트 네트워크. 이름 ipTIME Guest 2.4GHz, 비밀번호 sonnim2026!, WPA. 도구는 WIFI:T:WPA;S:ipTIME Guest 2.4GHz;P:sonnim2026!;;로 쓰고, 상태 줄에 버전 4(33 × 33 모듈), 레벨 M을 표시합니다.

한글 이름과 공백이 있는 비밀번호. 이름 카페 손님용은 6자지만 UTF-8로 16바이트입니다. 비밀번호 latte 2026의 공백은 QR 코드에 그대로 들어가고, 인쇄용 카드에는 latte␣2026으로 찍혀 공백 개수를 셀 수 있습니다. 한글이 있으니 공유기가 이름을 UTF-8로 송출하는지 확인하라는 안내도 나옵니다.

너무 긴 이름. 우리집와이파이5G네트워크게스트용은 17자, UTF-8로 47바이트입니다. IEEE 802.11은 SSID를 32바이트로 제한하므로 공유기가 이 이름을 송출할 수 없고, 도구가 바로 경고합니다. 한글만 쓴다면 10자(30바이트)까지가 기준입니다.

세미콜론이 있는 비밀번호. abc;def12는 P:abc\;def12로 씁니다. ;는 필드를 끝내는 문자라, 백슬래시가 없으면 휴대폰이 비밀번호를 abc로 읽고 연결에 실패합니다. WPA3 규격은 ;를 퍼센트 인코딩하라고 하지만 Android 해석 코드는 퍼센트를 풀지 않습니다. 그래서 도구는 붙이기 전에 한 번 스캔해 보라고 안내합니다.

공유기에서 확인할 것

ipTIME의 게스트 무선 네트워크 사용하기 안내에 따르면, 브라우저에서 192.168.0.1로 관리도구에 들어가 ‘무선 설정/보안 › 게스트 무선 네트워크 선택’에서 게스트 네트워크를 켭니다. 인증 및 암호화는 WPA2PSK-AES(권장), 암호는 8자리 이상이고, 통신 정책을 ‘인터넷 통신만 허용’으로 두면 손님 기기가 내부 네트워크에 접근하지 못합니다. 카드에 찍을 비밀번호는 이 게스트 네트워크의 것이어야 합니다.

WEP는 몇 분 만에 풀리고, 삼성 휴대폰은 Wi-Fi 고급 설정에서 WEP 네트워크를 허용하는 스위치(영문 Allow WEP networks)를 켜야 WEP에 연결합니다(삼성 안내). WEP를 고르면 도구도 경고합니다.

스캔할 수 있는 기기

• Android: Google 고객센터(Wi-Fi 네트워크에 연결)에 설정의 ‘네트워크 및 인터넷’에서 네트워크를 고르고 ‘공유’를 누르면 QR 코드가 나온다고 나와 있습니다. 삼성은 Wi-Fi 화면의 QR 코드 아이콘으로 스캔할 수 있다고 안내합니다. AOSP 해석 코드는 WPA, SAE, WEP, nopass를 받고 R:1도 읽습니다.
• iPhone: Apple의 iPhone 사용 설명서에는 ‘암호’ 앱에서 네트워크 QR 코드를 보여 주면 다른 사람이 스캔해 연결한다는 내용이 있습니다. 카메라가 어떤 필드를 읽는지는 공개되어 있지 않으며, 이 페이지는 iPhone으로 시험하지 않았습니다.
• 그 밖의 기기: 다른 제조사가 받는 필드를 설명한 공식 자료는 찾지 못했습니다. 손님이 많이 쓰는 휴대폰으로 시험해 보세요.

인쇄용 카드

카드 폭은 100mm이고, 높이는 이름과 비밀번호 길이에 따라 늘어납니다. 긴 값은 줄을 바꿀 뿐 잘리지 않습니다. PNG는 폭 1200px(약 305dpi)이고 모듈마다 정수 픽셀입니다. SVG는 인쇄해도 폭 100mm를 유지합니다. ‘카드에 비밀번호 인쇄’를 끄면 QR 코드와 이름만 찍힙니다.

다른 생성기와의 차이

2026-10-01에 같은 입력으로 시험했습니다.

• wifiqr.co.kr(Bing ‘와이파이 qr코드 만들기’ 1위)은 브라우저 안에서 만들고 이스케이프도 바르지만, 이름 입력란이 한글을 받지 않습니다(‘한글은 지원하지 않습니다’). 우리집와이파이5G네트워크게스트용을 넣으면 한글이 빠지고 S:5G만 남았습니다.
• GenQRCode(Bing ‘와이파이 qr’ 1위)는 영어 페이지에서 시험했을 때 비밀번호를 JSON 요청으로 /preview에 보낸 뒤 미리보기를 보여 줬습니다.

이 도구는 한글 이름을 UTF-8로 넣고, Android 해석 코드에 맞춰 이스케이프하며, 32바이트와 비밀번호 길이를 확인한 뒤 그립니다. 입력한 내용은 전송하지 않습니다.

제한

• WPA2 엔터프라이즈(802.1X)의 E, A, I, PH2와 SAE-PK 공개 키(K)는 지원하지 않습니다.
• CAFE1234처럼 16진수 문자만으로 된 이름도 그대로 씁니다. 따옴표로 감싸면 현재 Android 해석 코드가 따옴표까지 이름으로 봅니다.
• 여백(콰이어트 존)은 ISO/IEC 18004가 요구하는 4모듈로 고정입니다. 링크나 텍스트용은 QR코드 만들기, 강한 비밀번호는 비밀번호 생성기를 쓰세요.