WiFi 二维码

SSID/密码→连接二维码

413 次访问

WiFi 二维码生成

扫码即连 · 符合 ZXing 联盟标准 · iOS 11+ / Android 10+ 内置相机原生支持 · 微信 / 支付宝扫一扫均可识别

📱 扫码自动连接 WiFi

使用场景

· 家庭场景:贴在路由器旁,客人扫码自动连 WiFi,免去念长密码

· 咖啡馆 / 餐饮:印在桌牌 / 菜单上,顾客快速接入

· 企业 / 会议:会议室 WiFi 二维码,参会者一扫即连

· 格式标准WIFI:T:WPA;S:ssid;P:password;;(ZXing 联盟规范)

· 兼容性:iOS 11+ 相机内置 / Android 10+ 全面支持 / 微信 / 支付宝扫一扫识别

关于本工具

了解工具定位 · 使用场景 · 对比优势

输入 WiFi 的 SSID 和密码,一键生成可直接扫码连接的二维码。餐厅、咖啡馆、酒店前台打印张贴,或分享给访客,免去手动输入密码的麻烦。所有数据在浏览器内处理,不上传服务器。

使用场景

🏠

家庭访客连网

朋友或亲戚到家做客,问 Wi-Fi 密码是高频场景。口头说一遍容易记错大小写或特殊符号,手机截图又担心隐私泄露。使用本工具将 SSID 和密码生成二维码,打印贴在玄关或冰箱上,客人扫码即连,无需手动输入,省去反复沟通的麻烦。

店铺顾客引流

咖啡馆、餐厅、理发店等线下门店,Wi-Fi 是留住顾客的基础服务。店员每次报密码影响工作效率,手写纸条易丢失。将门店 Wi-Fi 信息生成二维码,制作成桌牌或收银台立牌,顾客到店扫码自动连接,提升服务体验的同时减少人工成本。

🏢

办公访客接待

公司前台每天要接待多位访客,逐一告知 Wi-Fi 密码既耗时又容易出错。不同部门可能使用不同 SSID,访客混淆后无法联网。将公司访客专用 Wi-Fi 生成二维码,打印在前台登记表或访客胸卡背面,访客扫码即连,提升接待效率与专业形象。

🏨

民宿酒店入住

民宿或小型酒店住客办理入住后,常需通过短信或口头获取 Wi-Fi 密码,容易遗忘或输错。将客房 Wi-Fi 信息生成二维码,打印在房卡套或入住须知上,住客扫码即连,减少前台咨询量,提升入住体验与好评率。

🎉

活动聚会共享

线下沙龙、派对、团建等临时聚会,参与者需要快速联网。组织者现场口头报密码,声音嘈杂时不易听清。提前用本工具生成 Wi-Fi 二维码,投屏到现场大屏或打印在活动手册上,参与者扫码即连,避免因联网问题打断活动流程。

对比矩阵本工具 vs 竞品 vs 传统方法

维度本工具竞品 A传统方法
数据隐私纯浏览器端生成,WiFi 信息不上传服务器部分在线工具需上传 SSID/密码至服务器生成二维码需将密码告知他人或打印贴出,存在泄露风险
处理速度输入后即时生成,无网络延迟受网络和服务器负载影响,通常 1-3 秒手动制作二维码或打印,耗时数分钟至数小时
离线可用完全离线,断网环境下仍可生成需要网络连接,断网无法使用完全离线,但需额外软件或手工操作
生成格式标准 PNG 格式二维码,通用性强通常支持 PNG,部分支持 SVG 或 PDF格式取决于手工方式(手绘/打印/专业软件导出)
操作步骤仅需输入 SSID 和密码,一键生成需填写 SSID、密码、加密类型等字段,步骤较多需打开设计软件/手绘,步骤繁琐且易出错
适用场景个人快速分享家庭/公司 WiFi需要批量生成或定制样式的场景无网络环境或对二维码质量无要求的临时场景

使用指南

上手步骤 · 输入输出 · 避坑提示

