Skip to content

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

在 Armbian 系统上,利用 nmcli(NetworkManager 命令行工具)可以非常方便地将无线网卡配置为 AP 模式,并共享有线网络(eth0)的互联网连接。相比手动配置 hostapddnsmasq,这种方法更简单、可靠,且由 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

注意:如果你重启了系统,上述 iptablesip_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(一般无影响,但如果冲突可注释掉)。

结语

通过 nmclishared 模式,我们仅需一条 connection add 命令就能在 Armbian 上快速建立 Wi-Fi 热点,无需手动配置 hostapddnsmasq。配合 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