cjimti/iotwifi

IOT Wifi（树莓派AP + 客户端模式）

![Go Report Card]([] ![GoDoc]([]

IOT Wifi是一款适用于树莓派的WiFi管理容器，支持同时运行站点（Station）和接入点（AP）模式，允许通过WiFi完成WiFi配置。它基于Go语言开发，以Docker容器形式运行，提供REST API接口用于程序化配置或自定义用户界面。

• 访问 [*] 获取入门指南**。
• 访问 https://github.com/cjimti/iotwifi 获取源代码，若当前镜像不适用可自行构建。

!https://raw.githubusercontent.com/cjimti/iotwifi/master/doc_assets/pi.jpg

IOT Wifi通过配置网络接口，同时运行hostapd、wpa_supplicant和dnsmasq工具。用户或其他服务可通过hostapd/dnsmasq连接到树莓派，通过API命令配置wpa_supplicant连接到其他AP。它还暴露小型Web服务器，提供JSON格式的REST API用于WiFi配置，支持构建自定义Captive Portal页面或程序化连接配置目标设备。

核心功能

1. 同时运行AP模式（hostapd + dnsmasq）和Station模式（wpa_supplicant）
2. 提供JSON格式的REST API，用于配置WiFi连接
3. 支持自定义Captive Portal页面，简化用户配置流程
4. 可通过外部配置文件调整参数

使用场景

• IoT设备的初始WiFi配置（无需物理连接即可设置联网）
• 树莓派作为无线网关或中继设备
• 程序化管理树莓派的WiFi连接状态

配置说明

快速开始

禁用主机上的wpa_supplicant：

bash
# 阻止wpa_supplicant开机启动
$ sudo systemctl mask wpa_supplicant.service

# 终止所有运行中的wpa_supplicant进程
$ sudo pkill wpa_supplicant

获取默认配置文件：

bash
# 下载默认配置文件
$ wget https://raw.githubusercontent.com/cjimti/iotwifi/master/cfg/wificfg.json

运行容器：

bash
$ docker run --rm --privileged --net host \
      -v $(pwd)/wificfg.json:/cfg/wificfg.json \
      cjimti/iotwifi

更多信息

请访问 [*] 获取详细说明和入门指南。**