1. 项目概述从零启动你的树莓派Ubuntu系统如果你刚拿到一块树莓派想摆脱官方的Raspberry Pi OS体验更纯粹的Linux环境或者需要为特定项目部署一个服务器级的操作系统那么给树莓派烧录Ubuntu镜像是个非常棒的选择。Ubuntu Server以其稳定、资源占用相对合理和庞大的软件生态在树莓派社区里一直很受欢迎。但和直接在x86电脑上安装不同给树莓派这个ARM架构的“小电脑”装系统第一步“烧录镜像”就卡住了不少人更别提烧录成功后那块没有显示器、键盘鼠标的“黑盒子”该怎么连上去操作了。我自己在折腾树莓派集群、家庭服务器或者IoT网关时无数次重复这个过程。核心就两步一是把Ubuntu镜像正确地“刻”进SD卡二是通过串口或SSH这两种“无头”Headless方式首次登录系统并进行配置。听起来简单但每一步都有细节比如镜像选哪个版本、烧录工具怎么用、串口线怎么接、SSH怎么在第一次开机就启用。这篇文章我就以一个老玩家的视角带你完整走一遍这个流程把那些教程里不提的“坑”和“技巧”都摊开来讲明白让你拿到一块装好Ubuntu的树莓派后能稳稳当当地用命令行控制它。2. 核心准备镜像、工具与硬件连接工欲善其事必先利其器。在开始烧录之前把该准备的东西都备齐能避免过程中来回折腾。2.1 镜像选择与下载并非越新越好首先你得决定给树莓派装哪个Ubuntu。直接去Ubuntu官网找树莓派版本是个好起点但选择有讲究。官方推荐与长期支持版对于树莓派4B、5或CM4这类性能较好的型号Ubuntu官方提供了优化的服务器版镜像。我强烈建议新手选择带有LTS标记的版本比如 Ubuntu 22.04 LTS 或 24.04 LTS。LTS代表长期支持通常有5年的安全更新非常稳定适合作为服务器长期运行。相比之下非LTS的临时版本只有9个月支持周期可能遇到更多的驱动兼容性问题。镜像类型辨析下载时你会看到几种镜像Ubuntu Server这是我们的首选。没有图形桌面纯命令行界面资源占用极低所有计算能力都用于运行你的服务。Ubuntu Desktop带图形界面的版本。除非你确定要在树莓派上接显示器使用否则不推荐。图形界面会占用大量内存和CPU让树莓派变得卡顿失去了作为轻量级服务器的优势。预装云镜像这是一种特殊的镜像首次启动时必须通过网络提供配置信息。对于高级用户部署大量树莓派有用但个人单机使用非常不友好请避免。注意务必从Ubuntu官方网站或可信的镜像站下载。我曾见过有人从第三方网盘下载了被修改过的镜像内含挖矿程序树莓派一开机就满负荷运行排查了半天。下载实操以树莓派4B和Ubuntu 22.04 LTS Server为例你可以访问 releases.ubuntu.com 找到对应版本。文件是一个.xz压缩包里面是.img镜像文件。记下它的存放路径比如~/Downloads/ubuntu-22.04.3-preinstalled-server-arm64raspi.img.xz。2.2 烧录工具选型BalenaEtcher 一骑绝尘把.img文件写入SD卡Windows上用过多年的Win32 Disk ImagermacOS和Linux上用dd命令。但现在我几乎只用BalenaEtcher。它跨平台、界面极其简单、有写入验证、而且能自动识别并解压.xz或.gz格式的镜像几乎杜绝了因操作失误覆盖错硬盘的风险。为什么不用dd命令了dd命令功能强大但也是著名的“磁盘销毁者”命令参数写错一个字母比如把of/dev/sdb写成of/dev/sda就可能清空你的系统硬盘。BalenaEtcher 的图形化界面大大降低了这个风险它通常只会列出可移动存储设备如你的SD卡读卡器避开了内部硬盘。安装BalenaEtcher去其官网下载对应操作系统的安装包即可。它是一个“便携式”应用安装过程很简单。2.3 硬件连接准备串口与网络的备选方案烧录完系统我们要连接树莓派。这里有两个核心方法串口最可靠和SSH最常用。你需要根据情况准备。串口连接套件这是调试和首次启动的“救命稻草”。当树莓派无法通过网络访问时串口是唯一能看见系统启动信息的通道。你需要USB转TTL串口模块推荐使用CH340或CP2102芯片的模块价格便宜驱动完善。PL2303芯片的模块在最新系统上驱动可能有问题尽量避开。杜邦线需要三根母对母TX发送、RX接收、GND地线。串口调试软件Windows上可以用Putty、MobaXterm或国产的SecureCRTmacOS/Linux 自带screen或minicom命令也可以用更现代的picocom。网络与SSH连接准备这是日常操作的主要方式。你需要确保树莓派和你的电脑在同一个局域网内。对于树莓派4B/5直接用网线连接路由器最简单。如果你想用Wi-Fi则需要在烧录镜像后、首次启动前在SD卡的system-boot分区里预先配置好Wi-Fi和SSH。这是个小技巧后面会详细说。3. 镜像烧录全流程详解准备好所有材料后我们开始最关键的一步烧录。3.1 使用BalenaEtcher进行烧录这个过程几乎是“下一步”到底但有几个细节点需要注意。插入SD卡与启动Etcher将你的Micro SD卡通过读卡器插入电脑。打开BalenaEtcher。选择镜像点击 “Flash from file”选择你下载的.xz压缩包。Etcher会自动识别并准备解压。选择目标磁盘点击 “Select target”。这里务必看仔细Etcher会列出所有可移动设备。确认你的SD卡容量和型号不要选成电脑的U盘或移动硬盘。一个技巧是在插入SD卡前后观察列表变化新增的那个就是它。开始烧录点击 “Flash!”。Etcher会依次执行三个步骤解压镜像、写入数据、校验数据。校验非常重要它能确保写入过程没有出错避免SD卡本身有坏块导致系统启动异常。烧录完成当看到 “Flash Complete!” 提示并且校验通过后就可以安全地弹出SD卡了。Windows可能会弹窗提示“需要格式化”绝对不要点格式化直接关掉窗口或弹出设备即可。实操心得SD卡质量强烈建议使用Class 10或UHS-I及以上速度的知名品牌SD卡如SanDisk Extreme, Samsung EVO。劣质卡会导致系统运行缓慢、甚至频繁损坏数据。树莓派对SD卡的读写很频繁一块好卡是稳定性的基础。烧录失败处理如果烧录失败或校验出错首先尝试换一个USB口最好是主板原生的USB 3.0口或者换一个读卡器。如果多次失败可能是SD卡有物理损坏考虑更换一张。3.2 首次启动前的关键配置配置Wi-Fi和SSH烧录好的SD卡在首次插入树莓派启动前我们有机会进行一些“无头启动”的关键配置。在电脑上重新插入SD卡你会看到两个分区system-boot(或boot)这是一个FAT32格式的小分区树莓派的启动引导文件在这里。writable这是主要的系统分区首次启动后才会被挂载和扩展。我们需要在system-boot分区里动点手脚。启用SSH这是为了后续能用SSH连接。在system-boot分区根目录下创建一个空的文件命名为ssh注意没有后缀名。当树莓派首次启动时检测到这个文件就会自动启用SSH服务。配置Wi-Fi可选如果你不想接网线需要预先配置Wi-Fi。在system-boot分区根目录下创建另一个文件命名为user-data。这是一个 cloud-init 配置文件。你需要用文本编辑器如VS Code、Notepad编辑它内容模板如下#cloud-config version: 2 network: ethernets: eth0: dhcp4: true optional: true wifis: wlan0: dhcp4: true optional: true access-points: 你的Wi-Fi名称: password: 你的Wi-Fi密码将你的Wi-Fi名称和你的Wi-Fi密码替换成实际信息。注意Wi-Fi名称如果包含空格或特殊字符最好用双引号括起来。保存文件后树莓派首次启动时会读取这个配置并自动连接Wi-Fi。重要提示user-data文件对格式尤其是缩进非常敏感必须使用空格缩进不要用Tab键。建议复制上面的模板进行修改。配置完成后安全弹出SD卡。4. 连接树莓派串口与SSH双通道实战现在将配置好的SD卡插入树莓派接通电源。我们分别通过串口和SSH两种方式连接它。4.1 串口连接最底层的调试通道串口连接能让你看到从通电第一刻开始的全部启动日志是排查启动失败问题的终极手段。硬件连接将USB转TTL模块插入电脑。用杜邦线连接模块和树莓派的GPIO引脚模块的GND-树莓派的GND如Pin 6。模块的RX-树莓派的TX(GPIO 14, Pin 8)。模块的TX-树莓派的RX(GPIO 15, Pin 10)。切记RX接TXTX接RX交叉连接GND对GND直连。软件配置与登录在电脑上打开设备管理器Windows或ls /dev/tty*命令macOS/Linux查看串口模块分配的端口号比如COM3(Windows) 或/dev/ttyUSB0(Linux/macOS)。打开串口终端软件以Putty为例Connection type: SerialSerial line: 填入你的端口号 (如COM3)Speed:115200树莓派默认串口波特率点击Open。然后给树莓派上电。如果一切正常终端窗口会开始滚动显示Linux内核的启动信息。启动完成后会提示你登录。默认的用户名和密码都是ubuntu。系统会强制要求你第一次登录时修改密码。按照提示输入当前密码 (ubuntu)然后设置一个强健的新密码。串口连接的核心价值如果树莓派无法从SD卡启动比如卡在彩虹屏或黑屏串口终端里往往会打印出错误原因例如“文件系统损坏”、“内核panic”等这是网络连接无法提供的诊断信息。4.2 SSH连接日常操作的主力方式如果串口连接成功并且你预先配置了网络网线或Wi-Fi那么就可以使用更便捷的SSH了。查找树莓派的IP地址 树莓派启动后会自动通过DHCP获取一个IP地址。你需要找到它。有几种方法路由器后台查看登录你家路由器的管理界面通常是192.168.1.1或192.168.31.1在“已连接设备”或“DHCP客户端列表”里查找主机名包含“ubuntu”或“raspberrypi”的设备。通过网络扫描在电脑上使用arp -a命令查看本地ARP缓存或者使用扫描工具如nmap(nmap -sn 192.168.1.0/24)。通过串口查看如果你已经通过串口登录直接在树莓派上运行ip a命令查看eth0有线或wlan0无线的inet地址。SSH登录打开你熟悉的终端Windows可用PowerShell、Git Bash或WSLmacOS/Linux直接用系统终端。输入命令ssh ubuntu树莓派的IP地址。例如ssh ubuntu192.168.1.100。首次连接时会提示“The authenticity of host ... cant be established.”这是正常的SSH安全警告输入yes继续。输入密码你之前通过串口修改后的新密码。登录成功你现在已经远程控制你的树莓派Ubuntu系统了。SSH连接优化使用密钥认证为了安全和免密码登录建议配置SSH密钥。在你的电脑上生成密钥对ssh-keygen -t ed25519然后将公钥~/.ssh/id_ed25519.pub的内容追加到树莓派上的~/.ssh/authorized_keys文件中。之后登录就不再需要输入密码。使用SSH Config简化正如热词里提到的你可以在~/.ssh/config文件里为树莓派创建一个别名。Host pi-ubuntu HostName 192.168.1.100 User ubuntu IdentityFile ~/.ssh/id_ed25519保存后以后只需要输入ssh pi-ubuntu即可连接无需再记IP和用户名。5. 登录后的首要配置与系统优化成功登录后先别急着部署应用。进行一些基础配置能让后续使用更顺畅。5.1 系统更新与基础安全设置首先更新软件包列表并升级所有已安装的包。这能确保系统拥有最新的安全补丁。sudo apt update sudo apt upgrade -y升级过程可能会持续几分钟取决于网络速度。接着修改主机名方便在网络中识别sudo hostnamectl set-hostname my-raspberry-pi # 将 my-raspberry-pi 换成你喜欢的名字修改后需要重新登录才能生效。强烈建议更改默认用户Ubuntu为树莓派镜像预设的用户就是ubuntu这众所周知。为了提高安全性最好创建一个新的个人用户并赋予其sudo权限然后删除默认的ubuntu用户。# 添加新用户如 piadmin sudo adduser piadmin # 将新用户加入sudo组 sudo usermod -aG sudo piadmin # 切换到新用户测试sudo权限 su - piadmin sudo whoami # 应该返回 root # 确认新用户可用后登出用新用户SSH登录。 # 最后删除默认用户 (谨慎操作确保新用户已正常工作) # sudo deluser --remove-home ubuntu5.2 存储空间扩展与交换空间调整烧录的镜像通常只占用SD卡的一部分空间。我们需要将其扩展到整个SD卡。sudo raspi-config在出现的文本配置界面中选择Advanced Options-Expand Filesystem。执行后重启 (sudo reboot)。重启后使用df -h命令查看根分区/的大小应该已经变成了SD卡的完整容量。对于树莓派4B 2GB/4GB内存的版本默认的交换空间可能较小。你可以调整交换文件的大小或直接使用zram这个压缩内存交换工具它对SD卡更友好。# 禁用传统交换分区如果有 sudo dphys-swapfile swapoff sudo dphys-swapfile uninstall sudo systemctl disable dphys-swapfile # 安装zram-tools sudo apt install zram-tools -y安装后zram会自动启用将一部分内存作为压缩后的交换空间速度远快于SD卡交换。5.3 常用工具安装与开发环境准备根据你的用途安装一些必备工具。基础工具vim(编辑器),htop(进程监控),git,curl,wget。sudo apt install vim htop git curl wget -yPython环境Ubuntu Server通常预装了Python 3。你可以用pip安装包。sudo apt install python3-pip python3-venv -yDocker如果你想用容器部署服务可以安装Docker。curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER # 将当前用户加入docker组免sudo运行docker记得登出再登录用户组更改生效。6. 常见问题排查与技巧实录即使按照步骤操作也可能会遇到问题。这里记录几个我踩过的坑和解决方法。6.1 启动类问题问题1上电后只有红灯常亮绿灯不闪或微闪串口无输出。可能原因SD卡接触不良、镜像烧录失败、电源功率不足。排查重新拔插SD卡确保完全插入卡槽。换一张SD卡用BalenaEtcher重新烧录一次并确保校验通过。检查电源。树莓派4B/5需要5V/3A以上的优质电源劣质电源或电脑USB口供电可能导致启动失败。使用官方电源或知名品牌的足功率电源。问题2串口有输出但卡在某个内核启动阶段例如“Failed to start ... mount /boot”。可能原因system-boot分区文件损坏或config.txt等引导配置错误。排查将SD卡插回电脑检查system-boot分区下的文件是否完整。可以尝试从官网重新下载镜像再次烧录。检查system-boot分区下的config.txt文件。如果是树莓派4确保没有错误地启用了仅适用于旧型号的参数。如果不确定可以备份后用一个全新的镜像文件覆盖system-boot分区注意不是整个SD卡。6.2 网络与SSH连接问题问题3无法通过SSH连接提示“Connection refused”或“Connection timed out”。可能原因SSH服务未启动、防火墙阻止、IP地址不对、Wi-Fi未连接。排查确认IP通过路由器后台或串口ip a命令再次确认树莓派的IP地址是否正确。检查SSH服务通过串口登录运行sudo systemctl status ssh查看SSH服务是否处于active (running)状态。如果不是使用sudo systemctl start ssh启动它并用sudo systemctl enable ssh设置开机自启。检查防火墙Ubuntu默认可能安装了ufw防火墙。通过串口运行sudo ufw status。如果状态是active并且没有放行22端口需要添加规则sudo ufw allow ssh或sudo ufw allow 22。检查Wi-Fi通过串口运行sudo nmcli device status查看wlan0是否已连接。或者运行iwconfig wlan0查看连接状态。如果未连接检查user-data文件中的Wi-Fi配置是否有误。问题4SSH连接缓慢登录后卡顿好几秒。可能原因SSH服务端在尝试反向解析客户端的IP地址。解决在树莓派上编辑SSH服务端配置sudo vim /etc/ssh/sshd_config找到#UseDNS yes这一行将其改为UseDNS no。然后重启SSH服务sudo systemctl restart ssh。6.3 系统与性能问题问题5系统运行一段时间后异常卡顿SD卡指示灯常亮。可能原因SD卡读写频繁尤其是交换分区、SD卡质量差、某个进程占用大量IO。排查与解决使用htop命令查看CPU和内存占用。如果内存用尽系统会频繁使用交换空间导致卡顿。这就是为什么前面推荐使用zram替代传统交换文件。使用iotop命令需安装sudo apt install iotop查看实时磁盘IO找出是哪个进程在疯狂读写。根本解决对于需要频繁读写的服务如数据库强烈建议使用USB 3.0接口的外接SSD或高速U盘作为数据盘甚至将系统迁移到外接SSD上这能极大提升树莓派的IO性能和SD卡寿命。问题6如何修改软件源为国内镜像加速下载国内访问Ubuntu官方源可能较慢。可以替换为阿里云、清华、中科大的镜像源。备份原列表sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak编辑源列表sudo vim /etc/apt/sources.list将文件内容替换为阿里云镜像源以Ubuntu 22.04为例deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb-src https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse更新缓存sudo apt update给树莓派烧录Ubuntu并成功连接只是万里长征的第一步但却是最坚实的一步。掌握了串口和SSH这两把钥匙你就拥有了在任何无屏幕环境下操控这台微型服务器的能力。后续无论是搭建个人网站、部署智能家居中枢、还是作为学习Linux和网络服务的实验平台都可以在这个干净、稳定的Ubuntu基础上自由发挥。最关键的是遇到启动或网络问题时不要慌拿出串口模块看看系统到底在启动时说了什么绝大多数问题都能在启动日志里找到线索。