使用步骤

  1. 在「SSID」输入框填写 WiFi 名称(区分大小写,最长 32 字符)
  2. 在「密码」输入框填写 WiFi 密码(可选,留空生成开放网络二维码)
  3. 选择加密类型:WPA/WPA2/WPA3 或「无加密」
  4. 点击「生成二维码」按钮,页面即时显示二维码图像
  5. 右键点击二维码图片,选择「另存为」保存为 PNG 文件

输入输出示例7 个典型场景,覆盖常规、边界与易错

输入输出说明
SSID: MyHomeWiFi 密码: 12345678二维码图像(编码内容:WIFI:S:MyHomeWiFi;T:WPA;P:12345678;;)典型场景:家庭 WPA2 加密网络
SSID: 咖啡厅-免费WiFi 密码: (留空)二维码图像(编码内容:WIFI:S:咖啡厅-免费WiFi;T:nopass;;)典型场景:无密码的开放式公共网络
SSID: Guest_5G 密码: Aa@2024#Secure!二维码图像(编码内容:WIFI:S:Guest_5G;T:WPA;P:Aa@2024#Secure!;;)边界 case:密码含特殊字符 @#!,需正确编码
SSID: (留空) 密码: 12345678错误提示:SSID 不能为空边界 case:SSID 为空,工具应阻止生成
SSID: 办公室WiFi 密码: 这是长度超过63个字符的密码测试用例,用于验证工具是否能够正确处理超长密码输入,避免生成错误的二维码导致设备无法连接错误提示:密码长度超过 63 个字符(WPA2 标准限制)易错 case:超长密码会被路由器拒绝
SSID: \"Quoted\"SSID 密码: pass二维码图像(编码内容:WIFI:S:\"Quoted\"SSID;T:WPA;P:pass;;)边界 case:SSID 含双引号,需转义处理
SSID: 隐藏网络 密码: hidden123 勾选:隐藏网络二维码图像(编码内容:WIFI:S:隐藏网络;T:WPA;P:hidden123;H:true;;)典型场景:不广播 SSID 的隐藏网络

常见错误对照8 个常踩的坑 · 错误 → 修复

1. SSID 中包含冒号、分号或反斜杠未转义

错误
SSID: "Guest:Free"
修复
SSID: "Guest\:Free"(或直接避免使用这些字符)

WiFi 二维码使用 WPA2-Enterprise 格式(RFC 2865),冒号和反斜杠是保留字符,需要反斜杠转义,否则二维码扫描器解析错误

2. 密码中包含空格但未用引号包裹

错误
密码: abc 123
修复
密码: "abc 123"(或确保密码字段整体被引号包裹)

部分二维码生成器在生成 WIFI:S:SSID;T:WPA;P:password;; 格式时,密码中的空格会导致解析器只取空格前部分

3. 加密类型选错(WPA 与 WPA2 混用)

错误
路由器实际是 WPA2-PSK,但选择 "WPA" 类型
修复
选择 "WPA2"(或 "WPA/WPA2" 兼容模式)

WiFi 二维码标准(ISO/IEC 18004)中 T 字段值 WPA 和 WPA2 不互通;选错会导致旧设备连接失败

4. SSID 包含 Unicode 字符但未编码

错误
SSID: "咖啡厅"(直接输入中文)
修复
SSID: "\u5496\u5561\u5385"(或使用 UTF-8 编码的二维码生成器)

部分旧版二维码扫描器不支持非 ASCII 字符;使用 Unicode 转义序列可保证跨设备兼容性

5. 隐藏 SSID 的网络未添加隐藏标识

错误
仅输入 SSID 和密码,未勾选 "隐藏网络" 选项
修复
在二维码参数中添加 H:true(如 WIFI:S:MyNet;T:WPA;P:pass;H:true;;)

隐藏 SSID 的网络需要 H:true 参数,否则手机不会主动发送探测请求,连接失败

6. 密码为空时未使用开放式网络类型

