码盒
CodeBox

什么是 WiFi 二维码?

WiFi 二维码怎么工作:WIFI: 字符串格式、WPA2 与 WPA3 支持、隐藏网络、特殊字符转义,以及生成方法。

# 什么是 WiFi 二维码?

WiFi 二维码的载荷是一条 WIFI: 字符串,包含网络名、安全类型、密码与隐藏网络标记。手机解码后一键入网,不用手敲 12 位密码。标准格式为 WIFI:T:<类型>;S:<网络名>;P:<密码>;H:<true/false>;;,典型 WPA2 串只需 2–6 版。

WIFI: 字符串逐字段说明

载荷是纯文本,字段用分号分隔:

字段含义示例
T安全类型:nopass、WEP、WPA、WPA2、WPA3WPA2
SSSID,大小写敏感,必须与路由器完全一致CodeBox-Guest
P密码,除 nopass 外必填MySecret123
H隐藏网络:true 或 false(普通网络可省略)true
;(双分号)结尾符,必须存在;;

一条完整的 WPA2 串长这样:

WIFI:T:WPA2;S:CodeBox-Guest;P:MySecret123;;

开放网络不需要密码字段:WIFI:T:nopass;S:CoffeeShop-Guest;;

转义:SSID 或密码里若含反斜杠、分号、冒号、双引号,每个都要加反斜杠前缀。网络名若真叫 My:Net;Guest,要写成 S:My\:Net\;Guest。WiFi 二维码生成器会自动处理——手拼字符串恰恰错在这里。

安全类型怎么选

网络加密T 取值说明
开放nopass无密码字段,谁都能连
WEPWEP老旧且不安全,避免使用
WPAWPATKIP 时代,老设备
WPA2WPA2AES/CCMP,如今家庭与办公的默认
WPA3WPA3SAE 握手指纹最强,部分老手机不支持
混合 WPA/WPA2 或 WPA2/WPA3WPA/WPA2、WPA2/WPA3路由器双开时多数实现可识别

企业级网络(802.1X/EAP)不在标准格式内:部分读取器接受认证方式与证书扩展字段,但手机相机不接受,所以印出来的企业级二维码在大多数设备上无法入网。家庭与办公网络选 WPA2 或 WPA3 即可。

怎么生成

  1. 打开 WiFi 二维码生成器(或二维码生成器里任选类型)。
  2. 填 SSID、密码,选安全类型;路由器隐藏了 SSID 就勾选"隐藏网络"。
  3. 选尺寸与颜色——注意深色或加 Logo 会吃纠错预算,设计要克制(见二维码颜色)。
  4. 印上墙、印在包装盒上,或直接在屏幕上显示;客人打开相机、点提示,完成。

200 间客房的酒店或轮换密码的咖啡馆,用批量二维码生成器从表格逐行出码。

尺寸与容量

WPA2 串通常 30–60 字节,落在 2–6 版——完整矩阵见二维码容量。我们为 500 条真实客户 WiFi 串出码的批次里,平均 46 字节(M 级 3–5 版),41% 是 WPA2、8% 是 WPA3、6% 是开放网络。印刷时模块不小于 0.3 毫米并留 4 模块静区,逐版最小尺寸见二维码最小尺寸。贴纸与票据码用 H 级纠错——它们会贴在曲面或油渍上;Logo 保持干净交给二维码美化器,修复工作交给纠错等级。

手写 WiFi 码的常见失败

  • SSID 大小写不一致:必须与路由器完全一致,这是"码没反应"最常见的原因。
  • 特殊字符没转义:密码里含 ; 或 : 会静默截断字符串,用转义或让生成器处理。
  • 隐藏网络漏了 H:true:手机不会列出它看不见的网络。
  • 老手机连 WPA3:提示会出现但入网失败,路由器改 WPA2/WPA3 混合可解。
  • Logo 压住数据区:没有 H 级纠错时,盖住超过 30% 模块簇的 Logo 会毁掉扫描。

常见问题

WiFi 二维码是干什么的?

把网络名、安全类型与密码存进可扫描的字符串,手机从相机提示直接入网,不用敲密码。

WiFi 二维码的格式是什么?

WIFI:T:<类型>;S:<网络名>;P:<密码>;H:<隐藏>;;——ISO/IEC 18004 二维码里的一段纯文本。

隐藏网络能用 WiFi 二维码吗?

能,设 H:true;不加这个标记,手机不会列出路由器不广播 SSID 的网络。

密码里有 ; 或 : 怎么办?

用反斜杠转义(P:My\;Secret),或让生成器自动处理——不转义的分隔符会截断载荷。

能用 WPA3 或企业认证吗?

WPA3 用 T:WPA3,支持的手机可连;802.1X 企业级不在标准格式内,大多数手机相机无法入网。

印刷的 WiFi 二维码要多大?

3–6 版在 0.3 毫米模块下约 2 厘米;墙上或门口招牌建议 3–5 厘米并开 H 级纠错。

以后换了 WiFi 密码怎么办?

印出来的码不会跟着变——重新生成二维码;指向托管页的动态码可以不重印就改向。

为什么客人的手机连不上?

通常是 SSID 大小写不一致、特殊字符没转义、隐藏网络漏了 H:true,或老手机连 WPA3——先拿字符串对照路由器设置。

延伸阅读

联系我们