Skip to content

Armbian 服务器快速开启 Wi-Fi 热点教程 ​

在 Armbian 系统上,利用 nmcli(NetworkManager 命令行工具)可以非常方便地将无线网卡配置为 AP 模式,并共享有线网络(eth0)的互联网连接。相比手动配置 hostapd 和 dnsmasq,这种方法更简单、可靠,且由 NetworkManager 自动处理 DHCP 和 NAT。

本文记录了在 Armbian 服务器上创建热点 H96-AP(密码 12345678)的完整步骤,并支持开机自启。


1. 准备工作 ​

  • 确保你的 Armbian 已安装 NetworkManager(通常默认已安装)。
  • 无线网卡(如 wlan0)支持 AP 模式,且驱动正常。
  • 有线网络(eth0)已连通互联网。

2. 清理旧配置(可选) ​

如果你之前尝试过手动配置热点或其他静态 IP 设置,建议先删除可能冲突的连接配置:

bash
nmcli connection delete Hotspot 2>/dev/null
nmcli connection delete wlan0-static 2>/dev/null

2>/dev/null 用于忽略“连接不存在”的错误提示。


3. 创建热点连接 ​

使用 nmcli 一次性创建完整的 Wi-Fi AP 配置。关键点在于 ipv4.method shared,它会让 NetworkManager 自动为该接口启用 DHCP 服务器,并做 NAT 转发(共享上行网络)。

bash
nmcli connection add \
  type wifi \
  ifname wlan0 \
  con-name Hotspot \
  ssid H96-AP \
  mode ap \
  ipv4.method shared \
  wifi-sec.key-mgmt wpa-psk \
  wifi-sec.psk 12345678

参数说明:

参数含义
type wifi连接类型为 Wi-Fi
ifname wlan0使用的无线网卡
con-name Hotspot连接名称(后续操作使用)
ssid H96-AP热点名称(可自定义)
mode ap工作模式为接入点(Access Point)
ipv4.method shared启用共享模式,自动 NAT + DHCP
wifi-sec.key-mgmt wpa-psk加密方式为 WPA2-PSK
wifi-sec.psk 12345678热点密码(至少8位)

4. 启动热点 ​

bash
nmcli connection up Hotspot

此时,你的手机或其他设备应当能搜索到 H96-AP,输入密码 12345678 即可连接,并且能自动获取 IP 地址(如 10.42.0.x),不再卡在“获取 IP 地址”阶段。


5. 开启 IP 转发并配置 NAT 规则 ​

虽然 ipv4.method shared 会自动设置 NAT,但有时 Armbian 默认未开启 IP 转发,或需要显式添加防火墙规则以确保网络共享正常。建议执行以下命令(一次性设置,重启后需重新执行,后续我们会用开机脚本固化):

bash
# 开启 IP 转发(内核参数)
echo 1 > /proc/sys/net/ipv4/ip_forward

# 清空 NAT 表并添加 MASQUERADE 规则,让流量从 eth0 出去
iptables -t nat -F
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE

# 允许转发所有包(默认策略已为 ACCEPT 时可省略,此处确保)
iptables -P FORWARD ACCEPT

注意:如果你重启了系统,上述 iptables 和 ip_forward 设置会丢失。下文会介绍如何永久保存。


6. 重启热点使规则生效 ​

bash
nmcli connection down Hotspot
nmcli connection up Hotspot

7. 设置开机自动启动热点 ​

bash
nmcli connection modify Hotspot connection.autoconnect yes

这样系统每次启动后,NetworkManager 会自动拉起该热点。


8. 永久保存 IP 转发和 iptables 规则 ​

8.1 永久开启 IP 转发 ​

编辑 /etc/sysctl.conf,取消或添加下面一行:

bash
net.ipv4.ip_forward = 1

然后执行 sysctl -p 使其立即生效。

8.2 永久保存 iptables 规则 ​

安装 iptables-persistent(Debian/Ubuntu 系):

bash
apt update && apt install iptables-persistent -y

在配置好规则后,执行:

bash
iptables-save > /etc/iptables/rules.v4

这样重启后规则会自动恢复。

如果你不希望安装额外软件,也可以将规则写入 /etc/rc.local 或创建一个 systemd service。


9. 日常管理命令 ​

操作命令
关闭热点nmcli connection down Hotspot
开启热点nmcli connection up Hotspot
查看热点状态nmcli connection show Hotspot
修改 SSIDnmcli connection modify Hotspot ssid 新名称
修改密码nmcli connection modify Hotspot wifi-sec.psk 新密码
删除热点nmcli connection delete Hotspot

10. 故障排查 ​

10.1 手机连接后无法上网 ​

  • 确认 eth0 本身能上网(ping 8.8.8.8)。
  • 检查 IP 转发:cat /proc/sys/net/ipv4/ip_forward 应返回 1。
  • 检查 NAT 规则:iptables -t nat -L -n -v 应看到 MASQUERADE 规则。
  • 重启 NetworkManager:systemctl restart NetworkManager,然后重新启动热点。

10.2 热点创建失败(错误:No support for AP mode) ​

  • 执行 iw list | grep "Supported interface modes" -A 8,查看是否包含 AP。如果没有,说明网卡不支持 AP 模式,需更换网卡或驱动。

10.3 手机连接时一直显示“正在获取 IP 地址” ​

  • 通常是因为 ipv4.method 没有设为 shared。请按本文步骤重新创建连接。
  • 也可以检查 /etc/NetworkManager/NetworkManager.conf 中 [main] 下是否有 dns=dnsmasq(一般无影响,但如果冲突可注释掉)。

结语 ​

通过 nmcli 的 shared 模式,我们仅需一条 connection add 命令就能在 Armbian 上快速建立 Wi-Fi 热点,无需手动配置 hostapd 和 dnsmasq。配合 IP 转发和 iptables 规则,即可让连接热点的设备通过服务器的有线网络访问互联网。

此方法同样适用于其他使用 NetworkManager 的 Linux 发行版(如 Ubuntu、Debian、Raspberry Pi OS 等)。希望这篇教程能帮助你轻松搭建属于自己的服务器热点!

结论先说 ​

你的无线芯片 aicwf_sdio(AIC8800) 👉 是支持 5GHz 频段的,属于 2.4G + 5G 双频 WiFi

H96-M9 配这款芯片,基本都是双频 WiFi6,不是单频 2.4G。


一键验证(最准) ​

直接运行这条:

bash
iw list | grep -i "5ghz"
  • 有输出 → 支持 5G
  • 完全没输出 → 不支持

你这块芯片99%会有输出。


为什么你现在速度只有 3MB/s? ​

因为你的热点默认跑在 2.4G 频段,干扰大、速度慢。 只要切到 5G 频段,速度立刻能到 10MB/s+。


把热点改成 5G 频段(复制即用) ​

bash
# 强制热点使用 5G 频段
nmcli connection modify Hotspot 802-11-wireless.band a

# 5G 常用干净信道(36/40/44/48 任选一个)
nmcli connection modify Hotspot 802-11-wireless.channel 36

# 重启热点生效
nmcli connection down Hotspot
nmcli connection up Hotspot

切完再测速度,会明显快很多。

/src/technology/dateblog/2026/04/20260406-armbian-h96-m9%E9%85%8D%E7%BD%AEap%E7%83%AD%E7%82%B9.html