错误
密码留空但选择 WPA/WPA2 加密类型
修复
选择 "无加密"(T:nopass)类型,并留空密码字段

WPA/WPA2 要求密码非空;空密码必须用 T:nopass 类型,否则设备会拒绝连接

7. SSID 包含特殊符号如 # 或 % 未 URL 编码

错误
SSID: "Home#WiFi"
修复
SSID: "Home%23WiFi"(或确保生成器自动处理)

部分二维码生成器将 SSID 直接嵌入 URL 参数,而 # 和 % 在 URL 中有特殊含义,需编码

8. 将 5GHz 频段 SSID 与 2.4GHz 混用

错误
路由器有 2 个 SSID(MyNet-5G 和 MyNet),只生成一个二维码
修复
为每个频段分别生成二维码,或使用路由器双频合一功能

5GHz 和 2.4GHz 频段的 SSID 可能不同;旧设备不支持 5GHz,混用会导致连接失败

工作原理

公式推导 · 流程图解 · 依据出处

核心公式

QR = encode( WIFI:S:<SSID>;T:<encryption>;P:<password>;; )

变量说明

  • SSID — WiFi 网络名称(SSID)
  • encryption — 加密类型:WPA/WEP/nopass
  • password — WiFi 密码(nopass 时省略)
  • QR — 生成的二维码图像数据

示例

SSID="CoffeeShop", 加密 WPA, 密码 "guest123"。编码字符串为 "WIFI:S:CoffeeShop;T:WPA;P:guest123;;"。二维码生成器将其转换为 QR 码矩阵(版本 2-M,25×25 模块),最终输出 PNG 图片。

适用范围

遵循 ISO/IEC 18004 QR 码标准及 IEEE 802.11 WiFi 配置规范。适用于所有支持 WPA/WEP/无加密的 2.4GHz/5GHz 网络。不适用于企业级 802.1X 认证(需额外证书配置)或隐藏 SSID 网络(需手动添加 H:true 参数)。

原理图

用户输入SSID / 密码浏览器内计算QR 编码生成展示结果二维码图片输入字段说明• SSID:WiFi 网络名称• 密码:WiFi 连接密码• 加密类型:WPA/WPA2/WEP输出说明• 标准 WiFi 二维码• 兼容主流手机相机• 可下载 / 复制图片
用户输入 本地处理 输出结果

开发者集成

3 种主流语言 · 复制即用

import qrcode

# 生成 WiFi 连接二维码(WPA/WPA2 加密)
ssid = "MyHomeWiFi"
password = "securepass123"
# WiFi 配置字符串格式:WIFI:T:WPA;S:<SSID>;P:<PASSWORD>;;
wifi_config = f"WIFI:T:WPA;S:{ssid};P:{password};"

# 生成二维码图像
qr = qrcode.QRCode(box_size=10, border=4)
qr.add_data(wifi_config)
qr.make(fit=True)
img = qr.make_image(fill_color="black", back_color="white")
img.save("wifi_qr.png")
print("二维码已保存为 wifi_qr.png")
package main

import (
	"fmt"
	"github.com/skip2/go-qrcode"
)

func main() {
	ssid := "Office_Guest"
	password := "guest2024"
	// 无加密网络使用 nopass
	wifiConfig := fmt.Sprintf("WIFI:T:WPA;S:%s;P:%s;;", ssid, password)

	// 生成 PNG 二维码
	err := qrcode.WriteFile(wifiConfig, qrcode.Medium, 256, "wifi_qr.png")
	if err != nil {
		panic(err)
	}
	fmt.Println("二维码已生成: wifi_qr.png")
}
// 使用 qrcode 库(npm install qrcode)
const QRCode = require('qrcode');

const ssid = 'Cafe_FreeWiFi';
const password = 'coffee123';
// 支持 WPA/WPA2 加密
const wifiConfig = `WIFI:T:WPA;S:${ssid};P:${password};;`;

