Wi-Fi 二维码

又称: WiFi 二维码, WIFI: URI, 无线网络二维码, 扫码连 Wi-Fi

定义

Wi-Fi 二维码存储网络名称、密码和加密类型,手机扫一下就能加入网络,无需输入。它的文本形如 WIFI:T:WPA;S:MyNetwork;P:secret;;。

WIFI: 格式

Wi-Fi 二维码里存的是一行以 WIFI: 开头的文本,列出用分号分隔的字段,并以两个分号结尾。对于典型的家庭或办公室网络,它写成 WIFI:T:WPA;S:MyNetwork;P:secret;;,其中 T 是加密类型,S 是网络名称(SSID),P 是密码。

这种格式源自开源的条码读取器项目,后来成为事实上的约定。Wi-Fi 联盟的 WPA3 规范在近期版本中描述了一种与之密切相关的 URI 格式,为较新的安全功能增加了可选字段。

  • T:加密类型,通常是 WPA、WEP,或表示开放网络的 nopass
  • S:网络名称(SSID),与显示的完全一致,区分大小写
  • P:密码;开放网络可省略
  • H:true 表示隐藏网络,即不广播名称的网络

加密类型与特殊字符

WPA 这个值用于 WPA、WPA2,实际上也用于大多数 WPA3 个人版网络,因为手机在连接时会协商具体的协议。WEP 已经过时且不安全,nopass 则用于没有密码的开放网络。需要用户名和证书的企业级网络,用这种简单格式并不合适。

如果网络名称或密码中含有反斜杠、分号、逗号、冒号或双引号,就必须用反斜杠转义该字符。例如,写成 pass;word 的密码,要编码为 pass\;word。弄错这一点,是 Wi-Fi 二维码能扫出来却连不上的最常见原因之一。

手机支持与良好做法

iPhone(约从 iOS 11 起)和安卓(约从 Android 10 起)的自带相机应用都能识别 Wi-Fi 码,并提示加入网络。较旧的手机可能需要另外的扫描应用。

密码以明文存在二维码里,所以任何能扫描它的人都能读到密码。访客网络很适合用它,而且每当密码更改,就必须重新生成二维码,因为文本固定在印出来的图像里。

常见问题

怎样为我的 Wi-Fi 制作二维码?

把文本 WIFI:T:WPA;S:你的网络名称;P:你的密码;; 编码成二维码,替换其中的名称和密码。扫描后,大多数手机会提示加入该网络。

Wi-Fi 二维码适用于 WPA3 吗?

大多数情况下适用。使用 T:WPA 通常对 WPA2 和 WPA3 个人版网络都有效,因为手机连接时会协商协议。

为什么我的 Wi-Fi 二维码能扫出来却连不上?

常见原因是网络名称输错了(它区分大小写)、密码改了,或者 ; , : 或 \ 这类特殊字符没有用反斜杠转义。

张贴 Wi-Fi 二维码安全吗?

任何扫描它的人都能读到密码,所以只对你愿意分享的网络张贴,比如单独的访客网络。

全部术语