Armbian（RK3568）有线转无线AP热点

玩嵌入式开发的朋友，大概率遇到过这样的需求：手里有一块瑞芯微RK3568开发板，刷了Armbian系统，想让开发板通过有线上网，同时开启无线AP热点，供手机、平板等设备连接。

网上不少教程要么步骤繁琐，要么存在兼容性问题，折腾半天还不稳定，甚至会出现NetworkManager和systemd-networkd抢网卡、DNS端口冲突等问题。

今天就给大家带来一套适配瑞芯微RK3568+Armbian系统的完美解决方案，附带一键部署脚本，支持可见/隐藏热点，反复执行也不会乱配置，新手也能轻松上手！

一、前期准备

1. 硬件准备

• 核心硬件：瑞芯微RK3568开发板（需自带无线网卡，或外接USB无线网卡，确保支持AP模式）

• 网络环境：有线网线（连接路由器/光猫，确保能正常上网）

• 其他：电脑（用于SSH连接开发板，或直接在开发板终端操作）

2. 系统要求

已刷入Armbian系统（推荐稳定版，本文适配测试环境：Linux armbian 6.1.65-ophub #1 SMP Sun Dec 3 05:14:23 EST 2023 aarch64 aarch64 aarch64 GNU/Linux），开发板已开启SSH，且能通过有线正常访问网络。该内核版本为长期维护版，适配RK3568开发板稳定性良好，可顺利运行本次热点脚本。

3. 关键说明

本次方案核心逻辑：有线接口（eth0，默认）负责上网，无线接口（wlan0，默认）负责发射AP热点，通过NAT转发实现热点设备共享有线网络，同时规避各类常见冲突，保证长期稳定运行。

二、核心脚本（直接复制可用）

以下脚本是经过多次测试优化的最终版，支持自定义热点名称、密码、信道，可创建可见/隐藏热点，反复执行不会叠加配置，适配RK3568的Armbian环境，无需手动修改复杂配置文件。

setup_ap.sh

三、详细操作步骤（新手必看）

步骤1：创建脚本文件

通过SSH连接RK3568开发板（或直接在开发板终端操作），执行以下命令，创建脚本文件：

nano setup_ap.sh

将上面的完整脚本复制粘贴到文件中，按 Ctrl+O 保存，按 Ctrl+X 退出编辑。

步骤2：赋予脚本执行权限

执行以下命令，给脚本添加可执行权限：

chmod +x setup_ap.sh

步骤3：运行脚本配置AP热点

脚本支持默认配置和自定义配置，按需选择即可，所有操作需用sudo权限执行。

方式1：默认配置（快速上手）

默认热点名称：Armbian-AP，默认密码：12345678，信道6，可见热点，执行命令：

sudo ./setup_ap.sh --apply

方式2：自定义配置（推荐）

可自定义热点名称（SSID）、密码（PASSPHRASE）、信道（CHANNEL），示例如下（可按需修改参数）：

sudo SSID="RK3568-AP" PASSPHRASE='RK3568test!' CHANNEL=11 ./setup_ap.sh --apply

方式3：创建隐藏热点

在自定义配置后添加 --hidden 参数，即可创建不广播SSID的隐藏热点：

sudo SSID="RK3568-AP" PASSPHRASE='RK3568test!' CHANNEL=11 ./setup_ap.sh --hidden --apply

步骤4：验证热点是否生效

脚本执行完成后，会自动显示热点相关状态，也可手动执行以下命令查看状态：

sudo ./setup_ap.sh --status

若显示 hostapd、dnsmasq 服务处于 running 状态，且 wlan0 有 192.168.50.1 的静态IP，说明配置成功。

此时用手机搜索热点（隐藏热点需手动输入SSID和密码），连接后即可正常上网。

四、脚本核心优势（适配RK3568，稳定不踩坑）

• 自动规避冲突：检测到NetworkManager运行时，自动将无线接口设为Unmanaged，避免与systemd-networkd抢网卡，解决常见的接口管理冲突问题。

• DNS端口不冲突：dnsmasq仅启用DHCP功能（port=0），不占用53端口，避免与systemd-resolved冲突，不会导致开发板或热点设备无法解析域名。

• 可重复执行：iptables规则会检查是否已存在，不会重复叠加；配置文件每次重写，反复运行脚本也不会导致配置混乱。

• 依赖自动安装：脚本会检测缺失的依赖包（hostapd、dnsmasq等），仅在缺失时安装，避免重复执行安装流程，节省时间。

• 开机自启：自动配置hostapd、dnsmasq、netfilter-persistent开机自启，重启开发板后热点自动启动，无需手动操作。

五、常见问题排查（RK3568专属）

1. 脚本执行报错“PASSPHRASE 必须至少 8 位”

解决方案：修改密码参数，确保密码长度≥8位，例如将密码改为 PASSPHRASE='123456789'。

2. 热点创建成功，但手机连接后无法上网

排查步骤：

• 检查有线网络是否正常：执行 ping 8.8.8.8，若无法ping通，说明有线接口未正常上网，检查网线连接和路由器设置。

• 检查NAT规则：执行 iptables -t nat -S POSTROUTING | grep MASQUERADE，若无输出，重新运行脚本即可自动添加规则。

3. 无线接口无法启用AP模式

解决方案：确认RK3568的无线网卡支持AP模式，可执行iw list | grep -A 10 "Supported interface modes"，查看是否有“* AP”字样；若没有，更换支持AP模式的USB无线网卡。

4. 重启开发板后热点不自动启动

解决方案：执行以下命令，重新启用开机自启服务：

sudo systemctl enable --now hostapd dnsmasq netfilter-persistent

六、总结

这套方案专门适配瑞芯微RK3568+Armbian系统，一键脚本搞定有线转无线AP热点，无需复杂配置，新手也能轻松上手。脚本兼顾稳定性和灵活性，支持自定义热点参数、隐藏热点，反复执行也不会乱配置，完美解决嵌入式开发中常见的热点部署痛点。

如果觉得有用，欢迎转发分享给身边的开发者朋友，收藏起来备用～ 若遇到其他问题，可在评论区留言交流！