☰
树莓派无屏SSH连接实战:手机热点+IP Scanner快速搞定远程调试
2026/10/2 1:33:42 网站建设 项目流程

有几天我把树莓派塞进了弱电井里的设备箱,箱子背后就是路由器,旁边连个摆显示器的地方都没有。那会儿还得远程改配置,折腾了一圈,最后靠“手机热点 + 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,因为热点连接的设备就那么几个,范围不用拉满,扫描会更快。

点击“扫描”按钮,几秒钟后列表里就会出现当前热点下活跃的设备。找树莓派看三点:

  1. 主机名是否显示为raspberrypi,如果你在Imager里改过主机名,就显示你自己设置的名字。
  2. 制造商列是否显示Raspberry Pi或Raspberry。
  3. 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 扫描不到树莓派的完整排查清单

扫描不到是出现频率最高的问题,而且原因往往不在扫描工具本身。我按概率排序,给你一个排查顺序:

  1. 先看手机热点已连接列表。如果树莓派没有出现在这里,直接排查WiFi配置和频段。把热点频段切到2.4GHz,再去掉热点密码试试。手机热点的SSID名称建议不要太长,不要有特殊字符,纯字母数字最稳。
  2. 确认电脑连接的是同一个热点。这个错误很容易犯,尤其当电脑曾经自动连过旁边的某个WiFi时,你以为连着热点,其实连着别的网络。在电脑的网络设置里看一眼当前连接的WiFi名称。
  3. 检查扫描范围。用Advanced IP Scanner时,范围要看电脑自己获取的IP是多少。电脑是192.168.43.15,树莓派一般就在192.168.43.2到192.168.43.30之间。不要扫192.168.1.x,那是另一个网段。
  4. 排除热点AP隔离。有些手机系统在热点设置里提供“允许设备间通信”或“AP隔离”选项,如果被关掉了,即使树莓派和笔记本都连着同一个热点,两者之间也无法互通。这个选项在部分国产手机上默认打开,需要手动开启。
  5. 放大扫描范围或者换成从手机端查看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操作、环境配置、应用部署,都能在这个基础上顺畅展开。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询