树莓派5无外设安装Ubuntu Server:从烧录到SSH远程登录全流程 📅 发布时间:2026/9/7 13:00:37 👁 浏览次数: 树莓派5刚拿到手的时候我手边正好没有多余的HDMI线也没有键盘鼠标连显示器都是借来的笔记本顶着的。当时第一反应是有点慌系统都没装上怎么把Ubuntu弄进去后来实测下来整个过程其实根本不需要外设。你只要有一台电脑、一张TF卡、一个读卡器再加一点耐心就能在没有显示器、没有键盘鼠标的情况下把Ubuntu Server装进树莓派5并且用SSH远程登录进系统。这篇文章我把整个流程和踩过的坑完整写下来。先剧透一下核心思路树莓派本身就是一台迷你电脑它支持从TF卡启动系统也支持把Wi-Fi密码、SSH配置这些“预置信息”预先写到卡里。只要你把系统镜像写进TF卡再往卡里塞一份“联网说明书”树莓派上电后会自己找Wi-Fi、自己打开SSH服务等它在局域网里“亮出身份”你用电脑SSH连上去就完成了整个安装。整个过程和有没有显示器没有半毛钱关系。这篇文章适合所有刚入手树莓派5、手边又没有外设的玩家参考也适合后续想用树莓派当无头服务器、NAS、智能家居中枢的朋友。我会从原理、烧录、预配置、登录、排查五个部分展开尽量把每个步骤背后的为什么也讲清楚。1. 无外设安装的前提与整体思路1.1 为什么没有外设也能完成系统安装很多人第一次接触树莓派下意识觉得装系统必须得像台式机一样接显示器看BIOS、选启动U盘、一步步点安装界面。树莓派不是这个逻辑它的系统安装更像“刷机”把整个操作系统镜像直接写入TF卡然后把卡插进树莓派上电就能跑不需要交互式安装步骤。既然没有交互那自然就不需要键盘鼠标显示器。但这里有个隐藏问题系统装好之后你怎么知道它的IP地址怎么给它配置Wi-Fi树莓派官方镜像和Ubuntu官方镜像都考虑到了这个场景预留了“首次启动配置”的入口。树莓派启动时系统会读取TF卡系统分区里的特定配置文件比如network-config、user-data然后根据这些文件自动配置网络和用户。你只需要在另一台电脑上用读卡器把TF卡插上提前把Wi-Fi的SSID、密码、用户名、SSH公钥这些东西写进文件里然后拔卡、插卡、通电树莓派就会“照着剧本”自己完成联网和SSH服务开启。打个比方SD卡就是一张“自带钥匙的门禁卡”。没有外设时你做的所有操作都是在给这张门禁卡提前写授权信息树莓派上电后自己开门等你进来。1.2 无外设安装的三个关键步骤整个流程总结起来就是三步烧录、预配置、登录。烧录是把Ubuntu官方针对树莓派制作的系统镜像写入TF卡。预配置是修改卡里的两个文件一个叫network-config负责让树莓派开机后自动连接你家的Wi-Fi另一个叫user-data负责创建你的登录账号并注入SSH公钥或密码。最后一步是等树莓派上电启动后在你的电脑上用SSH客户端找到并登录它。听上去很简单实际操作中容易翻车的点其实不少。比如TF卡的质量和速度会影响启动稳定性Ubuntu镜像和树莓派官方OS的预配置方式有细微差别Wi-Fi配置文件的YAML格式要求极严格多一个空格都可能不生效还有树莓派5的供电要求比前代更高电源功率不够会出现各种莫名其妙的问题。这些我都会在后面逐个展开。1.3 需要准备的硬件与软件清单先列一下我实际用到的设备和工具大家对照准备树莓派58GB版本但2GB、4GB版流程完全一样TF卡至少16GB建议32GB以上且速度等级尽量选U3/A2。卡的速度直接决定安装系统后的使用体验。我用过普通Class 10的旧卡装完系统后apt更新时明显卡顿换A2卡后才流畅。USB读卡器或者笔记本电脑自带TF卡槽一台电脑系统不限Windows、macOS、Linux都行用于烧录镜像和修改配置文件一个正常的路由器以及一个可用的2.4GHz或5GHz Wi-Fi网络。如果暂时没有Wi-Fi用网线直连树莓派和电脑也可以我后面会讲Raspberry Pi Imager烧录工具从官方渠道下载免费且支持全平台Ubuntu针对树莓派架构的官方镜像在Ubuntu官网下载另外强烈建议准备一个好点的USB-C电源。树莓派5的官方电源是27W5V/5A如果你用的是手机充电器很可能因为供电不足导致启动反复失败这个问题我在第5部分单独说。2. 系统镜像选择与烧录实操2.1 Server版还是Desktop版无外设场景怎么选Ubuntu官方为树莓派提供两个方向的镜像Ubuntu Server和Ubuntu Desktop。如果你是想把树莓派当成一台24小时开机的小服务器跑Docker、写代码、做NAS、当网关那就选Ubuntu Server。它没有图形桌面默认轻量SSH支持最完善正好契合无外设安装的场景。登录后就是一个纯命令行环境操作直接、占用低。如果你想在树莓派上体验桌面环境Ubuntu Desktop自然更合适但它默认会启动图形界面、桌面管理器、各种后台服务性能开销大不少而且没有显示器的话桌面也看不到纯属浪费。当然了Desktop版同样支持SSH远程登录装上后你用VNC之类的方式也能远程看到图形桌面但那就偏离“无外设安装”的初衷了。我的建议很明确无外设首次安装用Ubuntu Server省心、稳定、资源占用低。版本方面树莓派5推荐直接用24.04 LTS或更新的长期支持版。LTS版本支持周期长内核和树莓派固件适配也成熟避免踩“内核太老识别不了新硬件”这种坑。至于32位还是64位树莓派5本身就是64位CPU直接无脑选64位镜像。2.2 用Raspberry Pi Imager烧录Ubuntu镜像Raspberry Pi Imager是树莓派官方出的烧录工具比dd命令更适合新手图形界面直观还能在线选择镜像。步骤非常简单下载并安装Raspberry Pi Imager。选择“选择设备”里的“Raspberry Pi 5”。点击“选择操作系统”在“Other general-purpose OS”里找到“Ubuntu”然后选择对应的Ubuntu Server 24.04 LTS64-bit。插入TF卡在“选择存储设备”里选到你的TF卡。点击“下一步”烧录工具会提醒你是否要应用自定义设置这里就是无外设安装的关键入口。在“编辑设置”界面可以提前设置主机名、用户名、密码、Wi-Fi国家、Wi-Fi SSID和密码以及“启用SSH服务”选项。点“保存”然后确认烧录等待写入完成即可。我自己的体会是Imager的高级设置对“树莓派专用OS”最顺手写入Ubuntu官方镜像时这个“自定义设置”不一定百分之百生效。如果你烧录完成后用Imager设置的Wi-Fi和用户能正常登录那就省事了如果启动后怎么都连不上多半是自定义设置没生效这时就要用第3章的手动改文件方案。2.3 TF卡选择与烧录后的分区结构TF卡的选择直接影响安装体验。树莓派5支持SDXC和UHS-I建议至少16GB我自己用的是32GB的三星EVO Plus A2卡实测顺序读取稳定在100MB/s以上运行Ubuntu时apt、Docker这些重IO操作都还算流畅。如果你手里只有老旧的Class 10卡也能凑合跑但别对启动速度和软件更新速度抱太高期待。烧录完成后把TF卡插回电脑你会看到Ubuntu镜像把卡分成了两个分区。第一个分区名为system-boot是FAT32格式这个分区Windows和macOS都能直接打开第二个分区是writable是ext4格式存储根文件系统。我们需要修改的network-config和user-data文件就在system-boot分区里。你可以把它理解成树莓派启动时“最先读到的一段代码”它只负责给CPU传递网络和用户配置改起来风险很低。后面所有预配置操作都集中在这个分区内完成。3. 预配置Wi-Fi与SSH让系统一开机就能连网3.1 修改network-config注入Wi-Fi信息Ubuntu官方树莓派镜像的system-boot分区里有一个network-config文件。这个文件的本质是一段YAML格式的netplan配置系统启动时会读取它来配置网络接口。默认情况下文件里绝大部分内容都被注释掉了只有ethernets下面的eth0处于疑似启用状态。我们只需要把wifis部分的注释放开填入你的Wi-Fi信息。我用的是这样的配置version: 2 ethernets: eth0: dhcp4: true optional: true wifis: wlan0: dhcp4: true optional: true access-points: 你的WiFi名称: password: 你的WiFi密码这里有几个细节非常关键。第一YAML对缩进极其敏感必须用空格缩进不能用Tab键而且每一级的空格数要统一。第二Wi-Fi名称和密码如果包含特殊字符建议用双引号包起来避免格式解析出错。第三optional: true这个字段别删它表示“即使这个网卡没连上也不要阻塞系统启动”否则网络配置失败可能会拖慢开机甚至卡住。配置完成后保存文件、安全弹出TF卡、插回树莓派。上电后树莓派会在几十秒内尝试连接Wi-Fi。这个过程中你没有任何画面可看只能靠后面的IP发现来验证它是否连上了网络。3.2 用cloud-init创建用户并注入SSH公钥Ubuntu镜像和树莓派OS在用户创建机制上不太一样。树莓派官方镜像默认用户是pi但Ubuntu镜像用的是cloud-init通过system-boot分区里的user-data文件来初始化用户。实操中我发现不同版本的Ubuntu镜像默认用户可能不太一样与其猜默认账号不如自己主动写入一个用户这样最稳妥。在system-boot分区里有一个user-data文件它通常已经是一份完整的cloud-init配置。我们可以在文件的头部增加一个“#cloud-config”开头的内容块示例#cloud-config users: - name: ubuntu groups: [adm, sudo] shell: /bin/bash sudo: ALL(ALL) NOPASSWD:ALL ssh_authorized_keys: - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC... 你的公钥 ssh_pwauth: true这段配置的意思是创建一个名叫ubuntu的用户加入sudo管理组首次登录时不需要密码就能用sudo提权并且把本机的SSH公钥注入到这个用户的可信列表里。这样你从电脑SSH登录时就可以免密登录非常顺手。需要说明的是user-data文件里可能已经有了一个users配置块如果你不确定如何合并一个相对安全的做法是只修改文件中已经存在的用户配置把用户名改成你自己想要的然后设置一个密码的哈希值或者直接在文件中追加ssh_authorized_keys。如果你在Imager的高级设置里已经设置了用户名密码再去手动改user-data可能会覆盖掉之前的配置所以这些操作要么只走图形界面要么只走手动改文件不要两套方案混着来。3.3 备用方案有线网口直连Wi-Fi配置固然方便但如果你的环境没有Wi-Fi或者路由器的无线信号不稳定还有一个同样不需要外设的备选方案直接用网线把树莓派的千兆网口和电脑的网口连起来。树莓派5默认开启DHCP在有线直连的情况下它会通过链路本地地址169.254.x.x和电脑通信。之后你可以用mDNS主机名或扫描工具找到它。实际操作中直连方式比Wi-Fi更稳定排查起来也更简单。只要网线插上电脑端能看到一个新的网络接口树莓派基本就是活的。找到它的IP后SSH登录方式和Wi-Fi场景完全一样。所以我一直认为如果条件允许第一次无外设安装建议优先插网线Wi-Fi留到登录系统后再用命令行配置能少踩不少坑。4. 无显示器下发现设备并完成首次登录4.1 找到树莓派IP的三种方法树莓派联网了但它没有显示器你也不知道它的IP是多少。这一步是很多新手卡住的地方。我总结三个由易到难的方法。第一种最直观——登录你的路由器管理后台找到“DHCP客户端列表”看看有没有一个名字带ubuntu或者树莓派默认主机名的设备记下它的IP地址。家用路由器一般都能看到设备的IP和MAC地址这一招几乎百发百中。第二种用mDNS。如果你在Imager或user-data里设置了主机名并且电脑支持mDNS协议可以直接尝试ping ubuntu.localmacOS和大多数Linux系统默认支持mDNSWindows需要先安装Bonjour服务。如果返回了IP直接ssh登录即可。第三种用扫描工具扫局域网。电脑装上nmap后执行nmap -sn 192.168.1.0/24扫描结果里会出现一个开放22端口且主机名带ubuntu前缀的设备那就是树莓派。注意把网段替换成你自己局域网的网段可以在电脑的“网络设置”里查到。我自己的习惯是把三种方法组合使用先看路由器后台找不到就用nmap扫一遍基本不会失手。4.2 SSH登录并完成基础配置知道IP之后SSH登录就简单了。Windows直接用PowerShell或Windows TerminalmacOS和Linux用自带的终端ssh ubuntu192.168.1.100这里有个经验树莓派5上电启动到SSH服务可用通常需要30秒到1分钟。如果刚插电就急着连大概率会“Connection refused”这不是你配置错了是系统还在启动中。稍微等一等心跳平稳了再连。首次SSH登录可能会提示确认主机指纹输入yes回车即可。如果你之前注入了SSH公钥那直接免密进入如果只设置了密码输入密码即可。登录后第一件事是确认用户身份和网络状态whoami ip a ping -c 4 223.5.5.5能看到本机IP和能ping通外网说明无外设安装这一步已经大功告成系统层完全正常。接下来你就可以像操作一台普通Linux服务器一样使用它了。这里顺带回应一个很多人问的问题Ubuntu怎么切换到超级管理员其实在SSH登录后你的用户已经在sudo组里直接执行sudo -i就能切换到root不需要root密码。如果确实要给root设置密码可以执行sudo passwd root设置完root密码后用su -也能切换到root。但从安全角度看日常操作建议始终用普通用户加sudo不要长期以root身份跑。4.3 换软件源、更新系统与常用工具安装系统能上网了第一波操作自然是更新软件源和升级系统。这一步在国内网络环境下有个优化空间Ubuntu默认的软件源服务器是官方的ports.ubuntu.com从国内访问可能较慢甚至出现连接超时。可以把软件源替换成国内的镜像源操作很简单先看看你的源文件在哪里ls /etc/apt/sources.list.d/ cat /etc/apt/sources.list.d/ubuntu.sources新版Ubuntu会使用deb822格式所有软件源都集中在一个文件里。把文件里的ports.ubuntu.com替换成国内镜像源域名即可以阿里云镜像为例sudo sed -i s|http.*ports.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list.d/ubuntu.sources sudo sed -i s|ports.ubuntu.com|mirrors.aliyun.com|g /etc/apt/sources.list.d/ubuntu.sources如果你看的是老式结构的目录修改/etc/apt/sources.list把ports.ubuntu.com替换成镜像域名同理。替换之后执行sudo apt update sudo apt upgrade -y等待升级完成后建议顺手装几个基础工具sudo apt install -y vim git htop curl wget net-tools到这里一个能联网、能远程登录、软件源正常、有基础运维工具的Ubuntu系统就跑起来了。整个过程没有碰过一次显示器和键盘。5. 常见问题排查与避坑经验5.1 Wi-Fi配置不生效怎么办Wi-Fi配置是整个流程里最容易出问题的环节而且因为没有任何画面出了问题只能盲查所以需要系统性地排查。我遇到过的情况主要有三类。第一类YAML格式写错了。network-config文件对空格和缩进极度敏感一旦格式错误netplan会拒绝应用配置树莓派就会一直处于“没有网络”的状态。排查方法是用网线进入系统输入sudo netplan try sudo netplan apply或者查看日志journalctl -u networking --no-pager | tail -20日志里会直接告诉你哪一行解析失败。如果没法用网线就要把TF卡重新插回电脑逐字检查空格和缩进特别是SSID那一行的缩进层级。第二类Wi-Fi频率或加密方式不匹配。树莓派5支持2.4GHz和5GHz频段但如果你的路由器把两个频段拆成了两个SSID而你的配置写了5G那个恰好树莓派所在位置5G信号弱就会出现连不上的问题。建议首次配置时优先用2.4GHz的SSID覆盖范围更广、兼容性更好。第三类Wi-Fi密码含特殊字符。YAML中如果密码里有冒号、引号、井号等特殊字符会被误解析。解决方式是把整个密码用双引号包起来并且确认密码前后没有多余空格。5.2 找不到IP或SSH连接失败的排查如果你等了1分钟路由器后台还看不到树莓派的IP先别急着怀疑配置从头检查这几项TF卡是否插紧、电源功率是否足够、路由器是否开启了AP隔离很多访客模式会隔离客户端间的通信导致SSH连不上、配置文件的文件名是否拼写正确。如果能看到IP但SSH连接被拒绝大概率是22端口没有开启。检查方法是在路由器后台确认设备在线后用网线接入进去看SSH状态。没有网线的话重做user-data里的ssh_pwauth设置确认它被设为true。Ubuntu镜像默认虽然没有强制关闭SSH但在某些自定义配置下SSH服务可能没有被安装或启用。这时候只能插回TF卡确认system-boot分区里有network-config、user-data并且没有被改坏。解决之后可以用一个命令检查cloud-init的执行状态sudo cloud-init status --long这个命令会显示cloud-init是否成功执行以及有没有报错信息对排查用户创建失败、网络配置失败非常有用。5.3 供电、TF卡与镜像版本避坑树莓派5对电源的挑剔程度远超你的想象。我一开始用了一个充电功率标称18W的氮化镓充电器结果系统启动到一半就崩溃路由器后台反复出现设备上线又掉线。更换官方27W电源后一切恢复正常。如果你的树莓派5出现了“启动过后自动重启”“SYS灯一直在闪”“Wi-Fi时有时无”等现象优先怀疑电源。在无外设场景下这类问题没有任何画面提示非常容易被误判成系统镜像问题。TF卡同理。有些卡标称容量很大但实际写入速度极慢甚至存在扩容卡的情况。建议烧录系统时使用U3/A2级别的正规卡并在烧录完成后重新插拔一次确认镜像被完整写入。如果烧录过程中出现“校验失败”之类的提示别将就直接换一张卡再试。镜像版本上一定要选择官方渠道下载的树莓派适配镜像不要贪图网上乱七八糟的第三方集成版。官方镜像虽然安装后需要自己配很多东西但至少不会出现“不自知的系统问题”排查起来逻辑清晰。5.4 远程图形界面应急方案如果你实在不习惯纯命令行或者后续有图形界面需求也并不是完全没有办法。在无外设、系统已经装好的前提下你可以用SSH安装轻量桌面和远程桌面服务然后用电脑远程查看树莓派的图形桌面。我曾经在一台树莓派5上先最小化安装Ubuntu Server再通过SSH安装ubuntu-desktop-minimal和x11vnc最后在电脑上用VNC Viewer连接效果还算流畅但整体流畅度和功耗天然不如树莓派OS下优化得好。这个方法适合“应急看看界面”真正长期用我更建议命令行加良好运维习惯资源占用低效率也更高。写在最后的几句心里话整个无外设安装流程跑下来我最大的体会是树莓派这类单板电脑的设计哲学从一开始就默认你会用远程方式去管理它所以系统的“无人值守”能力被做得很完善。第一次操作时最难的往往不是操作本身而是你不知道它到底有没有成功联网、有没有成功启动所有问题都只能靠间接信号去猜。所以我把排查思路整理成了前面的速查表强烈建议大家在动手前把配置文件逐行多检查一遍确认无误再上电能省下大量盲排时间。另外一个小技巧配置完成后不要把TF卡里的network-config和user-data删除也不用担心它们残留影响系统。这些文件在首次启动后已经完成了使命后续系统运行不再依赖它们。保留它们还有一个好处下次想重装系统时直接复制这些文件就能复用整套配置连写Wi-Fi密码的功夫都省了。没外设的树莓派5装Ubuntu真的不复杂。系统起来之后你就会发现这台小机器能干的事情比想象中多得多。后面我打算继续写树莓派5上的Docker部署和一些网络服务的搭建如果大家有兴趣评论区见。