在嵌入式开发和单板计算机的日常使用中树莓派5算是我最近折腾得最多的一块板子而“没有外设”这个条件其实比大多数人想象中更常见。可能你的显示器刚好是HDMI只有A口能用可能你手边只有一台笔记本再加一根网线也可能你压根就是想把它做成一个无头服务器丢在弱电箱里。无论哪种情况提前掌握无外设安装Ubuntu的方法都能省下很多来回插拔键鼠和显示器的功夫。这篇内容我会围绕一个核心场景展开不接显示器、不接键盘鼠标仅靠一台普通电脑和一张SD卡把Ubuntu装进树莓派5并顺利进入系统。整个流程会拆到最细包括原理、工具、配置、踩坑适合刚接触树莓派5的初学者也适合想把部署流程标准化的老玩家作为参考。1. 项目整体设计思路解析1.1 为什么要做无外设安装树莓派5和之前的树莓派4B在安装系统这件事上逻辑其实差不多但由于板载接口和电源规格的变化很多人第一次上手时反而更容易被“没有显示器”这个问题卡住。传统的安装方式很直接把镜像写进SD卡插上HDMI显示器、USB键鼠上电然后在图形界面里一步步点完初始设置。这个方式在有一整套外设的环境里当然没问题但遇到几种实际场景就比较尴尬。第一现在的笔记本和轻薄本基本没有HDMI输入口只有输出口你想让笔记本当树莓派的显示器也行不通除非额外买采集卡。第二树莓派5对HDMI线缆和显示器的兼容性偶尔会闹脾气我遇到过同一根线在4B上完全正常换到5上就黑屏的情况排查起来非常浪费时间。第三如果你要做多台设备的批量部署比如一口气配置五台树莓派5做集群每台都去接显示器输一遍账号密码那效率实在太低了。所以无外设安装的核心思路就是把“首次启动后的交互式配置”提前到镜像写入阶段完成。说白了我们在给SD卡写系统的同时顺便把用户、密码、网络这些信息也写进去让树莓派5上电之后自己就能完成配置、连上网络、开启SSH整个过程不需要任何外设介入。这个思路在现代Linux发行版里已经很成熟树莓派官方系统和Ubuntu都提供了相应的预配置机制。1.2 为什么选树莓派5加Ubuntu这个组合树莓派5是目前树莓派家族里性能最强的型号搭载了博通BCM2712四核Cortex-A76处理器主频最高能到2.4GHz内存有4GB和8GB可选我在实际测试中跑编译任务比4B快了一半不止。性能上来之后它能干的事情就多了Ubuntu这样完整的Linux发行版跑起来才真正“不憋屈”。树莓派官方系统Raspberry Pi OS是基于Debian的日常用没什么问题但如果你要跑Docker容器、Kubernetes、或者想跟服务器环境保持一致Ubuntu的优势就很明显。Ubuntu Server是纯命令行版本没有图形桌面内存占用低而且针对树莓派硬件做了专门的优化内核、固件都跟进得比较勤。Canonical官方提供树莓派5的Ubuntu 24.04 LTS镜像这意味着你能拿到长期支持安全更新和bug修复持续到2029年这对服务器用途来说非常重要。还有一个关键点是生态兼容性。很多开源项目、教程、云镜像、自动化脚本都是围绕Ubuntu写的用Ubuntu可以少踩很多“发行版差异”的坑。比如你照着网上的教程装Docker、配置Nginx、部署K3sUbuntu下的命令和包管理方式跟你云服务器上完全一致学一次到处能用。树莓派5的硬件性能和Ubuntu的软件生态结合起来就是一台功耗极低、噪音为零、能长期稳定运行的迷你服务器。2. 核心原理与安装前准备2.1 准备好这些装备再开工正式开始之前先把手头的东西清点一遍。首先是一张SD卡树莓派5支持SD卡启动推荐至少32GB起步U3或者A2级别的卡读写速度更快系统启动和软件安装体验会好很多。我日常用的是64GB的闪迪至尊极速烧录Ubuntu Server镜像后剩余空间还能存不少Docker镜像和日志数据。其次是一台用于烧录系统的电脑。这台电脑用什么系统都行Windows、macOS、Linux都可以关键是装好烧录工具。我后面使用的树莓派官方烧录工具Raspberry Pi Imager是跨平台的而且自带了预配置功能非常省事。然后是网络环境。从树莓派5上电到它自动连上Wi-Fi或网线中间不需要你做任何操作但前提是你的网络环境有一个DHCP服务器几乎所有的家用路由器都是能让树莓派拿到IP地址。同时你的电脑和树莓派需要在同一个局域网内这样SSH才能连通。如果条件允许优先用网线直连路由器比Wi-Fi稳定、速度快、排查问题简单。我最早调试的时候也尝试过Wi-Fi方式后来发现网络配置稍微有点问题连不上又看不到界面排查起来远不如网线直观。所以我的建议是首次安装老老实实用网线系统跑起来之后再配置Wi-Fi。2.2 树莓派5的启动流程与eeprom机制理解了启动流程很多配置上的“为什么”就自然解开了。树莓派5内置了一块SPI闪存存放着EEPROM固件作用类似于PC的BIOS。板子上电后首先是这个固件初始化内存和电源管理然后根据启动模式配置去查找启动设备。树莓派5默认支持SD卡和USB启动首次使用的时候把系统烧到SD卡里插上卡就能引导。EEPROM里还存有一份被称为bootcode的配置控制着启动时的行为包括是否检查显示器、是否等待键盘输入、甚至能不能通过USB直接启动。对于无外设安装来说一个很关键的细节是树莓派在检测不到显示器的情况下会自动启用无头模式也就是不尝试输出画面、不等待用户操作直接进入系统启动流程。这个行为是内置的不需要额外配置所以我们才能实现“上电即启动”。Ubuntu在树莓派5上的启动还会额外用到U-Boot引导器它位于SD卡的启动分区中树莓派的EEPROM加载U-BootU-Boot再加载Ubuntu的内核和initramfs最终挂载根文件系统完成启动。如果你以后需要换内核、调整启动参数修改的是U-Boot的配置文件config.txt和cmdline.txt这两个文件都在启动分区里直接在电脑上编辑SD卡里的文件就行。2.3 Ubuntu版本选择为什么首推24.04 LTS树莓派5刚发布的时候Ubuntu支持的版本是23.10属于短期版本生命周期只有九个月。这个版本我当时试用过能用但很多优化还没跟上。到了2024年发布的Ubuntu 24.04 LTS也就是Noble Numbat对树莓派5的支持已经非常成熟无论是Wi-Fi驱动、GPU驱动还是电源管理都做得比较到位。所以新手首推Ubuntu Server 24.04 LTS原因有三个。第一LTS版本支持时间有五年适合搭建长期运行的服务不用每隔几个月就考虑升级。第二社区用户基数大你遇到任何问题网上几乎都能搜到别人已经解决过的方案这个对新手来说太重要了。第三针对树莓派5的硬件支持已经补齐了蓝牙、Wi-Fi、RTC时钟、NVMe SSD这些功能都能正常用。如果你一定要图形桌面也可以选择Ubuntu Desktop 24.04 LTS但说实话在树莓派5上跑完整桌面体验还达不到主力机的水平而且消耗大量内存。无头安装场景通常是做服务器所以我的建议是直接用Ubuntu Server轻量干净想要桌面的时候后面再装个轻量级桌面环境也不是不行。3. 无外设安装Ubuntu实操全流程3.1 用Raspberry Pi Imager烧录Ubuntu镜像工具我推荐直接用Raspberry Pi Imager它是树莓派官方出的界面简单功能却很够用。下载安装后打开主界面会让你选择三样东西树莓派设备型号、操作系统、存储卡。操作系统这里不建议手动下载ISO然后选择自定义镜像因为Imager内置的操作系统列表里已经收录了Ubuntu Server 24.04 LTS的官方镜像选起来很省事。具体路径是选择设备Raspberry Pi 5然后进入Other general-purpose OS找到Ubuntu里面会列出多个版本服务器版选Ubuntu Server 24.04 LTS桌面版选Ubuntu Desktop 24.04 LTS。选好之后插上SD卡选择对应的磁盘点击写入就可以。写卡的时间取决于SD卡速度和镜像大小一般三到五分钟。写入完成后Imager会校验一遍数据确认无误后提示完成。这个时候不要急着拔卡我们还有一步关键的初始化配置要做。在Imager点击写入按钮之前它通常会弹出一个“编辑设置”的选项允许你设置主机名、启用SSH、配置Wi-Fi、预设用户名密码。如果你直接跳过了这个设置也可以在烧录完成后手动修改SD卡里的文件我们接着往下看。3.2 关键的预配置用户账户与SSH开启烧录完Ubuntu镜像后SD卡会被分成两个分区Windows下能看到一个名为system-boot的FAT分区另一个是ext4格式的根文件系统分区Windows会提示无法访问这很正常不用管它。所有预配置操作都在system-boot分区里完成。在system-boot分区里有一个名叫user-data的文件这是cloud-init的配置文件。cloud-init是Ubuntu在云环境和嵌入式设备上自动完成初始化的工具它会在系统第一次启动时读取这个文件并执行里面的指令。我们需要做的就是编辑这个文件告诉cloud-init创建一个属于我们的用户、设置密码、并且允许SSH登录。用文本编辑器打开user-data文件往下翻在users:这一段默认是注释状态。把它改成类似下面这样users: - name: ubuntu sudo: ALL(ALL) NOPASSWD:ALL groups: users, admin shell: /bin/bash lock_passwd: false plain_text_passwd: yourpassword ssh_authorized_keys: - ssh-ed25519 AAAAC3... your-key-comment这里我做了几件事。name是用户名你想叫什么都行sudo给了免密sudo权限方便首次登录后立即执行管理命令plain_text_passwd是明文密码系统首次启动后就会用这个密码初始化账户ssh_authorized_keys是可选的如果你手头有自己的SSH公钥加进去之后就能直接免密登录安全性比密码登录高一个档次。如果没有公钥留空也没关系后面我们可以用密码登录后再补。改完user-data文件保存再确认一个问题system-boot分区里有没有一个叫ssh或者ssh.txt的空文件有些Ubuntu镜像默认没有开启SSH服务如果没有这个文件就在system-boot目录下新建一个空的ssh文件这样系统第一次启动时就会自动启用OpenSSH服务。如果镜像本身预配了SSH这一步可以跳过但为了保险起见动手创建一个空文件并不会有什么副作用。3.3 配置网络Wi-Fi与有线两种方式树莓派5有Wi-Fi模块所以理论上你完全能做到无网线、只靠无线网络就能远程连接。系统启动时读取的无线网络配置也是放在system-boot分区里文件名叫做network-config这是Ubuntu的Netplan配置文件。如果你打算用网线连接那这一步基本可以跳过。树莓派插上网线路由器DHCP自动分配IP系统启动后自动获取地址什么都不用配。但如果想用Wi-Fi必须提前在network-config里写好Wi-Fi信息。打开文件后找到wifis:这一段把注释去掉改成wifis: wlan0: dhcp4: true optional: true access-points: 你的WiFi名称: password: 你的WiFi密码注意几点wlan0是树莓派5的无线网卡接口名不要改Wi-Fi名称和密码用英文双引号包起来密码至少8位不支持旧版的WEP加密方式用WPA2/WPA3都行dhcp4: true表示通过DHCP自动获取IP地址。如果你的Wi-Fi网络隐藏了SSID可以额外加一行hidden: true否则它可能扫描不到。还有一个细节是区域的设置。树莓派的无线模块有一个国家/地区码限制如果地区码没有设置Wi-Fi可能不会正常工作。在system-boot分区里找到config.txt文件在末尾检查是否有country这一项如果没有就加上countryCN我这里用CN举例具体根据你所在地区填写即可。设置正确之后重启即可生效。如果之前已经启动过系统也可以在登录系统后运行sudo raspi-config这个命令是树莓派固件包自带的进入本地化选项里把Wi-Fi Country选对。3.4 上电启动用SSH与树莓派5第一次亲密接触预配置完成之后安全弹出SD卡插入树莓派5接上网线或者等待Wi-Fi连接最后插上USB-C电源线开机。树莓派5建议使用官方27W电源适配器它能提供5V/5A的输出如果用一个普通的手机充电器遇到高负载场景电压跌落会出现性能下降甚至重启的问题这个坑我一开始就踩过后来换了电源就再没犯过。给树莓派五分钟左右的时间完成首次启动。首次启动要做的事情很多扩展根分区、应用cloud-init配置、启用SSH服务、生成SSH主机密钥整个过程比后续正常启动要慢一些。然后到你的路由器管理界面里看DHCP客户端列表找一个新出现的设备它可能就是你的树莓派。主机名默认是ubuntu所以在这张列表里通常也会显示为ubuntu。如果你手头的网络环境无法登录路由器也可以用网段扫描的方式找电脑上执行一下ARP扫描或者用手机App扫描局域网设备一般都能发现。比如自己电脑的IP是192.168.1.100那树莓派多半就在192.168.1.1到192.168.1.255这一段里。Linux或者macOS的电脑可以直接跑nmap -sn 192.168.1.0/24Windows上用Advanced IP Scanner也挺方便。找到IP地址之后打开终端执行SSH连接命令ssh ubuntu192.168.1.xxx这里的ubuntu是你在user-data里设置的用户名如果忘了设置Ubuntu Server 24.04的默认用户是ubuntu默认密码也是ubuntu但首次登录会强制要求你修改密码。连接成功后系统会提示确认主机指纹输入yes回车然后输入密码看到类似下面这样的输出就说明成功了Welcome to Ubuntu 24.04 LTS (GNU/Linux 6.8.0-xxxx-raspi aarch64) * Documentation: https://help.ubuntu.com * Management: https://landscape.canonical.com * Support: https://ubuntu.com/pro Last login: ...注意看aarch64这个字段它代表的是64位ARM架构说明你的内核和发行版是64位的能充分利用树莓派5的性能。登录进去之后我建议先做几件事。第一sudo apt update sudo apt upgrade把系统里的软件包更新到最新版本这个过程可能持续几分钟取决于网络速度。第二hostnamectl查看一下系统信息确认版本号、内核版本、硬件架构都正确。第三如果你想要静态IP地址可以编辑Netplan配置文件为后续提供服务做准备。第四如果打算长期使用建议立刻配置SSH密钥登录然后关闭密码登录这样远程连接既方便又安全。3.5 初始化系统的基本设置第一次进入可用的系统之后还远远没到收工的时候。一个干干净净的Ubuntu系统想要顺手用起来还需要做一轮初始化设置。首先是更新软件源。默认源地址是Canonical官方服务器国内访问速度因网络环境而异如果你在内地使用建议换到合适的镜像源具体操作是编辑/etc/apt/sources.list.d/ubuntu.sources文件把URL替换成可用的镜像地址然后sudo apt update。换完源再安装软件速度差别非常明显。其次是设置主机名。默认主机名实在缺乏辨识度如果同时跑好几台机器很容易搞混。改主机名的命令是sudo hostnamectl set-hostname rpi5-server改完重新登录终端就能看到新名字生效。然后是时区设置。服务器时间不对会带来很多莫名其妙的问题最简单粗暴的方法是sudo timedatectl set-timezone Asia/Shanghai把时区设到你所在的区域再用date命令确认一下时间是否正确。最后是安装一些基础工具。我每次装完系统都会顺手装上这些包git curl wget htop neofetch ufwGit和curl是开发刚需htop用来查看系统资源占用neofetch可以快速查看系统信息ufw是防火墙。防火墙建议开启只放行必要端口尤其是服务器暴露在公网环境时这一步不能偷懒sudo ufw allow OpenSSH sudo ufw enable这样仅打开SSH端口其余端口默认拒绝外部访问能挡住不少扫描和探测。4. 常见问题与排查技巧实录4.1 路由器里找不到树莓派的IP地址这是无外设安装失败率最高的一个环节。插上电源之后等了好几分钟路由器后台设备列表里死活找不到新设备。遇到这种情况我的排查顺序是固定的。先看电源指示灯。树莓派5上的红灯亮起只代表供电正常但系统有没有起来还得看绿灯的活动状态。如果绿灯常亮不闪大概率是系统没引导成功SD卡有问题或者没插好。如果绿灯有规律地闪烁说明系统卡在启动过程中需要接上显示器看具体日志。再看网络连接。如果是网线连接路由器对应的LAN口指示灯是否亮起网线两端的插头是否牢固。如果用的是Wi-Fi排查就要麻烦一点network-config里最常见的问题是密码写错或者加密方式不对。还有一个小坑是Wi-Fi的名称里如果包含中文或者特殊字符Netplan配置文件解析时可能会出错建议改成纯英文的SSID测试。最后确认是不是首次启动还没完成。Ubuntu Server首次启动时要展开分区、生成SSH密钥、执行cloud-init这个时间在树莓派5上大概三到五分钟如果你只等了两分钟就着急去找IP很可能系统都还没走到网络配置这一步。我给树莓派5上电之后通常先泡杯咖啡等五分钟再查看。4.2 找到IP之后SSH连接一直被拒绝能ping通说明网络是通的但SSH端口连接不上这种问题比较棘手。先确认目标端口默认OpenSSH监听在22端口用nc -vz 树莓派IP 22测一下端口是否打开。如果不通要么SSH服务没有启动要么防火墙拦掉了。SSH服务没启动的原因大概率是user-data和ssh空文件的预配置没有生效。检查你有没有完整地编辑user-data文件以及是否在system-boot分区里创建了ssh空文件。有一种情况是SD卡已经在树莓派上启动过一次系统后续拔下来再改文件是不会生效的因为cloud-init只在第一次启动时执行解决方案就是重新烧录镜像再做一次预配置。如果端口是通的但是登录时报错Permission denied说明用户名密码有问题。检查user-data文件缩进格式YAML对缩进极其敏感多一个空格都可能导致配置解析失败。复制配置的时候最好使用空格缩进而不是Tab键并确保每一级的缩进一致。4.3 输入密码登录时报错“user ubuntu does not exist”这个报错出现时我心里反而踏实了因为说明cloud-init确实执行了但配置内容没生效。常见原因有三个user-data格式解析失败、用户名拼写不一致、或者系统已经执行过初始化不再读取该文件。检查方法很简单先把树莓派断电拔出SD卡插回电脑打开system-boot分区看user-data文件里users:这一段是不是被正确解析。如果实在不确定在user-data文件末尾加上日志输出比如在write_files:里写入一个标记文件启动后看这个文件是否存在来判断配置是否被执行。其实更省心的方法还是重新烧录镜像这次烧录前在Imager弹窗里把用户和密码设置好每一步都仔细核对基本不会再出岔子。4.4 树莓派5频繁重启或者系统不稳定这个现象通常不是软件问题而是供电不足。树莓派5的峰值功耗明显高于4BUSB接口同时供电给外设时更加吃紧。排查方案是换用官方27W电源适配器并且用质量可靠的USB-C数据线很多充电线看着一样但线芯很细大电流时压降明显导致系统瞬间断电重启。还有一个不常被注意到的点树莓派5的USB接口默认工作模式是USB 2.0如果你想用外接固态硬盘之类的高速设备性能会受限有些教程会让你通过config.txt里的usb_max_current_enable1或者类似参数来提高供电能力。这个对没有外设的纯SD卡安装影响不大但知道有这么回事遇到相关问题排查会快很多。5. 把无头服务器投入使用的几个建议树莓派5一旦通过无外设方式装好Ubuntu后续的维护也基本都可以在远程完成。这里分享几个我实际使用后的建议。第一给自己的树莓派固定一个内网IP。在路由器的DHCP设置里按MAC地址绑定IP防止重启后IP变化导致SSH连接失效。MAC地址可以通过局域网扫描工具查到或者登录系统后用ip link命令确认。固定好IP之后可以在自己电脑的~/.ssh/config里配上别名以后直接输入ssh rpi5就能连进去不用每次敲IP。第二建议用终端复用器跑长任务。树莓派5性能不错你可能想在上面跑一些长时间的任务比如编译程序、跑Python脚本、训练小模型这些任务如果直接挂在SSH会话里万一网络断开任务也会跟着中断。装个tmux或者screen把任务放到独立的会话里执行然后断开SSH任务也能继续跑。第三定期关注系统更新。Ubuntu LTS支持时间很长但前提是你得安装安全更新。配置一个无人值守的自动更新也可以但要小心自动升级内核后可能需要重启才能生效最好设置一个固定的维护窗口手动执行sudo reboot重启一下。6. 写在实际操作之后整套无外设安装流程走通之后你会发现树莓派5比4B时代更加“服务器化”了。从烧录到登录全程不需要外设所有配置都是提前写好的文件这种模式不仅高效而且可复制性极强。以后再做新机器我只需要把SD卡镜像备份一份再改一下用户和网络配置几分钟就能多部署一台。我个人在实际操作中最深的一点体会是无外设安装的关键不在于某一条命令有多神奇而在于理解树莓派的启动流程和cloud-init这套机制。懂了它在什么时候读什么文件、为什么要这么设计遇到任何异常都有排查的思路。这套方法也不只适用于树莓派5同样的原理用在树莓派4B、Zero 2W、各种ARM开发板上基本都通用区别只在配置文件的具体位置和格式上。最后再分享一个小技巧第一次用无头方式装好系统成功登录之后建议立刻做一次镜像备份。把SD卡完整的dd出来存到电脑里版本就叫“ubuntu-24.04-base-clean”以后不管是弄坏了系统还是想重置环境直接把这个镜像写进另一张SD卡再改一下hostname一台新的服务器就绪了。这个习惯让我少重装了很多次系统算是踩过不少坑之后沉淀下来的操作。 
长河君 · 2026/9/7 12:11:41 · 阅读 1.2k 树莓派5无外设安装Ubuntu：从烧录到SSH远程登录的完整指南
在嵌入式开发和单板计算机的日常使用中树莓派5算是我最近折腾得最多的一块板子而“没有外设”这个条件其实比大多数人想象中更常见。可能你的显示器刚好是HDMI只有A口能用可能你手边只有一台笔记本再加一根网线也可能你压根就是想把它做成一个无头服务器丢在弱电箱里。无论哪种情况提前掌握无外设安装Ubuntu的方法都能省下很多来回插拔键鼠和显示器的功夫。这篇内容我会围绕一个核心场景展开不接显示器、不接键盘鼠标仅靠一台普通电脑和一张SD卡把Ubuntu装进树莓派5并顺利进入系统。整个流程会拆到最细包括原理、工具、配置、踩坑适合刚接触树莓派5的初学者也适合想把部署流程标准化的老玩家作为参考。1. 项目整体设计思路解析1.1 为什么要做无外设安装树莓派5和之前的树莓派4B在安装系统这件事上逻辑其实差不多但由于板载接口和电源规格的变化很多人第一次上手时反而更容易被“没有显示器”这个问题卡住。传统的安装方式很直接把镜像写进SD卡插上HDMI显示器、USB键鼠上电然后在图形界面里一步步点完初始设置。这个方式在有一整套外设的环境里当然没问题但遇到几种实际场景就比较尴尬。第一现在的笔记本和轻薄本基本没有HDMI输入口只有输出口你想让笔记本当树莓派的显示器也行不通除非额外买采集卡。第二树莓派5对HDMI线缆和显示器的兼容性偶尔会闹脾气我遇到过同一根线在4B上完全正常换到5上就黑屏的情况排查起来非常浪费时间。第三如果你要做多台设备的批量部署比如一口气配置五台树莓派5做集群每台都去接显示器输一遍账号密码那效率实在太低了。所以无外设安装的核心思路就是把“首次启动后的交互式配置”提前到镜像写入阶段完成。说白了我们在给SD卡写系统的同时顺便把用户、密码、网络这些信息也写进去让树莓派5上电之后自己就能完成配置、连上网络、开启SSH整个过程不需要任何外设介入。这个思路在现代Linux发行版里已经很成熟树莓派官方系统和Ubuntu都提供了相应的预配置机制。1.2 为什么选树莓派5加Ubuntu这个组合树莓派5是目前树莓派家族里性能最强的型号搭载了博通BCM2712四核Cortex-A76处理器主频最高能到2.4GHz内存有4GB和8GB可选我在实际测试中跑编译任务比4B快了一半不止。性能上来之后它能干的事情就多了Ubuntu这样完整的Linux发行版跑起来才真正“不憋屈”。树莓派官方系统Raspberry Pi OS是基于Debian的日常用没什么问题但如果你要跑Docker容器、Kubernetes、或者想跟服务器环境保持一致Ubuntu的优势就很明显。Ubuntu Server是纯命令行版本没有图形桌面内存占用低而且针对树莓派硬件做了专门的优化内核、固件都跟进得比较勤。Canonical官方提供树莓派5的Ubuntu 24.04 LTS镜像这意味着你能拿到长期支持安全更新和bug修复持续到2029年这对服务器用途来说非常重要。还有一个关键点是生态兼容性。很多开源项目、教程、云镜像、自动化脚本都是围绕Ubuntu写的用Ubuntu可以少踩很多“发行版差异”的坑。比如你照着网上的教程装Docker、配置Nginx、部署K3sUbuntu下的命令和包管理方式跟你云服务器上完全一致学一次到处能用。树莓派5的硬件性能和Ubuntu的软件生态结合起来就是一台功耗极低、噪音为零、能长期稳定运行的迷你服务器。2. 核心原理与安装前准备2.1 准备好这些装备再开工正式开始之前先把手头的东西清点一遍。首先是一张SD卡树莓派5支持SD卡启动推荐至少32GB起步U3或者A2级别的卡读写速度更快系统启动和软件安装体验会好很多。我日常用的是64GB的闪迪至尊极速烧录Ubuntu Server镜像后剩余空间还能存不少Docker镜像和日志数据。其次是一台用于烧录系统的电脑。这台电脑用什么系统都行Windows、macOS、Linux都可以关键是装好烧录工具。我后面使用的树莓派官方烧录工具Raspberry Pi Imager是跨平台的而且自带了预配置功能非常省事。然后是网络环境。从树莓派5上电到它自动连上Wi-Fi或网线中间不需要你做任何操作但前提是你的网络环境有一个DHCP服务器几乎所有的家用路由器都是能让树莓派拿到IP地址。同时你的电脑和树莓派需要在同一个局域网内这样SSH才能连通。如果条件允许优先用网线直连路由器比Wi-Fi稳定、速度快、排查问题简单。我最早调试的时候也尝试过Wi-Fi方式后来发现网络配置稍微有点问题连不上又看不到界面排查起来远不如网线直观。所以我的建议是首次安装老老实实用网线系统跑起来之后再配置Wi-Fi。2.2 树莓派5的启动流程与eeprom机制理解了启动流程很多配置上的“为什么”就自然解开了。树莓派5内置了一块SPI闪存存放着EEPROM固件作用类似于PC的BIOS。板子上电后首先是这个固件初始化内存和电源管理然后根据启动模式配置去查找启动设备。树莓派5默认支持SD卡和USB启动首次使用的时候把系统烧到SD卡里插上卡就能引导。EEPROM里还存有一份被称为bootcode的配置控制着启动时的行为包括是否检查显示器、是否等待键盘输入、甚至能不能通过USB直接启动。对于无外设安装来说一个很关键的细节是树莓派在检测不到显示器的情况下会自动启用无头模式也就是不尝试输出画面、不等待用户操作直接进入系统启动流程。这个行为是内置的不需要额外配置所以我们才能实现“上电即启动”。Ubuntu在树莓派5上的启动还会额外用到U-Boot引导器它位于SD卡的启动分区中树莓派的EEPROM加载U-BootU-Boot再加载Ubuntu的内核和initramfs最终挂载根文件系统完成启动。如果你以后需要换内核、调整启动参数修改的是U-Boot的配置文件config.txt和cmdline.txt这两个文件都在启动分区里直接在电脑上编辑SD卡里的文件就行。2.3 Ubuntu版本选择为什么首推24.04 LTS树莓派5刚发布的时候Ubuntu支持的版本是23.10属于短期版本生命周期只有九个月。这个版本我当时试用过能用但很多优化还没跟上。到了2024年发布的Ubuntu 24.04 LTS也就是Noble Numbat对树莓派5的支持已经非常成熟无论是Wi-Fi驱动、GPU驱动还是电源管理都做得比较到位。所以新手首推Ubuntu Server 24.04 LTS原因有三个。第一LTS版本支持时间有五年适合搭建长期运行的服务不用每隔几个月就考虑升级。第二社区用户基数大你遇到任何问题网上几乎都能搜到别人已经解决过的方案这个对新手来说太重要了。第三针对树莓派5的硬件支持已经补齐了蓝牙、Wi-Fi、RTC时钟、NVMe SSD这些功能都能正常用。如果你一定要图形桌面也可以选择Ubuntu Desktop 24.04 LTS但说实话在树莓派5上跑完整桌面体验还达不到主力机的水平而且消耗大量内存。无头安装场景通常是做服务器所以我的建议是直接用Ubuntu Server轻量干净想要桌面的时候后面再装个轻量级桌面环境也不是不行。3. 无外设安装Ubuntu实操全流程3.1 用Raspberry Pi Imager烧录Ubuntu镜像工具我推荐直接用Raspberry Pi Imager它是树莓派官方出的界面简单功能却很够用。下载安装后打开主界面会让你选择三样东西树莓派设备型号、操作系统、存储卡。操作系统这里不建议手动下载ISO然后选择自定义镜像因为Imager内置的操作系统列表里已经收录了Ubuntu Server 24.04 LTS的官方镜像选起来很省事。具体路径是选择设备Raspberry Pi 5然后进入Other general-purpose OS找到Ubuntu里面会列出多个版本服务器版选Ubuntu Server 24.04 LTS桌面版选Ubuntu Desktop 24.04 LTS。选好之后插上SD卡选择对应的磁盘点击写入就可以。写卡的时间取决于SD卡速度和镜像大小一般三到五分钟。写入完成后Imager会校验一遍数据确认无误后提示完成。这个时候不要急着拔卡我们还有一步关键的初始化配置要做。在Imager点击写入按钮之前它通常会弹出一个“编辑设置”的选项允许你设置主机名、启用SSH、配置Wi-Fi、预设用户名密码。如果你直接跳过了这个设置也可以在烧录完成后手动修改SD卡里的文件我们接着往下看。3.2 关键的预配置用户账户与SSH开启烧录完Ubuntu镜像后SD卡会被分成两个分区Windows下能看到一个名为system-boot的FAT分区另一个是ext4格式的根文件系统分区Windows会提示无法访问这很正常不用管它。所有预配置操作都在system-boot分区里完成。在system-boot分区里有一个名叫user-data的文件这是cloud-init的配置文件。cloud-init是Ubuntu在云环境和嵌入式设备上自动完成初始化的工具它会在系统第一次启动时读取这个文件并执行里面的指令。我们需要做的就是编辑这个文件告诉cloud-init创建一个属于我们的用户、设置密码、并且允许SSH登录。用文本编辑器打开user-data文件往下翻在users:这一段默认是注释状态。把它改成类似下面这样users: - name: ubuntu sudo: ALL(ALL) NOPASSWD:ALL groups: users, admin shell: /bin/bash lock_passwd: false plain_text_passwd: yourpassword ssh_authorized_keys: - ssh-ed25519 AAAAC3... your-key-comment这里我做了几件事。name是用户名你想叫什么都行sudo给了免密sudo权限方便首次登录后立即执行管理命令plain_text_passwd是明文密码系统首次启动后就会用这个密码初始化账户ssh_authorized_keys是可选的如果你手头有自己的SSH公钥加进去之后就能直接免密登录安全性比密码登录高一个档次。如果没有公钥留空也没关系后面我们可以用密码登录后再补。改完user-data文件保存再确认一个问题system-boot分区里有没有一个叫ssh或者ssh.txt的空文件有些Ubuntu镜像默认没有开启SSH服务如果没有这个文件就在system-boot目录下新建一个空的ssh文件这样系统第一次启动时就会自动启用OpenSSH服务。如果镜像本身预配了SSH这一步可以跳过但为了保险起见动手创建一个空文件并不会有什么副作用。3.3 配置网络Wi-Fi与有线两种方式树莓派5有Wi-Fi模块所以理论上你完全能做到无网线、只靠无线网络就能远程连接。系统启动时读取的无线网络配置也是放在system-boot分区里文件名叫做network-config这是Ubuntu的Netplan配置文件。如果你打算用网线连接那这一步基本可以跳过。树莓派插上网线路由器DHCP自动分配IP系统启动后自动获取地址什么都不用配。但如果想用Wi-Fi必须提前在network-config里写好Wi-Fi信息。打开文件后找到wifis:这一段把注释去掉改成wifis: wlan0: dhcp4: true optional: true access-points: 你的WiFi名称: password: 你的WiFi密码注意几点wlan0是树莓派5的无线网卡接口名不要改Wi-Fi名称和密码用英文双引号包起来密码至少8位不支持旧版的WEP加密方式用WPA2/WPA3都行dhcp4: true表示通过DHCP自动获取IP地址。如果你的Wi-Fi网络隐藏了SSID可以额外加一行hidden: true否则它可能扫描不到。还有一个细节是区域的设置。树莓派的无线模块有一个国家/地区码限制如果地区码没有设置Wi-Fi可能不会正常工作。在system-boot分区里找到config.txt文件在末尾检查是否有country这一项如果没有就加上countryCN我这里用CN举例具体根据你所在地区填写即可。设置正确之后重启即可生效。如果之前已经启动过系统也可以在登录系统后运行sudo raspi-config这个命令是树莓派固件包自带的进入本地化选项里把Wi-Fi Country选对。3.4 上电启动用SSH与树莓派5第一次亲密接触预配置完成之后安全弹出SD卡插入树莓派5接上网线或者等待Wi-Fi连接最后插上USB-C电源线开机。树莓派5建议使用官方27W电源适配器它能提供5V/5A的输出如果用一个普通的手机充电器遇到高负载场景电压跌落会出现性能下降甚至重启的问题这个坑我一开始就踩过后来换了电源就再没犯过。给树莓派五分钟左右的时间完成首次启动。首次启动要做的事情很多扩展根分区、应用cloud-init配置、启用SSH服务、生成SSH主机密钥整个过程比后续正常启动要慢一些。然后到你的路由器管理界面里看DHCP客户端列表找一个新出现的设备它可能就是你的树莓派。主机名默认是ubuntu所以在这张列表里通常也会显示为ubuntu。如果你手头的网络环境无法登录路由器也可以用网段扫描的方式找电脑上执行一下ARP扫描或者用手机App扫描局域网设备一般都能发现。比如自己电脑的IP是192.168.1.100那树莓派多半就在192.168.1.1到192.168.1.255这一段里。Linux或者macOS的电脑可以直接跑nmap -sn 192.168.1.0/24Windows上用Advanced IP Scanner也挺方便。找到IP地址之后打开终端执行SSH连接命令ssh ubuntu192.168.1.xxx这里的ubuntu是你在user-data里设置的用户名如果忘了设置Ubuntu Server 24.04的默认用户是ubuntu默认密码也是ubuntu但首次登录会强制要求你修改密码。连接成功后系统会提示确认主机指纹输入yes回车然后输入密码看到类似下面这样的输出就说明成功了Welcome to Ubuntu 24.04 LTS (GNU/Linux 6.8.0-xxxx-raspi aarch64) * Documentation: https://help.ubuntu.com * Management: https://landscape.canonical.com * Support: https://ubuntu.com/pro Last login: ...注意看aarch64这个字段它代表的是64位ARM架构说明你的内核和发行版是64位的能充分利用树莓派5的性能。登录进去之后我建议先做几件事。第一sudo apt update sudo apt upgrade把系统里的软件包更新到最新版本这个过程可能持续几分钟取决于网络速度。第二hostnamectl查看一下系统信息确认版本号、内核版本、硬件架构都正确。第三如果你想要静态IP地址可以编辑Netplan配置文件为后续提供服务做准备。第四如果打算长期使用建议立刻配置SSH密钥登录然后关闭密码登录这样远程连接既方便又安全。3.5 初始化系统的基本设置第一次进入可用的系统之后还远远没到收工的时候。一个干干净净的Ubuntu系统想要顺手用起来还需要做一轮初始化设置。首先是更新软件源。默认源地址是Canonical官方服务器国内访问速度因网络环境而异如果你在内地使用建议换到合适的镜像源具体操作是编辑/etc/apt/sources.list.d/ubuntu.sources文件把URL替换成可用的镜像地址然后sudo apt update。换完源再安装软件速度差别非常明显。其次是设置主机名。默认主机名实在缺乏辨识度如果同时跑好几台机器很容易搞混。改主机名的命令是sudo hostnamectl set-hostname rpi5-server改完重新登录终端就能看到新名字生效。然后是时区设置。服务器时间不对会带来很多莫名其妙的问题最简单粗暴的方法是sudo timedatectl set-timezone Asia/Shanghai把时区设到你所在的区域再用date命令确认一下时间是否正确。最后是安装一些基础工具。我每次装完系统都会顺手装上这些包git curl wget htop neofetch ufwGit和curl是开发刚需htop用来查看系统资源占用neofetch可以快速查看系统信息ufw是防火墙。防火墙建议开启只放行必要端口尤其是服务器暴露在公网环境时这一步不能偷懒sudo ufw allow OpenSSH sudo ufw enable这样仅打开SSH端口其余端口默认拒绝外部访问能挡住不少扫描和探测。4. 常见问题与排查技巧实录4.1 路由器里找不到树莓派的IP地址这是无外设安装失败率最高的一个环节。插上电源之后等了好几分钟路由器后台设备列表里死活找不到新设备。遇到这种情况我的排查顺序是固定的。先看电源指示灯。树莓派5上的红灯亮起只代表供电正常但系统有没有起来还得看绿灯的活动状态。如果绿灯常亮不闪大概率是系统没引导成功SD卡有问题或者没插好。如果绿灯有规律地闪烁说明系统卡在启动过程中需要接上显示器看具体日志。再看网络连接。如果是网线连接路由器对应的LAN口指示灯是否亮起网线两端的插头是否牢固。如果用的是Wi-Fi排查就要麻烦一点network-config里最常见的问题是密码写错或者加密方式不对。还有一个小坑是Wi-Fi的名称里如果包含中文或者特殊字符Netplan配置文件解析时可能会出错建议改成纯英文的SSID测试。最后确认是不是首次启动还没完成。Ubuntu Server首次启动时要展开分区、生成SSH密钥、执行cloud-init这个时间在树莓派5上大概三到五分钟如果你只等了两分钟就着急去找IP很可能系统都还没走到网络配置这一步。我给树莓派5上电之后通常先泡杯咖啡等五分钟再查看。4.2 找到IP之后SSH连接一直被拒绝能ping通说明网络是通的但SSH端口连接不上这种问题比较棘手。先确认目标端口默认OpenSSH监听在22端口用nc -vz 树莓派IP 22测一下端口是否打开。如果不通要么SSH服务没有启动要么防火墙拦掉了。SSH服务没启动的原因大概率是user-data和ssh空文件的预配置没有生效。检查你有没有完整地编辑user-data文件以及是否在system-boot分区里创建了ssh空文件。有一种情况是SD卡已经在树莓派上启动过一次系统后续拔下来再改文件是不会生效的因为cloud-init只在第一次启动时执行解决方案就是重新烧录镜像再做一次预配置。如果端口是通的但是登录时报错Permission denied说明用户名密码有问题。检查user-data文件缩进格式YAML对缩进极其敏感多一个空格都可能导致配置解析失败。复制配置的时候最好使用空格缩进而不是Tab键并确保每一级的缩进一致。4.3 输入密码登录时报错“user ubuntu does not exist”这个报错出现时我心里反而踏实了因为说明cloud-init确实执行了但配置内容没生效。常见原因有三个user-data格式解析失败、用户名拼写不一致、或者系统已经执行过初始化不再读取该文件。检查方法很简单先把树莓派断电拔出SD卡插回电脑打开system-boot分区看user-data文件里users:这一段是不是被正确解析。如果实在不确定在user-data文件末尾加上日志输出比如在write_files:里写入一个标记文件启动后看这个文件是否存在来判断配置是否被执行。其实更省心的方法还是重新烧录镜像这次烧录前在Imager弹窗里把用户和密码设置好每一步都仔细核对基本不会再出岔子。4.4 树莓派5频繁重启或者系统不稳定这个现象通常不是软件问题而是供电不足。树莓派5的峰值功耗明显高于4BUSB接口同时供电给外设时更加吃紧。排查方案是换用官方27W电源适配器并且用质量可靠的USB-C数据线很多充电线看着一样但线芯很细大电流时压降明显导致系统瞬间断电重启。还有一个不常被注意到的点树莓派5的USB接口默认工作模式是USB 2.0如果你想用外接固态硬盘之类的高速设备性能会受限有些教程会让你通过config.txt里的usb_max_current_enable1或者类似参数来提高供电能力。这个对没有外设的纯SD卡安装影响不大但知道有这么回事遇到相关问题排查会快很多。5. 把无头服务器投入使用的几个建议树莓派5一旦通过无外设方式装好Ubuntu后续的维护也基本都可以在远程完成。这里分享几个我实际使用后的建议。第一给自己的树莓派固定一个内网IP。在路由器的DHCP设置里按MAC地址绑定IP防止重启后IP变化导致SSH连接失效。MAC地址可以通过局域网扫描工具查到或者登录系统后用ip link命令确认。固定好IP之后可以在自己电脑的~/.ssh/config里配上别名以后直接输入ssh rpi5就能连进去不用每次敲IP。第二建议用终端复用器跑长任务。树莓派5性能不错你可能想在上面跑一些长时间的任务比如编译程序、跑Python脚本、训练小模型这些任务如果直接挂在SSH会话里万一网络断开任务也会跟着中断。装个tmux或者screen把任务放到独立的会话里执行然后断开SSH任务也能继续跑。第三定期关注系统更新。Ubuntu LTS支持时间很长但前提是你得安装安全更新。配置一个无人值守的自动更新也可以但要小心自动升级内核后可能需要重启才能生效最好设置一个固定的维护窗口手动执行sudo reboot重启一下。6. 写在实际操作之后整套无外设安装流程走通之后你会发现树莓派5比4B时代更加“服务器化”了。从烧录到登录全程不需要外设所有配置都是提前写好的文件这种模式不仅高效而且可复制性极强。以后再做新机器我只需要把SD卡镜像备份一份再改一下用户和网络配置几分钟就能多部署一台。我个人在实际操作中最深的一点体会是无外设安装的关键不在于某一条命令有多神奇而在于理解树莓派的启动流程和cloud-init这套机制。懂了它在什么时候读什么文件、为什么要这么设计遇到任何异常都有排查的思路。这套方法也不只适用于树莓派5同样的原理用在树莓派4B、Zero 2W、各种ARM开发板上基本都通用区别只在配置文件的具体位置和格式上。最后再分享一个小技巧第一次用无头方式装好系统成功登录之后建议立刻做一次镜像备份。把SD卡完整的dd出来存到电脑里版本就叫“ubuntu-24.04-base-clean”以后不管是弄坏了系统还是想重置环境直接把这个镜像写进另一张SD卡再改一下hostname一台新的服务器就绪了。这个习惯让我少重装了很多次系统算是踩过不少坑之后沉淀下来的操作。