如何让设备开机自动连接WiFi？实操教程来了
你是不是也遇到过这样的问题：设备每次重启后，WiFi连接就断了，还得手动点一下才能连上？特别是用在树莓派、嵌入式盒子或者智能硬件项目里，总不能每次断电重启都守在旁边点几下吧。今天这篇教程，就带你用最简单可靠的方式，让设备一开机就自动连上WiFi——不依赖图形界面，不装额外软件，纯Linux原生方案，小白也能照着做。
这个方法的核心原理特别朴素：Linux系统在启动流程的最后阶段，会自动执行一个叫/etc/rc.local的脚本文件。只要我们把连接WiFi的命令写进这个文件，系统启动完成时就会自动运行它。整个过程就像给设备设了个“起床闹钟”，闹钟一响，它就自己连WiFi。
下面我会从环境确认、命令准备、脚本编写、权限设置到验证调试，一步步带你走完全部流程。所有操作都在终端里完成，不需要图形界面，也不需要安装新包。哪怕你刚接触Linux，只要能敲几行命令，就能搞定。
1. 确认系统环境与网络接口名称
在动手写脚本前，得先搞清楚你的设备用的是什么系统、WiFi网卡叫什么名字。不同发行版和硬件平台，接口命名可能不一样，比如常见的有wlan0、wlp2s0、wlx00c0caabcd12等。如果名字写错了，脚本就根本跑不起来。
先打开终端，输入下面这条命令：
ip link show你会看到一长串网络接口列表。找其中状态是UP或包含wireless字样的那一行，重点关注开头类似wlan或wl的名称。比如输出里有这样一行：
3: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP mode DORMANT group default qlen 1000那就说明你的无线网卡接口名是wlan0。记下来，后面要用。
再确认下系统是否支持rc.local机制。Ubuntu 16.04、Debian系、Tina Linux（全志平台常用）默认都支持。但如果你用的是较新的Ubuntu 18.04+或CentOS 8+，它们默认改用systemd管理启动项，rc.local可能被禁用了。不过别担心，本教程适配的就是你提到的测试镜像环境——Ubuntu 16.04和Tina，完全没问题。
小提示：如果你不确定系统版本，可以运行：
lsb_release -a 2>/dev/null || cat /etc/os-release | grep -E "(NAME|VERSION)"看到Ubuntu 16.04或Tina字样，就可以放心继续了。
2. 测试手动连接WiFi命令
脚本要起作用，前提是命令本身能跑通。所以第二步，我们先手动试一遍连接WiFi的全过程，确保每一步都成功，再把它们搬进启动脚本。
2.1 启用无线网卡
有些设备启动后无线网卡是关闭状态，得先把它打开：
sudo ip link set wlan0 up把上面的wlan0替换成你上一步查到的真实接口名。如果没报错，说明网卡已启用。
2.2 连接指定WiFi网络
接下来用wpa_supplicant工具连接。这是Linux里最稳定、最通用的WiFi连接方式。先检查是否已安装：
which wpa_supplicant如果返回路径（比如/sbin/wpa_supplicant），说明已存在；如果没有输出，运行：
sudo apt update && sudo apt install -y wpasupplicant然后生成一个简单的配置文件。假设你要连的WiFi名称是MyHomeWiFi，密码是123456789，运行：
sudo wpa_passphrase "MyHomeWiFi" "123456789" | sudo tee /etc/wpa_supplicant/wpa_supplicant.conf这行命令会自动生成加密后的配置，并保存到标准位置。注意：wpa_passphrase会把密码转成WPA密钥，比明文更安全。
2.3 启动连接并获取IP
配置好了，现在真正连上：
sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf sudo dhclient wlan0第一行以后台模式启动wpa_supplicant，第二行用dhclient向路由器申请IP地址。等几秒钟，再运行：
ip addr show wlan0 | grep "inet "如果看到类似inet 192.168.1.123/24的输出，恭喜，已经连上了！你可以顺手ping一下网关或百度验证：
ping -c 3 www.baidu.com如果通了，说明整套流程完全可行。记下这三行关键命令，它们就是启动脚本的主体内容。
3. 编写并配置/etc/rc.local启动脚本
现在到了最关键的一步：把刚才验证成功的命令，放进系统开机自动执行的/etc/rc.local文件里。
3.1 创建或编辑rc.local文件
大多数Ubuntu 16.04和Tina系统默认自带这个文件，但可能权限不对或内容为空。我们用文本编辑器打开它：
sudo nano /etc/rc.local如果提示文件不存在，就新建一个；如果存在，清空里面的内容，只保留标准模板结构。
3.2 填入正确的启动命令
按如下格式填写（请务必替换为你自己的WiFi名称、密码和网卡名）：
#!/bin/bash # 等待系统网络子系统就绪（重要！避免因启动太快而失败） sleep 5 # 启用无线网卡 ip link set wlan0 up # 启动wpa_supplicant连接WiFi（后台运行） wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf # 获取IP地址 dhclient wlan0 # 退出脚本（必须！否则系统卡住） exit 0几点关键说明：
#!/bin/bash是脚本声明，告诉系统用bash解释器运行；sleep 5是经验性等待，确保内核和网络模块已加载完毕，避免“设备未就绪”错误；- 所有命令都不加
sudo，因为rc.local默认以root权限运行； exit 0必须放在最后一行，且不能省略，否则系统启动会卡在最后一步；- 如果你用的是Tina系统，路径可能略有不同，比如
/etc/wpa_supplicant.conf，可先用find /etc -name "wpa_supplicant.conf"确认。
3.3 设置文件权限与启用服务
保存退出（nano里按Ctrl+O回车保存，Ctrl+X退出）。然后给脚本添加可执行权限：
sudo chmod +x /etc/rc.local对于Ubuntu 16.04，这一步就够了。但Tina Linux或某些精简系统，还需要确保rc-local服务已启用：
sudo systemctl enable rc-local sudo systemctl start rc-local运行后检查状态：
sudo systemctl status rc-local看到active (exited)就表示服务已正常启用。
4. 验证与常见问题排查
写完脚本不等于万事大吉，一定要亲自验证效果。最直接的方法就是重启设备：
sudo reboot等设备重新启动完成（约1–2分钟），用另一台电脑SSH登录，或者直接接显示器看终端，运行：
ip addr show wlan0 | grep "inet "如果能看到IP地址，再试试：
ping -c 3 www.baidu.com能通，说明全自动连接已生效。
4.1 连不上？先看日志
如果失败，别着急删脚本。Linux启动日志是最好的诊断工具。运行：
sudo journalctl -u rc-local --no-pager -n 50这条命令会显示最近50行rc-local服务的运行记录。常见报错及对策：
Failed to bring up wlan0：网卡名写错，或驱动未加载。用ip link show重新确认；wpa_supplicant: command not found：wpasupplicant没装。补装：sudo apt install -y wpasupplicant；No such file or directory: /etc/wpa_supplicant/wpa_supplicant.conf：配置文件路径不对。用sudo find /etc -name "wpa_supplicant.conf"定位真实路径；dhclient: no lease, failing：路由器DHCP没响应，或WiFi密码错误。回到第2步重新生成配置。
4.2 进阶建议：增加重试与超时机制
对稳定性要求高的场景（比如无人值守的边缘设备），可以在脚本里加一层容错。例如，在dhclient前加个循环重试：
# 尝试最多3次获取IP for i in {1..3}; do dhclient wlan0 if ip addr show wlan0 | grep -q "inet "; then break fi sleep 3 done这样即使第一次DHCP失败，也会自动重试，大幅提升鲁棒性。
5. 总结：一条命令，永久告别手动连WiFi
到这里，你已经亲手完成了一套稳定可靠的开机自动连WiFi方案。它不依赖桌面环境，不增加系统负担，不引入第三方服务，完全基于Linux原生机制，兼容Ubuntu 16.04、Tina Linux等主流嵌入式系统。
回顾整个流程，核心就三点：
- 找准网卡名：用
ip link show确认真实接口，这是所有操作的前提； - 验证命令有效性：先手动跑通
ip link set、wpa_supplicant、dhclient三步，再写进脚本； - 严守rc.local规范：
#!/bin/bash开头、sleep防抢跑、exit 0收尾、chmod +x赋权，缺一不可。
这套方法不仅适用于WiFi连接，稍作调整还能用于开机启动摄像头服务、启动MQTT客户端、挂载NAS存储等更多自动化场景。本质上，rc.local就是一个轻量级的“开机任务清单”，掌握它，你就拿到了Linux设备自动化的第一把钥匙。
下次设备重启，你只需要泡杯茶，等它自己连好网络，然后远程SSH上去，一切如常——这才是智能硬件该有的样子。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
