dzonder/wifi-card

bndw/wifi-card (aarch64/Raspberry Pi/Bookworm) 镜像文档

镜像概述

本镜像为bndw/wifi-card的aarch64架构构建版本，专门适配Raspberry Pi设备及Debian Bookworm系统。它提供简洁的Web界面，用于生成包含WiFi网络SSID、密码、加密方式的信息卡片，并自动生成可扫描的QR码，方便移动设备快速连接WiFi网络。

核心功能与特性

• 架构适配：针对aarch64架构优化，完美运行于Raspberry Pi及Bookworm系统
• 功能完整：与原版bndw/wifi-card功能一致，支持WiFi信息展示与QR码生成
• 轻量高效：资源占用低，适合嵌入式设备部署
• 即开即用：无需复杂配置，启动后即可通过Web界面访问

使用场景

• Raspberry Pi作为家庭WiFi信息展示终端
• aarch64架构Bookworm系统设备共享WiFi网络信息
• 小型办公环境或公共场所快速提供WiFi连接指引
• 物联网设备中集成WiFi配置信息展示功能

使用方法与配置说明

基本部署（docker run）

bash
docker run -d -p 80:80 --name wifi-card aarch64-wifi-card

注：实际镜像名称可能需根据镜像仓库命名调整，上述命令为示例格式

访问方式

容器启动后，通过浏览器访问设备IP地址（默认端口80）即可查看WiFi信息卡片：

http://<你的设备IP>

自定义配置（环境变量）

可通过环境变量自定义WiFi信息，常用参数如下：

• WIFI_SSID: WiFi网络名称（必填）
• WIFI_PASSWORD: WiFi密码（必填）
• WIFI_ENCRYPTION: 加密方式（默认：WPA2）
• PORT: 服务端口（默认：80）
• TITLE: 卡片标题（默认：WiFi Card）

带自定义配置的启动示例

bash
docker run -d -p 8080:8080 --name custom-wifi-card \
  -e WIFI_SSID="MyHomeNetwork" \
  -e WIFI_PASSWORD="SecurePass123" \
  -e WIFI_ENCRYPTION="WPA3" \
  -e PORT=8080 \
  -e TITLE="Home WiFi" \
  aarch64-wifi-card

Docker Compose配置示例

yaml
version: '3.8'
services:
  wifi-card:
    image: aarch64-wifi-card
    container_name: wifi-card
    ports:
      - "80:80"
    environment:
      - WIFI_SSID=OfficeWiFi
      - WIFI_PASSWORD=WorkPass456
      - WIFI_ENCRYPTION=WPA2
      - TITLE=Office Network
    restart: unless-stopped

注意事项

• 确保Raspberry Pi或aarch64设备已安装Docker环境
• 若使用非默认端口，需在防火墙中开放对应端口
• 环境变量值中包含特殊字符时，建议使用引号包裹