给客人用的 WiFi 二维码:一次就连上的写法

前台贴着"WiFi 密码:xk3#9pt",客人蹲下来一位一位敲,还是敲错;改成一句"扫码自动连网",投诉能少一半。但前提是这个码写对了——连网码对格式极其挑剔,一个小写错的字符就会让它彻底无效。

这篇把连网码拆到字符层面,讲清餐饮门店、民宿客房和办公室访客网络各自该注意什么,也讲清哪些事二维码做不到(比如酒店那种网页登录)。

为什么访客网络值得单独一张码

把主网络的密码印在桌牌上,等于把内网权限发给每一位进店的陌生人:装了 NAS 的、有打印机的、连着收银机的内网,全在同一张网里。规范做法是给访客单独开一个 SSID,开启客户端隔离,限制带宽,密码按月轮换,主网络只给员工。

这时二维码的价值不只是省事:它让"给访客一个专用网络"变成一件不增加人力的事。前台不用再帮人输入,客人也不用问。

需要提前算一笔账:静态连网码把密码烧死在纸上,换密码就必须重印。月租型门店可以用亚克力插牌、换内页;一次性活动则无所谓。

连网码里到底写了什么

被编码的字符串长这样:

WIFI:T:WPA;S:巷口咖啡-访客;P:xk3#9pt;;

四个字段用分号隔开:T: 加密类型、S: 网络名称(SSID)、P: 密码,最后再多一个分号收尾。隐藏网络会多一个 H:true;。手机系统把这一串读成结构化数据,于是直接弹"是否加入这个网络",而不是把它当成一段文字显示。

也就是说,这不是某个 App 的私有协议,而是 iOS 和安卓系统相机都认的公共格式。这也是为什么它必须精确——解析器不看你的意图,只看分号。

必须转义的五个字符

SSID 和密码里的 \、;、,、:、" 前面都要加一个反斜杠。理由很直接:解析器用分号切字段,遇到一个没转义的分号,它就会在错误的位置断开。

举个中文场景:门店把网络命名成巷口咖啡;二楼,密码设成tea,2026。不转义的话,手机读到的 SSID 只有"巷口咖啡",后面那个"二楼"被当成下一个字段的开头;密码里的逗号又会把 tea 和 2026 拆开。结果是密码明明没错,怎么扫都连不上。

这类密码在设计时很容易撞上:很多人喜欢用标点当分隔(wifi;2026、cafe:guest),恰好就是最危险的那几个字符。如果密码还能改,建议避开这五个符号,改用大小写字母加数字;如果改不了,务必用带转义的工具生成,别手工拼字符串。

另一个常见坑是中文 SSID。中文在二维码里按 UTF-8 编码,每个汉字占三个字节,容量消耗比英文大三倍;更要紧的是,某些老机型或第三方扫码 App 会把字节按 GBK 解读,显示成一串乱码。稳妥的做法是让访客网络的名字保持英文或拼音,中文名只作为宣传叫法。

加密类型怎么填

家用和商用路由器现在基本都是 WPA2 或 WPA3,在码里统一写 WPA。这个格式定下来的年代还没有 WPA3,所以标准里没有单独的 WPA3 值;路由器固件会把 T:WPA 当作"用 WPA 系列里最强的那个",WPA3 网络照样能连。

WEP 早就该淘汰了,但如果现场留着老设备(老式点餐机、老打印机),生成器里也保留了 WEP 选项。开放式网络写 nopass,并且不要带 P: 字段——带一个空密码字段,部分安卓机型反而会弹出输入框。

隐藏 SSID 与网页认证

把 SSID 设成不广播,会让手机在扫码前看不到这个网络。此时要在码里加上 H:true;,手机才知道"这是个隐藏网络,我该主动去连"。不加这一项,扫码后什么也不会发生——因为手机认为附近没有这个网络。

需要澄清一个常见误解:连网码只能做到"连上",做不到"通过网页认证"。酒店、机场、商场常见的那种先连上再跳出一个登录页(captive portal)的流程,仍然需要客人自己点开浏览器、输入房号或手机号。二维码帮他把最麻烦的一步(找网络、输密码)省掉了,剩下的认证必须由人完成。

如果场地用的是微信连 Wi-Fi 之类的服务,流程通常是:扫码 → 打开一个网页 → 授权 → 路由器放行。这种场景该做的是普通网址码,指向那家服务商给的页面,而不是 WiFi 码。

印在哪里,印多大

桌牌上的连网码,客人一般坐在 40 到 60 cm 处举手机扫,边长 3 cm 就够;贴在门上的迎宾码,人站着扫,距离约 1 米,边长建议 6 到 8 cm。前台那种"扫码连网"的立牌,10 cm 更稳妥,因为常有人隔着一臂远随手扫一下。

位置比尺寸更重要:不要贴在玻璃反光面后面,不要贴在深色木纹上(背景对比度不足),也不要让码的下半部分被花盆挡住。见过最典型的一次失败,是码印在了深棕色吧台的贴纸上,前景深灰、背景深棕,白天看着优雅,晚上完全扫不出。

顺带提醒:覆膜会反光。哑光膜比亮膜好;如果一定要亮膜,把码印在略偏的位置,避开射灯直射点。

安全上的几条建议

还有一点容易被忽略:连网码会把密码暴露给任何扫它的人,这是它的功能,不是漏洞。所以它适合"愿意给陌生人用的网络",绝不能用于员工内网。

三分钟做一张

打开生成器,切到 WiFi 标签,填名称、密码、加密方式,隐藏网络就勾上那一项。下面的"编码内容"会显示真正被编码的字符串——看到 \; 这种反斜杠就对了,说明分号被正确转义。

尺寸给 512 px 以上,下载 SVG 交给印厂(矢量放大不失真);如果只是打印在 A4 纸上自己裁,PNG 给 1024 px 也够。印出来之后,用两台不同的手机各扫一次——一台 iPhone、一台安卓——确认都能直接弹加入网络。这一步能挡住绝大多数现场尴尬。

常见问题

扫码后提示"无法加入网络"怎么办?

先核对三件事:加密类型是否选错(WPA 网络选了 WEP)、密码里是否有未转义的标点、SSID 是否包含中文。这三项占现场故障的绝大多数。

iPhone 能扫,安卓扫不出来?

可能是那一台安卓用了第三方扫码 App,只把内容当文本显示,不识别 WIFI: 协议。改用系统相机或系统自带的扫码入口再试。另外,中文 SSID 的编码差异也会造成这种"一边行一边不行"。

改密码之后旧码还能用吗?

旧码里还是旧密码,连不上。静态码没法远程修改,只能重印。这也是把码做成可替换插页的理由。

本文由 QRQuick 团队撰写。最后更新:2026 年 11 月 19 日。