// 生成 base64 图片数据
QRCode.toDataURL(wifiConfig, { width: 300 }, (err, url) => {
  if (err) throw err;
  console.log('二维码 base64 数据:', url.substring(0, 50) + '...');
  // 可直接用于 <img src="...">
});

// 同步版本(Node.js 18+)
const generateQR = async () => {
  const url = await QRCode.toDataURL(wifiConfig, { width: 300 });
  console.log('二维码已生成');
};
generateQR();

常见问题

8 个高频疑问

生成的二维码别人扫了能直接连上我的WiFi吗?
可以。扫码后手机会自动弹出加入WiFi网络的提示,输入SSID和密码后生成的二维码遵循WPA/WPA2标准格式,主流手机(iPhone、Android)的相机App或系统设置中的扫码功能都能识别。注意:如果WiFi网络是WPA3加密或企业级认证(如802.1X),则无法通过这种方式直接连接,二维码只支持个人WPA/WPA2/无密码网络。
为什么我生成的二维码别人扫了显示“无法加入网络”?
最常见的原因是SSID或密码输错了——注意区分大小写和特殊字符,比如WiFi名中的空格或下划线容易漏掉。另外,如果WiFi网络开启了隐藏SSID(不广播名称),部分手机扫码后可能找不到网络,需要手动输入SSID。建议先在本工具生成的二维码下方显示的文本预览里核对一遍,确认SSID和密码完全一致。
这个工具能生成WiFi二维码但没网络也能用吗?
可以离线使用。整个生成过程在浏览器内完成,不依赖服务器——输入SSID和密码后,代码直接在前端拼接出标准格式的WiFi配置字符串,再生成二维码图片。关闭网络后打开页面,工具依然能正常生成二维码。如果担心隐私,可以断网后使用,数据完全不经过网络。
生成的二维码有没有有效期?会过期吗?
二维码本身没有有效期,它只是一段静态文本的图形编码,只要WiFi网络的SSID和密码不变,二维码永久有效。但如果更改了WiFi密码或SSID,就需要重新生成。建议生成后保存二维码图片,方便后续打印或分享。注意:二维码图片文件本身不会自动失效,但存储介质(如手机相册、纸张)损坏后需要重新生成。
这个工具和微信小程序里的WiFi二维码生成器有什么区别?
主要区别在于隐私和便捷性。本工具纯浏览器运行,不收集任何用户数据,也不需要登录或授权;微信小程序通常需要获取位置信息或相册权限,且数据可能经过腾讯服务器。另外,本工具生成的二维码图片支持直接下载为PNG或SVG格式,方便打印或嵌入到网页/文档中;微信小程序通常只能保存到手机相册,格式有限。
我输对了密码但生成的二维码扫出来是乱码,怎么回事?
可能是密码中包含特殊字符(如中文、引号、反斜杠等)未正确编码。本工具在生成二维码时会自动对SSID和密码进行URL编码,但极少数旧款手机或第三方扫码App可能不支持UTF-8编码的WiFi配置。建议将密码中的中文改为英文,或使用纯数字/字母组合测试。如果问题持续,可以尝试用系统自带的扫码功能(如iOS相机或Android系统设置中的扫码)而非第三方App。
生成的二维码能用在公共场所的访客WiFi上吗?
可以,但只适用于不需要登录页或验证码的开放式或密码保护的WiFi。如果访客WiFi需要先打开浏览器输入手机号验证或接受条款(即Captive Portal),则二维码无法直接跳过该步骤——它只能携带SSID和密码信息。对于这类网络,建议将二维码贴在显眼处,访客扫码连接后仍需手动完成认证。
为什么我生成的二维码图片下载后背景是透明的?
本工具默认生成透明背景的二维码,方便用户叠加到其他图片或文档上。如果需要白色背景,可以在工具界面上切换背景色选项(如果有提供)。透明背景的PNG图片在浅色背景上显示正常,但在深色背景上可能看不清,建议根据使用场景选择背景色。如果工具未提供背景色选项,可以下载后用图片编辑软件添加白色背景。
选择 打开 +新窗口 esc关闭