有几天我把树莓派塞进了弱电井里的设备箱,箱子背后就是路由器,旁边连个摆显示器的地方都没有。那会儿还得远程改配置,折腾了一圈,最后靠“手机热点 + Advanced IP Scanner + SSH”这套组合,五分钟不到就把树莓派连上了,全程没碰屏幕。这套方案我后来在多个场景里反复用,稳定、干净,尤其适合临时调试、当场部署、帮朋友救急这种场合。
如果你手里有一台树莓派、一张TF卡、一台能开热点的手机和一台笔记本,但没有显示器也没有键盘,这篇文章就是给你准备的。整个过程不需要路由器后台权限,不需要网线直连,也不需要提前知道树莓派的IP。我会一步步说明系统烧录时的坑、手机热点该注意什么、Advanced IP Scanner怎么扫、SSH登录后先做什么,最后把常见的排查问题整理成表。内容基于Raspberry Pi OS(Debian 11/12 版本)的实践,树莓派3B、4B、5和Zero系列都能用。
1. 为什么我推荐“手机热点 + Advanced IP Scanner”这套方案
第一次玩无屏SSH的人,第一反应往往是“直接插网线到路由器,然后在后台看IP”,但实际跑起来会发现很多问题:设备不在手边、路由器后台密码不知道、网线不够长、甚至你做的时候压根不在家里。手机热点的存在,相当于把你的调试现场变成了一个临时的、自己完全可控的局域网,配合Advanced IP Scanner这个免费的局域网扫描工具,你不需要碰任何路由器设置,就能精准拿到树莓派的IP地址。
1.1 无屏连接SSH的几种常见路子
我见过不少新手尝试的方法,各有各的尴尬:
- 网线直连电脑:树莓派插网线到电脑网口,手动配置静态IP或者开启网络共享。这个方法能用,但要给树莓派单独配一个静态IP,还要去网络适配器设置里翻来翻去,Windows和macOS还各有一堆细节。Zero系列没有网口,还得用USB转网口,折腾成本一下就上去了。
- 家里路由器DHCP分配:树莓派连WiFi后,登录路由器后台看客户端列表,找到raspberrypi主机名拿IP。这方法听着简单,前提是你手里有路由器管理密码,而且路由器的客户端列表刷新没那么快,有时在列表里看到一个陌生设备,还得猜哪个是树莓派。
- 手机热点 + 局域网扫描:手机开热点,电脑和树莓派都连同一个热点,然后用Advanced IP Scanner扫一下这个热点的网段,根据主机名、MAC厂家信息找到树莓派。不需要路由器后台、不需要额外网线、不需要静态IP配置,只要设备上线了,扫一下就能定位。
第三种方案最适合临时场景,也最适合新手入门理解SSH的链路逻辑。它其实就把手机热点当成一个迷你路由器,树莓派通过WiFi接入,电脑也接入同一网络,然后两者之间就能进行局域网通信,SSH自然就通了。
1.2 手机热点充当临时路由器有什么好处
我后期帮别人远程排查树莓派问题,基本都是开着热点干。它的优势很直接:你不需要进入任何路由器后台,不需要网线,也不需要知道目标设备有没有公网IP这类复杂信息。手机热点作为一个独立的局域网,网段固定、设备少、扫描速度快,树莓派上线后几乎一找一个准。
具体优势可以总结成四点:
- 零依赖:一台手机、一台笔记本、一张烧好系统的TF卡,就是全部硬件。
- 可控性好:热点是你开的,网段是固定的,手机端就能看到“已连接设备”列表,树莓派有没有上线一眼就知道。
- 隔离风险低:跟别人的办公室WiFi、学校网络完全不干扰,不用担心AP隔离或者权限限制导致扫描不到设备。
- 适合现场救急:不管是在客户现场、在教室、在户外,只要手机有电,这套方案就能跑起来。
唯一要注意的是,手机热点虽然叫“热点”,但它本质还是一个路由器,只是用手机来实现。树莓派连接它、电脑连接它,双方就在同一个局域网里,SSH就是按这个链路走的。
1.3 Advanced IP Scanner 在链路中扮演的角色
树莓派通过WiFi连上热点后,会被手机热点分配一个IP地址。问题是这个IP是动态分配的,你又没有屏幕,怎么知道具体是哪个?如果热点支持查看已连接设备列表,你也许能从手机端看到树莓派的IP,但很多手机的热点界面只显示设备数量或设备名,有的还不实时刷新,等起来很烦躁。
Advanced IP Scanner就是来填这个缺口的。它是一款Windows平台免费的局域网扫描工具,打开后直接扫描你指定的IP网段,能返回每个IP的状态、主机名、MAC地址、设备厂商等信息。扫描完成后,在结果列表里看到主机名是raspberrypi或者厂商写着Raspberry Pi的那一项,基本就是你的树莓派。它不需要安装,解压就能用,单个文件,免注册,在调试现场非常方便。
现在Advanced IP Scanner已经从早期的2.x版本迭代到了更现代的版本,界面汉化做得也不错,新手打开不会慌。它在这里的核心任务不是“扫描全网”,而是“在树莓派已经连上热点的前提下,快速告诉你是哪个IP”。所以这个工具在整个方案里,解决的是“你明明连上了,我却不知道你在哪里”的问题。
2. 准备工作与核心配置原理
在动手之前,先把材料备齐。这一节我会把系统烧录和SSH启用的原理讲透,这样即便以后换了新镜像、新系统,你也能自行推导该怎么配置,而不是每次都要对着教程照抄。
2.1 必需的软硬件清单
硬件部分:
- 树莓派主板(本文以4B为主,3B/3B+/5/Zero 2 W通用,Zero 1代只支持2.4GHz WiFi,注意热点频段)
- TF卡(至少8GB,建议16GB以上,Class 10以上速度)
- 读卡器(USB读卡器即可)
- 手机(能开热点,建议2.4GHz频段)
- 笔记本(Windows / macOS / Linux都行,本文主要演示Windows)
软件部分:
- 树莓派官方烧录工具 Raspberry Pi Imager(从树莓派官网下载,免费)
- Advanced IP Scanner(Windows平台免费工具,正式官网可下载)
- SSH客户端(Windows 10/11 自带 OpenSSH,或者用 PuTTY、Bitvise SSH Client 都行)
有一个小点要提醒:如果你用的是树莓派5,供电要求比4B更高,建议用官方27W电源或满足5V/5A的优质电源,否则可能出现网卡不稳定、SSH掉线的情况。这个问题跟无屏连接本身无关,但非常影响体验,值得提前规避。
2.2 烧录系统:两种方式的对比与操作要点
烧录系统时,有两条路可以走:一是用官方Raspberry Pi Imager在写入镜像的同时直接写入WiFi和SSH配置,二是在烧录完成后手动改TF卡boot分区里的配置文件。两条路我都在实践中用,各有优势,推荐组合使用。
先说官方Imager这条主路线。Raspberry Pi Imager会先下载系统压缩包,然后写入TF卡。写入过程它会自动格式化和分区。对于大多数用户来说,直接在软件里选择“操作系统 -> Raspberry Pi OS (其他)-> Raspberry Pi OS Lite(64-bit)”,或者按需求选“Raspberry Pi OS (64-bit)”带桌面的版本,然后点右下角“设置”按钮,在高级选项中勾选“启用SSH”、设置用户名密码、填写WiFi信息。之后系统写入完成,配置也跟着生效,非常顺手。
再说手动配置这条备用路线。旧版树莓派系统只认两个文件:boot分区下的ssh空文件和wpa_supplicant.conf。在烧录完成后,TF卡会被识别成一个可访问的boot盘,在这个盘根目录新建一个名为ssh的空文件(无扩展名),再新建一个wpa_supplicant.conf并写入热点信息。新版Raspberry Pi OS则额外多了userconf.txt的机制,用于手动创建默认用户,具体内容我放在2.3节讲。
两种方式对比见下表:
| 对比项 | Raspberry Pi Imager预配置 | 手动创建配置文件 |
|---|---|---|
| 操作复杂度 | 低,图形界面填写即可 | 中,需要新建文件并注意格式 |
| 适用系统 | Raspberry Pi OS全系列、部分第三方镜像 | Raspberry Pi OS、Ubuntu Server等 |
| WiFi配置 | 直接在设置面板填写 | 通过wpa_supplicant.conf |
| 用户创建 | 自动创建并设置密码 | 需要额外userconf.txt |
| 常见坑 | 设置面板别忽略“开启SSH”选项 | ssh文件名不能带.txt后缀 |
我个人习惯是:手边有下载好的镜像文件就用Imager一步到位;如果镜像已经烧好了,只是忘了配置,或者需要临时改热点信息,直接再读一次boot分区,手动补一个wpa_supplicant.conf进去就行,不用重新烧系统。
2.3 关键配置文件逐项拆解
先看ssh空文件。它的作用很简单:通知系统在首次启动时自动启用SSH服务。在Raspberry Pi OS中,检测到boot分区存在这个文件后,系统就会启动SSH服务并开放22端口。注意文件名必须是小写的ssh,不要写成ssh.txt,Windows的资源管理器如果隐藏了已知文件扩展名,很容易造出一个ssh.txt,这会导致文件不生效,后面扫描到了IP却连不上。
再看wpa_supplicant.conf。这是Linux下WiFi连接的标准配置文件,树莓派首次启动时会读取它来连接无线网络。一个标准的示例:
country=CN ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 network={ ssid="你的手机热点名称" psk="你的热点密码" scan_ssid=1 }这里我解释几个关键参数,方便你自己改:
country:国家代码,很多新手会直接忽略。填CN代表中国区,如果不填,部分镜像会因为地区码未设置而拒绝使用5GHz频段,甚至影响WiFi模块正常工作。我遇到过好几次,改完country之后WiFi才正常连上。ctrl_interface:固定写法,保持默认即可。它的意思是允许netdev组内的用户通过wpa_cli命令管理WiFi配置。update_config=1:允许系统写回配置文件。首次连接后,系统可能会把wpa_supplicant.conf里的密码做脱敏处理,保留这个参数有助于后续排查。scan_ssid=1:如果你的热点名是隐藏SSID,这个参数会让系统主动扫描指定名称的WiFi,普通热点写不写都行。
最后讲userconf.txt。这是较新版Raspberry Pi OS引入的默认用户创建机制,之前的镜像默认用户名和密码是pi/raspberry,后来官方出于安全考虑取消了默认用户,在没有显示器的情况下你就没法登录。解决办法是在boot分区新建一个名为userconf.txt的文件,里面写一行用户名:加密密码。加密密码可以通过命令openssl passwd -6生成,然后把生成的结果粘贴到文件里。例如:
mypi:$6$ABCDEF$xxxxxxxxxxxx这行内容的意思是:创建一个用户名为mypi、密码为加密后字符串对应的用户。文件写完保存后,首次启动时系统会创建这个用户并启用SSH。这个细节在无屏安装时非常重要,不写的话即使连上了WiFi,SSH也会因为用户名不存在而拒绝登录。
3. 完整实操流程:从烧录到SSH登录
配置原理了解得差不多了,接下来是完整流程。我尽量按实际操作的顺序走,每一步你会看到什么、填什么、点哪里,都尽量说清楚,方便你照着做下去。
3.1 用Raspberry Pi Imager完成系统配置(附截图说明)
第一步,电脑上打开Raspberry Pi Imager。主界面有三个选择卡片:“选择操作系统”“选择存储卡”“设置”。先把TF卡插到电脑上,如果电脑只有一个读卡器口,确认系统里已经识别到U盘设备。
截图内容说明:主界面顶部是树莓派徽标,下方是三块区域,“选择操作系统”默认是“为树莓派选择操作系统”,“选择存储卡”默认是“选择存储卡”,“设置”字样的按钮在右下角,齿轮图标,点击前是灰色,选择存储卡后变成可点击的绿色或者高亮状态。
点击“选择操作系统”,在列表里选择“Raspberry Pi OS (64-bit)”,如果你确定不需要桌面图形界面,可以选择“Raspberry Pi OS Lite (64-bit)”,体积更小、启动更快、吃内存更少,对纯SSH使用场景来说Lite版更合适。接着点击“选择存储卡”,选你刚插入的TF卡。此时右下角的“设置”按钮变为可点击。
点击“设置”按钮,在弹窗里做这几件事:
- 勾选“启用SSH”,后面选“使用密码身份验证(使用账户密码登录)”。
- 在“设置用户名和密码”里填一个你想用的用户名和密码。注意这里填的是树莓派系统的登录用户名,不是WiFi账号,也不是热点密码。
- 勾选“配置无线局域网”,SSID填你的手机热点名称,密码填热点密码,无线网络国家地区选“CN”。
- “设置主机名”这一项可以顺手改一下,比如改成
mypi,这样后续访问时可以用mypi.local,不改也行,默认是raspberrypi。 - 时区可以选“Asia/Shanghai”,键盘布局选“us”或“cn”,看你习惯。
截图内容说明:弹出的高级选项面板是一个多行表单,从上到下依次是主机名、启用SSH(单选按钮)、用户名和密码(两个输入框)、配置无线局域网(SSID、密码、国家)、时区、键盘布局。各项填写完成后,面板底部有一个“保存”按钮。
填完后点击“保存”,回到主界面,点击“写入”开始烧录。烧录过程中会先下载镜像、写入TF卡并校验,最终提示“写入完成,建议安全弹出”。整个过程大概几分钟,具体取决于镜像大小和TF卡读写速度。烧录完成后,安全弹出TF卡,插到树莓派上,接电开机。树莓派启动会先进行一次磁盘分区扩展和系统初始化,首次开机会比较慢,大约需要1到2分钟,不要着急。
3.2 判断树莓派是否连上热点
树莓派启动完成后,它会从手机热点获取一个IP地址。接下来打开手机的热点管理界面,查看已连接设备。以常见的Android手机为例,在“设置 -> 便携式热点 -> 已连接设备”里能看到当前连接热点的设备列表。如果列表里出现了一个新的未知设备,而且连接时间刚好对应树莓派开机时间,那么大概率就是树莓派。
部分手机的热点列表还会显示设备的MAC地址,这能帮你更准确地判断。树莓派的MAC地址前三位一般是B8:27:EB、DC:A6:32、E4:5F:01、28:CD:C1,这也是后面用Advanced IP Scanner确认目标的重要依据。iPhone的热点界面则只显示设备名称和数量,如果看到多了一台设备,基本可以确认是树莓派。
这一步的作用是提前确认树莓派网络链路已经通了。如果手机热点这边根本看不到新设备,说明配置有问题,后面扫描也是白扫。这个问题出现时,先别急着开Advanced IP Scanner,回到2.3节检查WiFi配置和频段问题。
3.3 用Advanced IP Scanner扫描定位树莓派IP(附截图说明)
确认树莓派已经连上热点后,把笔记本电脑也连接到同一个手机热点,然后启动Advanced IP Scanner。
首次打开软件后,默认界面是英文,可以在“查看”或“View”菜单里切换到中文。扫描之前需要确认你所在热点的网段。大多数Android手机热点的默认网段是192.168.43.1开头的网段,网关是192.168.43.1;iPhone热点的默认网段是172.20.10.1开头的网段。判断方法很简单:看手机热点设置页面有没有显示网关或IP地址,或者在电脑网络设置里看当前Wi-Fi获取到的IP是多少。
截图内容说明:Advanced IP Scanner主界面顶部是一个IP范围输入框,左侧是扫描按钮,下方是大面积的扫描结果表格,按IP地址升序排列,每一行显示IP地址、主机名、制造商、MAC地址、HTTP/HTTPS/BT等图标列。右侧有一个“已找到设备”的统计面板。
在IP范围输入框里,把网段填进去。比如电脑的IP是192.168.43.12,那树莓派大概率也在192.168.43.x这个段,可以填192.168.43.1-192.168.43.255,也可以只填192.168.43.1-192.168.43.100,因为热点连接的设备就那么几个,范围不用拉满,扫描会更快。
点击“扫描”按钮,几秒钟后列表里就会出现当前热点下活跃的设备。找树莓派看三点:
- 主机名是否显示为
raspberrypi,如果你在Imager里改过主机名,就显示你自己设置的名字。 - 制造商列是否显示
Raspberry Pi或Raspberry。 - MAC地址前几位是否匹配树莓派常见的OUI前缀。
当这三项中至少前两项命中时,那个IP就是树莓派的当前IP。记下这个IP,后面连接要用。
截图内容说明:扫描完成后,列表第一行可能是网关设备192.168.43.1,主机名可能是手机型号或未知;中间某一行主机名为mypi或raspberrypi,制造商显示Raspberry Pi,MAC地址以DC:A6:32开头,该行右侧图标区域会显示一个绿色电脑图标代表在线。这行就是我们的目标。
3.4 SSH登录与首次安全检查
拿到IP后,在Windows系统上按下Win + R,输入cmd回车,在命令行窗口里输入:
ssh 用户名@树莓派IP你的用户名是Imager里设置的那个,比如刚才设置的是mypi,IP是192.168.43.20,那命令就是:
ssh mypi@192.168.43.20首次连接会看到一个提示,内容是“无法确认主机的真实性,是否继续连接?”,这是SSH的正常安全机制,输入yes回车,然后输入你在Imager里设置的密码。密码输入过程中屏幕不会显示任何字符,这是Linux系统的默认行为,照常输入后按回车即可。
如果你看到命令行提示符变成了类似mypi@raspberrypi:~ $,恭喜,SSH已经连接成功,你现在拥有了树莓派完整的命令行控制权。
如果提示Permission denied (publickey,password),大概率是用户名或密码不对,检查一下大小写和特殊字符。如果提示Connection refused,说明树莓派的SSH服务没有启用,回到烧录环节重新确认ssh文件或Imager设置。如果提示WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED,说明同一IP地址之前被别的设备占用过,在电脑的known_hosts里有旧指纹,执行下面这条命令清理后重新连接:
ssh-keygen -R 192.168.43.20登录成功后,别急着做其他事情,先做两个安全检查。一是修改密码,SSH连接中默认使用密码登录,而密码在局域网里是明文传输的,如果你在公共网络下操作,最好改用SSH密钥登录,或者至少换一个强密码。执行passwd按提示修改当前用户密码。二是执行sudo apt update && sudo apt upgrade,把系统软件源和已安装的软件包更新到最新版本,修补已知漏洞,也能避免很多奇怪的兼容性问题。
4. 常见问题与排查技巧实录
用这套方案跑过很多次之后,我把在群里回答新手问题时最常碰到的几个坑整理了出来。下面这张表格你可以直接收藏,之后出了问题对着查就好。
| 现象 | 可能原因 | 解决思路 |
|---|---|---|
| 手机热点设备列表里没出现新设备 | 热点频段是5GHz,树莓派不支持或信号差 | 在手机热点设置里把频段改成2.4GHz,关闭“随机MAC”或“已连接设备匿名” |
| 树莓派只连接了热点但电脑扫描不到 | 电脑和树莓派不在同一个网段 | 确认电脑连接的WiFi名称和手机热点一致,不接其他路由器的WiFi |
| Advanced IP Scanner结果里没有Raspberry字段 | 主机名被改过,或者扫描范围不对 | 调整IP范围,看制造商列,通过MAC前缀匹配 |
| SSH连接被拒绝 | SSH服务未启用或系统未完成初始化 | 重新确认boot分区ssh文件存在,给树莓派多等一分钟再试 |
| SSH连接卡在输入用户名密码 | 默认用户不存在或密码错误 | 新版系统必须用Imager或userconf.txt创建用户 |
| 能连上但过一会儿就断线 | 树莓派供电不足或热点AP隔离开启 | 换优质电源;在手机热点设置里关闭“AP隔离”或“设备隔离” |
4.1 扫描不到树莓派的完整排查清单
扫描不到是出现频率最高的问题,而且原因往往不在扫描工具本身。我按概率排序,给你一个排查顺序:
- 先看手机热点已连接列表。如果树莓派没有出现在这里,直接排查WiFi配置和频段。把热点频段切到2.4GHz,再去掉热点密码试试。手机热点的SSID名称建议不要太长,不要有特殊字符,纯字母数字最稳。
- 确认电脑连接的是同一个热点。这个错误很容易犯,尤其当电脑曾经自动连过旁边的某个WiFi时,你以为连着热点,其实连着别的网络。在电脑的网络设置里看一眼当前连接的WiFi名称。
- 检查扫描范围。用Advanced IP Scanner时,范围要看电脑自己获取的IP是多少。电脑是
192.168.43.15,树莓派一般就在192.168.43.2到192.168.43.30之间。不要扫192.168.1.x,那是另一个网段。 - 排除热点AP隔离。有些手机系统在热点设置里提供“允许设备间通信”或“AP隔离”选项,如果被关掉了,即使树莓派和笔记本都连着同一个热点,两者之间也无法互通。这个选项在部分国产手机上默认打开,需要手动开启。
- 放大扫描范围或者换成从手机端查看IP。如果Advanced IP Scanner确实扫不到,打开手机热点已连接设备列表,有的手机在设备详情里会直接显示IP地址,直接用那个IP连接即可。
这些步骤走完,99%的“扫不到”问题都能解决。
4.2 没有无线网卡的台式机怎么办
如果手头是一台没有无线网卡的台式机,方案依然成立,只是连接方式要变一下。最稳妥的替代方案是用Android手机通过USB连接电脑,开启“USB网络共享”。开启后电脑会增加一个USB以太网适配器,IP由手机分配,网络也能通。此时让树莓派连接手机热点WiFi,电脑走USB共享,两者都经由手机上网,但在网络层面,电脑的USB共享网段和热点的WiFi网段可能不是同一段。这种情况下,SSH能不能通取决于手机是否在两个网段之间做了转发,实测中大部分Android手机的USB共享网络和热点WiFi是互通的,但个别机型不通。
如果你遇到这种情况,最简单的兜底方案是:不要用USB共享,临时买一个USB无线网卡,或者直接用手机浏览器/远程桌面给树莓派开临时WiFi。另一个土办法是把TF卡拔下来,在电脑上读boot分区,直接修改wpa_supplicant.conf里的热点信息,然后插回树莓派重新启动,然后让手机共享一个热点,再看手机端已连接设备里的IP。总之没有无线网卡的场景下,思路就是“确保电脑和树莓派在同一个二层网络里”,实在不行就改用树莓派连接你的路由器,电脑也连接同一个路由器。
4.3 免IP直连:配置主机名与.local连接
我在实际操作中,扫描到IP后第一件事是SSH登录,但连接第二次、第三次时,如果IP变了就会很烦。树莓派其实支持mDNS(多播DNS)协议,默认开启,也就是说你不需要记IP,直接用主机名加.local就能访问。
在Imager设置里把主机名改成mypi后,连接命令可以写成:
ssh mypi@mypi.local只要电脑和树莓派在同一个局域网,并且电脑的系统支持mDNS解析(macOS原生支持,Windows 10 1903之后也自带支持,Linux桌面端一般也正常),就能直接连上。手机热点这个场景下,由于每次热点重新开启后DHCP池的分配情况可能变化,.local方式比记IP省心得多。
不过要注意,Windows的mDNS解析偶尔会抽风,尤其是公司网络或存在多个虚拟网卡的机器上,.local解析可能会失败。遇到这种情况,临时用Advanced IP Scanner扫一下获取IP,是最快的兜底办法。
5. 一点实操心得
这套“手机热点 + Advanced IP Scanner + SSH”组合,我到现在还在用。之前帮客户现场部署一个树莓派采集网关,机器放在天花板吊顶里,没有屏幕没有网线,周边也没有路由器可用。我当时就靠手机热点,笔记本连着热点,Imager提前烧好系统,树莓派通电后扫了两下拿到IP,SSH进去把采集脚本跑起来,整个过程没超过五分钟。那次之后我就把Imager和Advanced IP Scanner装在U盘里随身带着,遇到树莓派无屏安装的问题,拿出来就是一套标准流程。
最后分享两个小技巧。一是系统烧完别急着拔TF卡,先重新插回电脑,看一眼boot分区里有没有多出ssh文件和wpa_supplicant.conf,确认没有问题再装到树莓派上,这个小习惯能帮你省去很多无意义的开机等待。二是手机热点名称里不要带空格和中文,部分Linux系统的wpa_supplicant对接入隐藏SSID或特殊字符SSID的处理不太友好,纯字母数字的最省心。掌握了这套流程,树莓派无屏调试就不再是难题,后面的SSH操作、环境配置、应用部署,都能在这个基础上顺畅展开。