바로 답
와이파이 QR 생성기는 네트워크 이름(SSID)·비밀번호·보안 유형 세 값으로 WIFI:T:보안;S:SSID;P:비밀번호;; 형식의 QR코드를 만듭니다. 입력값은 브라우저 안에서만 처리되고 서버로 보내지 않습니다. 인쇄 전에 직원 기기로 먼저 스캔해 접속되는지 확인하세요.
근거: 이 페이지의 QR 생성 코드(WifiQr 컴포넌트)와 QR 라이브러리(qrcode.react 4.2.0) 기본값을 직접 확인했습니다. 아래 표의 문자열은 같은 코드의 이스케이프 규칙을 그대로 적용해 계산한 값입니다.
입력 칸은 세 개, 나머지는 규칙입니다
화면에 있는 입력은 네트워크 이름(SSID), 비밀번호, 보안 유형(WPA / WPA2 · WEP · 없음) 세 가지이고, 숨겨진 네트워크 체크 상자가 하나 더 있습니다. 생성 버튼을 누르면 SSID 가 비어 있을 때만 "네트워크 이름을 입력해주세요."라는 안내가 나오고, 값이 있으면 QR 이 바로 만들집니다. 비밀번호는 검사하지 않으므로 실제로 접속되는지는 기기로 스캔해 확인해야 합니다.
QR 에 담기는 문자열은 아래 순서로 조립됩니다. 비밀번호가 비어 있으면 P: 항목 자체가 빠지고, 숨겨진 네트워크를 켜면 H:true; 가 붙습니다. 마지막에 세미콜론이 한 번 더 붙어 문자열이 ;; 로 끝납니다.
| 입력 상태 | QR 문자열 |
|---|---|
| WPA · SSID Cafe_WiFi · 비밀번호 1234 | WIFI:T:WPA;S:Cafe_WiFi;P:1234;; |
| 공개(없음) · 비밀번호 비움 | WIFI:T:nopass;S:Cafe_WiFi;; |
| 숨겨진 네트워크 켬 | WIFI:T:WPA;S:Cafe_WiFi;P:1234;H:true;; |
| SSID 에 세미콜론이 들어감(Our;Cafe) | WIFI:T:WPA;S:Our\;Cafe;P:1234;; |
특수문자는 왜 백슬래시가 붙나
와이파이 QR 문자열은 세미콜론으로 항목을 구분합니다. 그래서 SSID 나 비밀번호에 \ ; , " : 가 들어 있으면 그대로 넣을 때 항목이 잘못 끊깁니다. 이 도구는 이 다섯 문자 앞에 백슬래시를 붙여 값의 일부임을 표시합니다. 예를 들어 SSID 가 Our;Cafe 면 Our\;Cafe 로 인코딩됩니다. 공백과 한글은 그대로 들어가고, 대소문자도 바꾸지 않습니다.
현장에서 자주 생기는 문제가 여기서 나옵니다. SSID 를 눈으로 보고 입력할 때 앞뒤 공백이나 대문자 하나만 달라도 다른 네트워크가 됩니다. 공유기 관리 화면에서 이름을 복사해 붙여넣는 편이 정확합니다.
보안 유형을 잘못 고르면 접속되지 않습니다
대부분의 가정·매장 공유기는 WPA2 또는 WPA3 를 쓰므로 기본값인 WPA / WPA2 를 그대로 두면 됩니다. WEP 는 오래된 장비에서만 쓰는 방식이고, 암호화 없이 열린 네트워크는 없음을 고릅니다.
주의할 점이 하나 있습니다. 보안을 없음으로 바꿔도 비밀번호 칸에 값이 남아 있으면 QR 문자열에 P: 항목이 그대로 들어갑니다. 열린 네트워크용 코드를 만들 때는 비밀번호 칸을 비우세요. 반대로 비밀번호가 있는 네트워크인데 보안을 없음으로 두면 기기는 비밀번호 없이 접속을 시도하므로 연결되지 않습니다.
QR 오류 정정 수준은 L 입니다
이 도구가 쓰는 QR 라이브러리의 기본 오류 정정 수준은 L(약 7% 복구) 입니다. 화면 코드에 별도 설정이 없어 기본값이 적용됩니다. 정정 수준이 낮을수록 같은 데이터를 더 성긴 패턴으로 담을 수 있어 인쇄가 작아도 잘 읽히는 장점이 있고, 대신 코드 일부가 가려지거나 손상되면 인식이 끊기기 쉽습니다. 스티커를 붙이거나 손때가 묻는 매장 게시용이라면 코드를 크게 인쇄하고, 인쇄 후 실제 출력물을 스캔해 확인하는 편이 안전합니다.
내려받는 파일은 화면의 QR 을 PNG 로 저장한 것이고 파일 이름은 wifi-SSID.png 형식입니다. 벡터(SVG) 저장이나 로고 삽입 기능은 이 도구에 없습니다.
게시 위치와 보안 판단
QR 안에는 비밀번호가 평문으로 들어 있습니다. 사진으로 찍어 가면 그 값이 그대로 남으므로, 손님에게 열어 주는 네트워크는 인터넷만 나가고 내부 기기에는 접근하지 못하는 게스트 네트워크로 분리하는 것이 안전합니다. 사무실이라면 방문객용 SSID 를 따로 만들고, 프린터·NAS·업무 서버가 붙은 망의 비밀번호는 QR 로 만들지 마세요. 게시 후 비밀번호를 바꾸면 기존 QR 은 즉시 무효가 되므로, 교체용 QR 을 함께 만들어 두면 운영이 편합니다.
| 위치 | 확인할 것 |
|---|---|
| 카페 테이블 | 스탠드 높이에서 손님이 앉은 자세로 스캔되는지, 조명 반사가 없는지 |
| 숙소 체크인 안내 | 언어와 무관하게 접속되는지, 체크아웃 후 비밀번호 교체 주기 |
| 사무실 회의실 | 게스트 망인지 업무 망인지, 방문 종료 후 코드 회수 |
| 행사장 안내판 | 인쇄 크기와 거리, 사람이 몰릴 때 같은 코드를 여러 장 배치 |
연결이 안 될 때 확인 순서
QR 을 스캔했는데 연결되지 않을 때는 만든 코드의 문제인지 공유기 설정의 문제인지부터 갈라야 합니다. 아래 표는 이 도구가 만드는 문자열 구조에서 바로 확인할 수 있는 항목만 모았습니다.
| 증상 | 가능한 원인 | 확인 방법 |
|---|---|---|
| 스캔해도 아무 반응이 없다 | QR 이 흐리거나 작게 인쇄됨, 화면 반사 | 같은 PNG 를 화면에 크게 띄워 스캔해 본다. 화면에서 되면 인쇄 크기·재질 문제다. |
| "네트워크에 연결할 수 없음" | SSID 불일치(대소문자·공백) | 공유기 관리 화면의 SSID 를 복사해 다시 만든다. |
| 비밀번호 오류로 표시된다 | 보안 유형을 없음/WEP 로 잘못 선택 | WPA2 공유기라면 WPA/WPA2 로 다시 만든다. |
| 숨김 네트워크만 실패한다 | 숨겨진 네트워크 항목을 켜지 않음 | H:true 가 붙었는지 확인하고 다시 생성한다. |
| 특정 기기에서만 실패한다 | 오래된 기기·앱의 형식 해석 차이 | 카메라 앱과 QR 전용 앱에서 각각 시도해 본다. |
QR 을 일반 텍스트로 만든 경우에는 WIFI: 로 시작하지 않아 접속 화면이 뜨지 않습니다. 이 도구는 항상 WIFI: 형식으로 만들지만, 다른 곳에서 만든 코드를 그대로 붙여 쓸 때는 문자열 앞부분을 확인하세요. 접속이 한 번 되면 기기는 그 네트워크를 기억하므로, 손님 기기에서 문제가 반복되면 게스트 망의 기기 수 제한도 함께 확인해야 합니다.
이 도구의 한계
이 도구의 한계
- SSID·비밀번호가 실제 공유기 설정과 같은지는 검사하지 않습니다. 기기로 스캔해 확인해야 합니다.
- 로고 삽입, 색상 변경, 벡터 저장은 지원하지 않습니다. PNG 한 장만 내려받습니다.
- 5GHz 와 2.4GHz 를 같은 이름으로 운영하면 기기가 알아서 고르며, QR 로 대역을 지정할 수 없습니다.
- 스캔 후 연결 확인 창이 뜨는 방식은 기기·운영체제 버전에 따라 다릅니다.
- 입력값은 화면 상태로만 존재하고 저장되지 않으므로, 새로고침하면 사라집니다.
확인한 출처
- zxing — Barcode Contents (WIFI) — 와이파이 QR 문자열의 사실상 표준 형식(T/S/P/H, 백슬래시 이스케이프)
- Wi-Fi Alliance — Security — WPA2·WPA3 등 보안 방식의 차이
최종 확인 2026-10-31. 표의 수치는 위 문서와 이 사이트 코드에서 확인한 값입니다.