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 设置,建议先删除可能冲突的连接配置:
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 转发(共享上行网络)。
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. 启动热点
nmcli connection up Hotspot此时,你的手机或其他设备应当能搜索到 H96-AP,输入密码 12345678 即可连接,并且能自动获取 IP 地址(如 10.42.0.x),不再卡在“获取 IP 地址”阶段。
5. 开启 IP 转发并配置 NAT 规则
虽然 ipv4.method shared 会自动设置 NAT,但有时 Armbian 默认未开启 IP 转发,或需要显式添加防火墙规则以确保网络共享正常。建议执行以下命令(一次性设置,重启后需重新执行,后续我们会用开机脚本固化):
# 开启 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. 重启热点使规则生效
nmcli connection down Hotspot
nmcli connection up Hotspot7. 设置开机自动启动热点
nmcli connection modify Hotspot connection.autoconnect yes这样系统每次启动后,NetworkManager 会自动拉起该热点。
8. 永久保存 IP 转发和 iptables 规则
8.1 永久开启 IP 转发
编辑 /etc/sysctl.conf,取消或添加下面一行:
net.ipv4.ip_forward = 1然后执行 sysctl -p 使其立即生效。
8.2 永久保存 iptables 规则
安装 iptables-persistent(Debian/Ubuntu 系):
apt update && apt install iptables-persistent -y在配置好规则后,执行:
iptables-save > /etc/iptables/rules.v4这样重启后规则会自动恢复。
如果你不希望安装额外软件,也可以将规则写入 /etc/rc.local 或创建一个 systemd service。
9. 日常管理命令
| 操作 | 命令 |
|---|---|
| 关闭热点 | nmcli connection down Hotspot |
| 开启热点 | nmcli connection up Hotspot |
| 查看热点状态 | nmcli connection show Hotspot |
| 修改 SSID | nmcli 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。
一键验证(最准)
直接运行这条:
iw list | grep -i "5ghz"- 有输出 → 支持 5G
- 完全没输出 → 不支持
你这块芯片99%会有输出。
为什么你现在速度只有 3MB/s?
因为你的热点默认跑在 2.4G 频段,干扰大、速度慢。 只要切到 5G 频段,速度立刻能到 10MB/s+。
把热点改成 5G 频段(复制即用)
# 强制热点使用 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切完再测速度,会明显快很多。