hostapd 使用指南

一、工具简介

hostapd 是用于管理无线接入点的软件，可配合支持 AP 模式的无线网卡创建 Wi-Fi 热点。本文介绍基本配置和启动方法。组件来源及 SDK 源码包位置见 hostapd 组件简介。

本文命令在开发板 Linux 终端执行，示例以 wlan0 为无线接口。实际接口名、驱动能力、配置及网络服务请以所用固件和硬件为准。本文为通用示例，尚未在 CW080 实板验证。

二、使用前准备

1. 确认开发板已启动 Linux，且已安装可执行的 hostapd。

2. 确认无线网卡及驱动支持 AP 模式，并查看实际接口名：

   ip link showcommand -v hostapd

3. 准备管理员权限。若接口正被其他网络管理服务占用，需先按实际系统的管理方式解除占用，避免配置冲突。

三、配置并启动热点

在开发板上创建 /tmp/hostapd.conf，写入以下示例：

interface=wlan0driver=nl80211ssid=CW080_Testhw_mode=gchannel=6wpa=2wpa_passphrase=TestPass123wpa_key_mgmt=WPA-PSKrsn_pairwise=CCMP

将 interface 改为实际接口名，ssid 改为所需热点名称，wpa_passphrase 改为 8～63 个字符的密码。示例密码仅用于说明，实际使用时请更换。nl80211、频段和信道须受驱动、硬件及当地无线电规定约束。

在开发板终端前台启动：

hostapd /tmp/hostapd.conf

观察终端日志；出现 AP-ENABLED 后，可用手机搜索示例热点并尝试连接。按 Ctrl+C 停止进程。/tmp 中的配置通常不会在重启后保留。

四、地址分配与排查

hostapd 负责热点管理和无线认证，不负责自动提供 DHCP 或互联网接入。如需客户端获取 IP 地址或访问外网，还需另行配置地址、DHCP、路由及必要的转发规则，具体取决于系统网络方案。

启动失败时，请先检查接口名、AP 模式支持情况、信道与驱动配置，并查看终端报错。能够搜索到热点不代表客户端已经获取 IP 或能够访问外网。