Wi-Fi 卡:轻松连接无烦恼
每当有客人来访或同事聚在一起开会时,同样的对话就开始了。"Wi-Fi 密码是什么?"——然后你开始念一串奇怪的十六位字符,大写"O"和零混在一起,小写"l"和一也分不清。当然,你可以给路由器上的贴纸拍张照,但看起来很糟糕,而且路由器通常藏在某个柜子里,被一堆线缆压在下面。
wifi-card 项目以一种简洁优雅的方式解决了这个日常小烦恼。它是一个轻量级的二维码生成器,可以生成包含无线网络登录信息的精美卡片。
项目工作原理
本质上,这是一个 React 前端应用,直接在浏览器中生成卡片。你输入网络名称(SSID),选择加密类型(WPA/WPA2/WPA3、WEP 或开放网络),输入密码,然后点击打印按钮即可。
iOS 或 Android 上的智能手机摄像头可以用标准扫描器读取生成的二维码,并立即提示连接网络。客人不再需要手动输入密码。
作者在隐私保护方面的设计值得额外加分。你的数据不会发送到任何地方:服务完全在客户端运行,没有服务器后端,也不收集任何遥测数据。
生成器功能
卡片有几个贴心的细节设计:
- 密码隐藏。如果卡片要放在半公共场所,你可以隐藏密码文本字段,只保留二维码。
- 支持隐藏网络(Hidden SSID)。即使网络不广播其名称,手机也知道如何设置连接。
- 打印就绪的布局。卡片居中显示,边框精美,在普通 A4 纸和厚卡纸上打印效果都很好。
- 多语言支持。项目已被翻译成近 40 种语言,包括俄语,因此来自任何国家的客人都能看懂卡片。
如何自行运行
如果你不想使用公共的 wificard.io 网站,或计划将工具部署到公司内部局域网,项目可以很方便地在本地运行。
最快的方式是使用官方 Docker 镜像:
make run
容器将在 http://localhost:8080 上启动。
对于本地开发或布局调整,你需要 Node.js 和 Yarn:
# Установка зависимостей и запуск dev-сервера
make dev
带有热重载功能的服务器将在 http://localhost:3000 上打开。项目已配置 Prettier,代码格式化会在提交前通过 pre-commit hooks 自动检查。
如果你想添加新的翻译,只需扩展 src/translations.js 文件:
{
id: 'de-DE', // код локали
name: 'German - Deutsch', // отображаемое имя
rtl: false, // true для языков с письмом справа налево
translation: {
...
}
}
适用场景
我打印了一张这样的卡片,用磁铁贴在家里的冰箱上。节假日期间省了不少时间。
除了家庭使用,这种格式还非常适合:
- 联合办公空间和办公室会议室,这样访客就不用来回打扰系统管理员了。
- 提供密码保护访客 Wi-Fi 的小咖啡馆或理发店。
- 出租公寓和酒店,在入口处直接展示登录凭证。
wifi-card 是一个出色的小型开源项目范例,它专注于一个狭窄的任务,无需臃肿的界面和侵入式的追踪器就能解决问题。源代码简洁干净,一行命令即可运行,接待客人时再也不用费神念密码了。如果你经常需要念 Wi-Fi 密码,打印一张这样的卡片吧,一劳永逸。
相关项目

