Wi-Fi QR은 읽히는데 연결되지 않을 때: 이름·암호·특수문자 점검
일반 텍스트 QR에 Wi-Fi 연결 문자열을 담을 때 SSID, 인증 방식, 구분 문자와 공개 범위를 나눠 확인합니다.
먼저 수동 연결이 되는지 확인
같은 기기에서 공유기의 실제 네트워크 이름을 골라 수동 연결부터 시험합니다. 수동으로도 실패하면 QR을 다시 만들어 해결될 문제라고 단정하지 않습니다. 공유기 관리자 안내에서 인증 방식, 게스트 네트워크 제한, 비밀번호를 확인하고, 권한 없는 공유기의 설정은 바꾸지 마세요.
수동 연결이 되면 QR을 문자열만 읽는 도구로 확인합니다. 일반 텍스트가 아닌 Wi-Fi 구성 문자열이어야 연결 요청을 해석할 수 있습니다. 이 사이트에는 전용 Wi-Fi 입력 폼이 없으며 URL·텍스트 QR 입력칸에 이미 검수한 문자열을 넣는 방식입니다. 실제 암호를 공개 문의나 스크린샷에 넣지 않습니다.
- 같은 기기의 수동 연결 시험
- 공유기 이름·인증 방식 확인
- QR 원문 문자열 읽기
- 암호가 담긴 이미지 공개 금지
구분자와 특수문자를 분리해서 보기
ZXing 프로젝트의 제안 형식은 예를 들어 WIFI:T:WPA;S:GuestDemo;P:demo-only-123;;처럼 인증 유형 T, 이름 S, 암호 P를 구분합니다. 이것은 설명용 가상 이름·암호입니다. 실제 공유기와 기기에서 지원하는 방식과 다를 수 있으며, WPA2-EAP 같은 기업용 인증은 이 단순 예시로 다루지 않습니다.
이름이나 암호에 세미콜론, 콜론, 쉼표, 역슬래시, 큰따옴표가 들어가면 일반 구분 문자와 혼동하지 않도록 ZXing 문서에 따른 역슬래시 이스케이프가 필요합니다. 가정 이름 Guest;Room은 S:Guest\;Room;처럼 세미콜론 앞에 역슬래시를 둡니다. 암호의 실제 문자를 바꾸는 것이 아니라 QR 문자열에서 표현을 바꾸는 작업입니다.
- WIFI 접두사와 필드 확인
- 실제 인증 방식 일치
- 특수문자 이스케이프
- 끝 구분자와 의도하지 않은 줄바꿈 확인
내려받은 파일로 결과와 노출 범위를 검수
가상 이름으로 만든 QR을 다시 읽어 문자열이 입력값과 같은지 확인한 뒤, 운영자가 허용한 게스트 네트워크에서 실제 기기로 연결을 검수합니다. 카메라가 문자열을 보여주는 것과 시스템이 Wi-Fi 연결을 제안하는 것은 별개입니다. 지원하지 않는 리더라면 기본 카메라나 운영체제 네트워크 설정을 확인합니다.
암호를 넣은 QR은 누구든 읽을 수 있는 형태의 공유물입니다. QR을 만든다고 암호가 암호화되거나 접근 통제가 생기는 것은 아닙니다. 직원용 네트워크 암호를 안내판에 공개하지 말고 공유 범위를 먼저 정하세요. 기존 암호를 바꾸면 옛 QR은 새 암호를 자동으로 받지 않으므로 재생성·교체가 필요합니다. 잘못된 네트워크로 연결되거나 지원 방식이 불분명하면 배포를 중단합니다.
- 다운로드 결과 재디코딩
- 허용된 실제 기기 연결 검수
- 게스트 공유 범위 결정
- 암호 변경 시 옛 QR 교체
이 방법으로 해결되지 않는 경우
- ZXing Wi-Fi 문자열은 모든 카메라와 운영체제에서 동일하게 지원되는 보편적 연결 보증이 아닙니다.
- 기업용 인증, 인증서, 포털 로그인 및 WPA3 전용 환경은 이 기본 예시로 해결하지 않습니다.
- 암호를 담은 QR을 보호·암호화하거나 공유기의 접근 권한을 변경하지 않습니다.
바로 실행하기
URL·텍스트 QR 만들기 열기 →이미지 속 QR 읽기 열기 →근거 자료
형식과 기능 설명은 아래 공식 문서와 표준을 우선 확인했습니다.