Ubuntu安装Docker实战指南：从GPG密钥到镜像加速的完整排障手册
2026/10/14 4:28:25
把树莓派接到电脑上这件事，说大不大，说小也不小。很多刚接触这块板子的人，第一反应是“插上显示器、键鼠，像用普通电脑一样操作”，但现实里多数人手里只有一台笔记本，甚至有些人买树莓派就是冲着“无头运行”去的。我长期跟树莓派打交道，被问得最多的两个问题始终是：怎么在电脑上操作它？怎么给它传文件？这篇文章就把我自己一直在用的两种连接方式完整拆开讲一遍，分别是基于网络的 SSH 连接和基于 USB 转 TTL 的串口连接。前者适合绝大多数日常场景，后者是救急和底层调试的常备方案。两种方法都不难，但细节决定成败，我会把容易踩的坑一并写清楚。
1. 连接前先想清楚：选网络还是选串口
很多人一开始搞混这两件事，以为只要拿根 USB 线把树莓派和电脑连在一起就能像移动硬盘一样操作。实际不是这样。树莓派和电脑之间的“连接”，本质上建立的是两条不同的通路：一个是网络协议栈上的远程会话，一个是芯片物理引脚上的字符流。
1.1 两种方式的本质区别
SSH 连接依赖 TCP/IP 网络。树莓派得有 IP 地址，系统里得运行 SSH 服务，然后电脑通过ssh客户端发指令过去。这个方案的好处是方便、通用、传输数据能力强，能传文件、能跑命令、能挂载目录，几乎什么都能干。坏处也很明显——一旦拿不到 IP、系统没正常启动、网络配置出错，你就彻底进不去。
串口连接走的是 UART，直接把树莓派的 GPIO 引脚和电脑的 USB 转 TTL 模块连起来。不需要网络、不需要 IP，甚至不需要系统完全启动起来。它是物理层的数据通道，能看到开机全过程的内核日志，能在引导阶段直接操作。好处是“只要板子通电，你就有办法进去”。坏处是需要额外买一个几块钱的转接模块，并且只能跑命令行，不能传文件（或者说传文件很麻烦）。
我把这两种方式比作：SSH 是“给已经住进新房子的人打电话”，串口是“直接从窗户递纸条”。你平时当然用电话，但房子没盖好或者电话线断了，递纸条才是唯一能沟通的手段。
1.2 不同场景下的选择建议
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 日常无头操作、跑服务、写代码 | SSH | 稳定、高效、支持文件传输 |
| 树莓派无法获得 IP，或不知道 IP | 串口 | 不依赖网络，进去查网络配置 |
| 系统启动失败、需要看内核日志 | 串口 | 能看到完整启动过程 |
| 第一次到手“开荒” | SSH 或串口 | 两者都可以，看手边有什么工具 |
| 需要频繁传文件 | SSH | 配合 scp/sftp 非常顺手 |
如果你只打算学一种，那一定是 SSH，因为日常 90% 的场合都用得上。但串口那套接线和登录逻辑，我建议也提前学会并备好模块，指不定哪天就救命了。
2. 前置准备：把树莓派配置成“无头模式”
“无头”就是没有显示器、没有键盘鼠标，完全靠网络或者串口登录的用法。要做无头，第一步就绕不开系统烧录和初始配置。这个环节做得对不对，直接决定后面 SSH 能不能连上。
2.1 烧录时顺手开启 SSH 和 WiFi
最简单可靠的方式是用树莓派官方提供的烧录工具 Imager。烧录系统时，在设置界面里可以直接填 WiFi 名称、密码，也能勾选开启 SSH、设置用户名和密码。这一步做完，相当于把网络和远程登录的准备工作全部提前完成了，你只要把 SD 卡插进板子通电，它就会自动连上 WiFi 并开放 SSH 端口。
但有些人手里是旧镜像，或者烧录工具版本比较老，没有这些图形化选项。那就只能刷完卡之后手动改卡里的文件。SD 卡烧录完成后，电脑上会看到一个boot分区，在里面新建一个没有任何扩展名的空文件，名字叫ssh（小写），系统第一次启动时检测到这个文件就会自动启用 SSH 服务。如果你用的是 Windows，注意文件资源管理器可能会把文件隐藏扩展名，建议用记事本另存为，文件名输入ssh，保存类型选“所有文件”，免得生成出来的其实是ssh.txt。
WiFi 配置则是新建wpa_supplicant.conf文件，内容参考下面这份：
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 country=CN network={ ssid="你的WiFi名称" psk="你的WiFi密码" }注意ssid和psk的双引号必须保留，密码要是含有特殊字符，建议先在纯文本编辑器里写好再另存，避免编码问题。这个文件放到boot分区根目录下，系统启动时会自动拷贝到/etc/wpa_supplicant/并加载。
2.2 烧录后先搞清 IP 地址
SSH 能不能连上，前提是知道树莓派的 IP。几个常用办法：
- 登录路由器管理后台，查看 DHCP 客户端列表，找到主机名类似
raspberrypi的设备。 - 如果树莓派连着手机热点，在手机的已连接设备列表里直接能看到 IP。
- 在电脑的终端里用
arp -a扫描本网段设备，重点看 MAC 地址以b8:27:eb、dc:a6:32或e4:5f:01开头的条目，这些是树莓派的网卡。 - 用一些局域网扫描工具，比如 Advanced IP Scanner，扫完一目了然。
其中路由器后台和手机热点是最省事的，arp -a适合临时应急。我给自己的习惯排序：先在路由器后台找，找不到就翻手机热点，都不行才上扫描工具。
2.3 拿到 IP 后的第一件事：改密码
如果你用的是旧镜像，系统默认用户名是pi，密码是raspberry。首次 SSH 进去，系统通常也会提示你改密码。新版的官方系统和 Imager 都要求烧录时自定义用户名密码，就没有这个默认密码问题了。
我强烈建议拿到系统后立刻做两件事：第一，用passwd改掉登录密码；第二，把系统自带的软件源更新一下，哪怕只是跑一遍sudo apt update && sudo apt full-upgrade。不做这两步，后面遇到各种奇怪问题都很难排查。
3. 方法一：SSH 网络连接
SSH 是我日常使用频率最高的方式。它不只让你能敲命令，还能顺带完成文件传输、端口转发、远程调试等事情。只要网络通，它就是最顺手的入口。
3.1 SSH 能帮你做什么
用 SSH 登录树莓派后，你得到的是一个完整的命令行环境。想装软件、改配置、重启服务、看日志，全都能做。配合文件传输，基本就替代了显示器：
scp可以单文件拷贝；sftp可以像 FTP 一样操作；- 更进阶的可以用
sshfs把树莓派目录挂到本地，像操作本地文件夹一样读写。
日常做小型服务器、跑脚本、搞物联网项目，一条 SSH 通道完全够用。特别是树莓派做无头运行的时候，SSH 就是你的“显示器 + 键盘”。
3.2 完整的 SSH 连接步骤
第一步，确认网络互通。在电脑终端里先 ping 一下树莓派的 IP：
ping 192.168.1.100能收到回复，说明二层三层都通。如果 ping 不通，先别急着连，回到查 IP 的环节重新确认。网络环境比较复杂的时候，比如隔离 AP、访客网络、AP 隔离，同样网段也不一定能互通，这个后边再细说。
第二步，发起 SSH 会话。Windows 10/11 自带了 OpenSSH 客户端，不需要额外装软件，直接在 PowerShell 或 Terminal 里执行：
ssh 用户名@192.168.1.100第一次连接会提示确认主机指纹，输入yes回车。随后输入密码，就进入了树莓派的命令行。macOS 和 Linux 本身就带 ssh，连法一模一样。
第三步，顺手测试一下权限和常用命令。比如hostname、ip a，确认当前系统信息正常。如果一切顺利，树莓派开机画面对你来说就是不存在的，直接进入盲操阶段。
3.3 进阶：把动态 IP 变成固定 IP
DHCP 分配出来的 IP 是可能变化的，今天连着，明天重启路由器可能就换了。我自己吃过这个亏，早上醒来工具连不上，查了半天才发现 IP 变了。与其每次靠路由器后台找，不如直接给树莓派配置一个静态 IP。
树莓派官方系统默认用dhcpcd管理网络，编辑/etc/dhcpcd.conf：
interface wlan0 static ip_address=192.168.1.100/24 static routers=192.168.1.1 static domain_name_servers=192.168.1.1这里wlan0是无线网卡，有线网卡一般是eth0。把192.168.1.100换成你自己网段内空闲的地址，routers填路由器网关地址，DNS 可以填网关也可以填公共 DNS。改完之后sudo systemctl restart dhcpcd或直接重启。这种做法的好处是 SSH 连接永远不会因为 IP 变化而失联，配合主机名直接ssh 用户名@raspberrypi.local也可以。
3.4 SSH 常见问题的排查
SSH 连不上是新人遇到最多的坑，原因无外乎几类：
- SSH 服务没启用。烧录完没有创建
ssh标记文件，或者用的是精简版系统。解决方法是插卡回电脑，补上ssh文件。 - 账号密码不对。旧镜像默认密码被改过、输错大小写，都会认证失败。注意区分是否加了
sudo。 - WiFi 连不上路由器。
wpa_supplicant.conf格式错了，或者路由器是 5G 专属 SSID、隐藏 SSID，树莓派可能扫描不到。 - 电脑和树莓派不在同一网段。常见于办公网络、公寓网，客户端隔离开启后即使同一个路由也无法互访。
- 防火墙拦截。Windows 上偶尔会有软件把 SSH 22 端口拦了，可以临时关掉相关规则测试。
排查的时候记住一条铁律：先 ping，再 ssh。ping 通说明网络链路正常，剩下就是账号和服务的问题。ping 不通，优先检查网段和无线接入。
4. 方法二：USB 转 TTL 串口连接
如果说 SSH 是正门，那串口就是后门的钥匙。树莓派早期又没有板载调试口，全靠 GPIO 上的 UART 引脚来做串口控制台。这套方案不挑系统状态，哪怕内核 panic、SD 卡系统损坏，只要 bootloader 还在，串口多少都能吐点东西出来。
4.1 材料和接线：先分清收发
需要的硬件非常少：一块 USB 转 TTL 模块（常见的是 CH340 或 CP2102 芯片的小板子，网购搜索即可）、四根杜邦线母对母。模块上一般有 3.3V、5V、GND、TXD、RXD 等引脚。
接线必须遵守“收发交叉”原则，这是新手最容易翻车的地方。
| 树莓派引脚 | USB转TTL 模块 | 说明 |
|---|---|---|
| GPIO14（TXD，物理引脚8） | RXD | 树莓派发送，模块接收 |
| GPIO15（RXD，物理引脚10） | TXD | 模块发送，树莓派接收 |
| GND（物理引脚6） | GND | 共地，必须接 |
千万别把树莓派的 TXD 接到模块的 TXD，这样两边都在发，谁也没在听。接反了最典型的现象是：串口工具打开后空荡荡，敲键盘没反应。另外，不要把树莓派的 5V 引脚接回电脑的 USB 口。树莓派拿独立电源供电，USB 模块也由电脑供电，共地就够了，再接 5V 容易形成倒灌，轻则识别异常，重则烧掉某一边。我调试串口时很少接 VCC，只接 GND、TXD、RXD 三根线，稳得很。
4.2 让树莓派的 UART 输出控制台
官方系统默认情况下，UART 可能没有启用串口登录。需要修改两个配置文件。
第一个是config.txt。老版本系统路径在/boot/config.txt，新版本可能在/boot/firmware/config.txt，以你实际挂载的情况为准。加入这一行：
enable_uart=1这一行让板载 UART 启用，并且不会被分配到别的外设上。
第二个是cmdline.txt。这个文件原本是内核引导参数，里面有一长串，其中包含console=serial0,115200或console=ttyAMA0,115200。如果你希望串口直接作为登录控制台，这一项保留就行。如果删掉它，串口设备会被释放给普通用户程序使用，但启动过程中你看到的日志通常会变少，甚至串口上不再出现login:提示。
这俩选择我帮很多人踩过坑，说清楚一点：
- 只用来登录和救急，保留
console=serial0,115200，开机后你会在串口里看到完整引导日志和一个登录提示符。 - 想自己写程序操作 UART，删掉
console=serial0,115200，避免系统登录进程跟你抢串口设备。 - 只是想看内核日志又不想要登录，删掉 console 参数，但内核启动信息仍然可能输出到串口，看固件和配置情况。
修改之前先备份原文件，这个习惯能省一大笔时间。
4.3 电脑端连接串口并登录
硬件接好了，软件也要跟上。先把 USB 转 TTL 模块插到电脑上，确认驱动装好、设备名识别到。
Windows 下通常显示为COM3、COM4这类端口；Linux 下一般能看到/dev/ttyUSB0或/dev/ttyACM0。确认方式：在 Linux 里插拔模块前后分别执行：
ls /dev/ttyUSB*多出来的那个就是模块。
连接串口工具，我曾经用过几种：
- 命令行党用
screen，简单直接：
screen /dev/ttyUSB0 115200退出时按Ctrl+A然后按K，再按y确认。
- 习惯 Linux 的老手也可以用
minicom：
sudo apt install minicom minicom -D /dev/ttyUSB0 -b 115200- Windows 下可以用 PuTTY，选择 Serial，填写 COM 口号和波特率，注意 Speed 填 115200。
串口参数统一是115200 8 N 1，也就是波特率 115200，数据位 8，无校验，停止位 1。波特率写错最常见的症状是满屏乱码，或者完全没输出。如果遇到乱码，先别怀疑硬件，重新检查波特率。
连接完成后，给树莓派上电，串口工具里应该能看到滚动输出的启动日志。等系统完全启动后，回车出现login:提示，输入用户名密码登录。在这个界面下，你的电脑就变成了一台连接到树莓派的简易终端，所有命令行操作跟 SSH 里没有区别。
4.4 串口调试的额外价值
串口连接真正厉害的地方不在于日常操作，而在于“系统还没起来的时候就能看到东西”。
我第一次用串口救砖，是帮同事调一块树莓派，现象是接电后网口灯亮但怎么都 ping 不通，SSH 也连不上。插上串口线一看，启动日志卡在文件系统检查，报错信息直接告诉我 SD 卡分区异常。这种信息在没显示器的环境下，除了串口你根本拿不到。另外，如果你写的内核模块或者驱动程序在启动阶段就崩了，dmesg输出也能通过串口完整保留下来，这对排查问题极其关键。
还有一个小用途：串口可以用来直接修改cmdline.txt或者其他引导参数。万一系统起不来、SSH 无法启用，串口登录进恢复模式就能在文件系统里改配置。这也是为什么我一直推荐玩树莓派的人备一个几块钱的 USB 转 TTL 模块，平时吃灰也没关系，关键时刻比任何高级工具都管用。
5. 实测中掉过的坑：问题排查速查表
两种方法单独看都不复杂，可实际用起来，很多问题是在组合场景里出来的。我把这些年反复踩过的坑整理成一份速查表，按现象、原因、解决方式排列，照着排除能省不少时间。
| 现象 | 原因 | 解决方式 |
|---|---|---|
| Windows 下串口工具里看不到 COM 口 | 驱动没装或者主板识别不到 | 安装 CH340/CP2102 对应驱动，检查设备管理器 |
| 串口工具打开后没有任何输出 | TXD/RXD 接反，或没有 GND 共地 | 交换 TXD 和 RXD 两根线，确认 GND 连着 |
| 满屏乱码 | 波特率设置不一致 | 统一改成 115200 |
| 能 ping 通但 SSH 拒绝连接 | 系统没开 SSH 服务，或端口被占用 | 在 boot 分区补ssh文件，或者检查服务状态 |
| SSH 连接超时或频繁断开 | 树莓派供电不足，网卡不稳定 | 换 5V/3A 电源，避免劣质充电头 |
| 串口能登录但分辨率/图形界面启动失败 | 内存分配给 GPU 不足或配置错误 | 在 config.txt 调整 gpu_mem，或直接用命令行模式 |
| 改完 cmdline.txt 启动卡死 | console 参数写错或删了不该删的内容 | 用备份恢复原文件，确认 console 指向正确设备 |
| 树莓派休眠或掉线后 SSH 失联 | 电源管理或 WiFi 省电模式 | 禁用 WiFi 省电：sudo iw dev wlan0 set power_save off |
上面这些坑，我基本都亲身遇到过一遍。供电不足这条特别值得强调，树莓派对电源质量比较敏感，尤其是接了外设或者 WiFi 环境差的时候。劣质充电头带不动，网卡就会反复掉线，表面看是 SSH 不稳定，实际上是“饿”出来的。我现在给所有板子配的都是质量可靠的 5V/3A 电源，从此这类地雷基本绝迹。
还有一个细节：如果同时插了 HDMI 显示器和串口线，某些系统版本会尝试让两个都做控制台，这是正常的，不影响使用。但如果你的程序要独占串口，记得把cmdline.txt里的console=serial0,115200删掉，否则系统登录进程会抢占/dev/serial0，程序打开时候报“无法打开设备”的错。
6. 一点心得
我个人在实际操作中体会到，学习树莓派连接方式最有价值的一点，不是背步骤，而是理解“访问路径”这个概念。SSH 是一种路径，串口是另一种路径。每个方案都有自己的边界，也有自己的不可替代性。一个项目里最适合的连接方式往往由瓶颈决定：你要是只是远程跑服务，那 SSH 就够了；你要是需要极早期调试、需要在系统还没起来时就介入，串口就是答案。
最后分享一个小技巧：不管用哪种方式连接，我都习惯在树莓派上装好 tmux。这样即使 SSH 突然断了，原来跑着的命令还会在后台继续执行，重连之后tmux attach就能回到原现场。这个习惯帮我避免过好几次“跑到一半断线，程序白跑”的尴尬。毕竟连接方式只是入口，真正让你改得顺手的是后面那一套稳定的工作流。