企业官网建设流程全解析

树莓派拿到手的第一件事，永远是把系统装进去。这件事听起来简单——下载镜像、写卡、插电、开机——但真正动手过的人都知道，从选哪个系统版本、用哪个烧录工具，到第一次开机连不上网、SSH 死活登不进去，每一步都藏着让人抓狂的小坑。我前后经手过十几块树莓派，从早期的 3B 到现在的 5，每次装系统都会遇到点新情况，也慢慢总结出一套相对稳妥的流程。这篇内容就把整个系统安装过程拆开讲透，从镜像选型、烧录工具对比、无屏幕配置，到首次启动后的基础设置和常见故障排查，尽量让第一次接触树莓派的人也能一次点亮，少走弯路。

1. 装系统之前先想清楚：你到底要拿树莓派干什么

很多人拿到板子就急着找镜像下载，结果装完发现版本不对、桌面跑不动、或者根本用不上图形界面。系统选型这一步其实比烧录本身更重要，选错了后面全是返工。

1.1 官方 Raspberry Pi OS 和 Ubuntu 到底怎么选

树莓派官方系统 Raspberry Pi OS 是基于 Debian 定制的，对硬件兼容性最好，GPIO 库、摄像头模块、官方配件基本都是开箱即用。如果你要做的是控制舵机、读取传感器、驱动 OV5647 这类摄像头模块，或者跟着大多数树莓派教程走，官方系统是最省心的选择。它现在主要分三个版本：带桌面和推荐软件的完整版、带桌面的标准版、以及 Lite 无桌面版。

Ubuntu 这边，树莓派官方支持的是 Ubuntu Server 和 Ubuntu Desktop 两个方向，版本上 22.04 LTS 和 24.04 LTS 是主流。选 Ubuntu 的典型场景是：你要跑 ROS2、要部署自己训练的 YOLOv5 模型、或者团队统一用 Ubuntu 生态做开发。Ubuntu 在树莓派 5 上的支持已经相当成熟，但要注意树莓派 4B 装 Ubuntu Desktop 会比较吃力，内存 4GB 以下的建议直接上 Server 版。

我个人的判断标准很简单：跟硬件打交道多、要跑图形界面小工具、追求稳定省心，选 Raspberry Pi OS；要做 AI 推理、机器人开发、服务器类应用，选 Ubuntu Server。两者都能装 Python，都能 SSH，差别主要在软件源和预装环境上。

1.2 桌面版还是 Lite 版：一个被低估的选择

新手容易有个误区，觉得有桌面才"完整"。实际上树莓派作为嵌入式设备，绝大多数项目根本不需要图形界面。Lite 版没有桌面环境，内存占用能省下几百 MB，启动更快，跑后台服务更稳。你完全可以在 Lite 版上通过 SSH 完成所有操作，需要图形界面时用 VNC 远程连一下就行。

什么时候必须上桌面版？一是你要用树莓派当轻量办公机或者媒体中心，二是你要跑一些只有图形界面的软件，三是你刚开始学、需要可视化操作来降低门槛。除此之外，Lite 版是更专业的选择。我手上长期跑的几块板子全是 Lite 版，稳定运行几个月不用重启。

1.3 32 位和 64 位的取舍

树莓派 4B 和 5 都支持 64 位系统，官方也早就提供了 64 位镜像。64 位系统能用到更大的内存寻址空间，跑 AI 模型、编译大型项目时优势明显。但 32 位系统在某些老旧的闭源驱动和特定库上兼容性更好。

判断方法：如果你的树莓派是 4B（2GB 及以上）或者 5，直接上 64 位，没有悬念。如果是 3B 或者 3B+，内存只有 1GB，32 位系统反而更轻快。树莓派 Zero 系列基本只能跑 32 位。这个选择在下载镜像时就要定下来，装完再换等于重来一遍。

2. 镜像下载与烧录工具：别在第一步就踩坑

镜像下载和烧录是纯体力活，但工具选不对、操作不规范，后面开机就是各种玄学问题。这一节把下载渠道、工具对比和烧录细节讲清楚。

2.1 镜像从哪下、怎么校验

官方镜像统一在 raspberrypi.com 的 software 页面下载，Ubuntu 镜像在 ubuntu.com 的下载页找 Raspberry Pi 版本。下载时优先选 torrent 或者官方直链，第三方镜像站虽然快，但存在被篡改的风险，装系统这种事不值得省那几分钟。

下载完一定要校验。官方会提供 SHA256 校验值，Windows 上用 certutil 命令，Linux 和 macOS 上用 sha256sum 命令，比对一下哈希值。这一步很多人跳过，但如果镜像在下载过程中损坏，烧录出来的卡开机就是各种报错，排查起来非常痛苦。校验通过再往下走，能省掉一大半莫名其妙的故障。

2.2 Raspberry Pi Imager 和 balenaEtcher 的实测对比

烧录工具主流就两个：官方出的 Raspberry Pi Imager 和第三方的 balenaEtcher。我两个都用过很多次，说下实际感受。

Raspberry Pi Imager 最大的优势是内置了高级设置。在烧录前按 Ctrl+Shift+X 可以调出配置面板，直接预设主机名、开启 SSH、配置 WiFi、设置用户名密码和地区。这意味着你烧录完插卡就能直接 SSH 连上，完全不需要显示器和键盘。这个功能对无屏幕安装来说是决定性的，也是我现在首选它的原因。

balenaEtcher 的优势是界面简洁、跨平台一致性好、烧录速度快，但它没有预设配置功能，烧录完还得手动改配置文件才能无屏幕启动。如果你手边有显示器键盘，用 Etcher 也没问题；如果要做无屏幕部署，Imager 明显更合适。

2.3 烧录时的几个硬性注意点

第一，TF 卡选 Class 10 以上、A1 或 A2 等级的，容量 16GB 起步，32GB 是比较舒服的甜点。劣质卡是树莓派故障的头号来源，系统跑着跑着卡死、文件系统损坏，八成是卡的问题。

第二，烧录前确认卡里没有重要数据，烧录会全盘覆盖。烧录完成后系统会提示你拔出再插入，这一步别省，让系统重新识别分区。

第三，Windows 上烧录完可能会弹出"需要格式化"的提示，千万不要点格式化，那是 Windows 不认识 Linux 分区导致的，点了就把刚烧好的系统毁了。直接关掉弹窗拔卡即可。

3. 无屏幕无键盘安装：SSH 和 WiFi 的预配置

树莓派最实用的玩法就是无屏幕安装，烧录完直接 SSH 连上去操作。这一节把预配置的完整流程讲透，包括 Imager 图形化配置和手动改配置文件两种方式。

3.1 用 Imager 高级设置一步到位

打开 Raspberry Pi Imager，选好系统和存储卡后，按 Ctrl+Shift+X 进入高级选项。这里要填的东西有几个关键项：

• 设置主机名：比如 raspberrypi.local，后面 SSH 就用这个地址连
• 启用 SSH：选"使用密码认证"，设置用户名和密码
• 配置无线局域网：填 WiFi 名称、密码、国家代码（中国填 CN）
• 设置区域选项：时区选 Asia/Shanghai，键盘布局选 us

填完保存，正常烧录。烧录完成后插卡上电，等一两分钟，在同一局域网内的电脑上就能用ssh 用户名@主机名.local连上。这个流程我实测过几十次，成功率很高，前提是 WiFi 名称和密码别填错，国家代码别漏。

3.2 手动配置：boot 分区放两个文件

如果你用的是 balenaEtcher 或者想更精细地控制，可以手动配置。烧录完成后，电脑上会出现一个名为 boot 的小分区（Windows 下能直接看到，macOS 和 Linux 也能挂载）。在这个分区的根目录放两个文件：

第一个是空的ssh文件，没有扩展名，内容为空。它的存在就是告诉系统"开机启动 SSH 服务"。Windows 上新建文本文档后要把 .txt 后缀删掉，注意别变成 ssh.txt。

第二个是wpa_supplicant.conf文件，内容如下：

country=CN ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 network={ ssid="你的WiFi名称" psk="你的WiFi密码" key_mgmt=WPA-PSK }

注意 ssid 和 psk 要用英文引号，WiFi 名称区分大小写。如果 WiFi 是隐藏的，还要加一行scan_ssid=1。这个文件在首次启动后会被系统移动到 /etc/wpa_supplicant/ 目录，boot 分区里就看不到了，这是正常现象。

3.3 首次 SSH 连接的常见卡点

连不上的情况我遇到过很多次，基本集中在几个原因。一是主机名解析失败，.local这种 mDNS 解析在部分 Windows 系统上需要装 Bonjour 服务，最稳妥的办法是登录路由器后台查树莓派的 IP，直接用 IP 连。二是 WiFi 没连上，可能是国家代码没填、密码有特殊字符、或者路由器开了 MAC 地址过滤。三是 SSH 服务没起来，检查 ssh 文件是不是真的没有扩展名。

排查顺序建议：先 ping 主机名，不通就 ping IP，IP 也不通说明网络没连上，去路由器看设备列表。IP 能通但 SSH 拒绝，说明 SSH 服务没启动，重新检查 ssh 文件。这个排查链路能覆盖九成以上的连接问题。

4. 首次开机后的基础配置：换源、更新、远程桌面

系统连上之后，还有一批基础配置要做。这些配置决定了后续用起来顺不顺手，尤其是换源这一步，不换的话 apt 安装软件能慢到让人怀疑人生。

4.1 换源：国内用户的必修课

树莓派官方系统默认的软件源在国外，国内直接 apt update 经常超时或者龟速。换源就是把源地址改成国内镜像站。以 Debian 系的 Raspberry Pi OS（bookworm 或 trixie 版本）为例，需要改两个文件：/etc/apt/sources.list和/etc/apt/sources.list.d/raspi.list。

操作前先备份：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.bak

然后把文件里的raspbian.raspberrypi.org和archive.raspberrypi.org替换成国内镜像站的地址。不同版本代号不一样，bookworm 对应 bookworm，trixie 对应 trixie，改之前先用lsb_release -a确认系统版本代号，别改错了。

Ubuntu 系统换源改的是/etc/apt/sources.list，把ports.ubuntu.com替换成国内镜像地址。Ubuntu 22.04 代号 jammy，24.04 代号 noble，同样要对上。

换完源执行：

sudo apt update sudo apt upgrade -y

更新过程可能要几分钟到十几分钟，取决于更新量。这一步做完，系统基础环境就绪了。

4.2 时区、语言和键盘布局

时区不对会导致日志时间错乱、定时任务执行时间偏移。设置命令：

sudo raspi-config

在 Localisation Options 里依次设置时区（Asia/Shanghai）、键盘布局（Generic 105-key，布局选 Other→English (US)）、WiFi 国家代码（CN）。Ubuntu 系统用sudo dpkg-reconfigure tzdata设置时区。

中文输入法这块，如果跑的是 Lite 版基本用不上；桌面版需要的话装 fcitx 加拼音输入法，但树莓派上跑输入法会占资源，非必要不装。

4.3 开启 VNC 远程桌面

Lite 版没有桌面，但如果你偶尔需要图形界面，可以装一个轻量桌面再开 VNC。更常见的做法是桌面版系统直接开 VNC 服务。在 raspi-config 的 Interface Options 里启用 VNC，然后在电脑上用 VNC Viewer 连接树莓派IP:5900。

VNC 连接需要先设置 VNC 密码，第一次连接会提示。实测下来，树莓派 4B 以上跑 VNC 体验还可以，3B 会比较卡。如果只是偶尔看看图形界面，VNC 够用；如果要长期跑图形应用，建议直接接显示器。

4.4 系统备份：别等卡坏了才后悔

树莓派用 TF 卡做存储，卡是有寿命的，尤其是频繁读写日志的场景。系统配好之后建议做一次完整备份。方法是在电脑上用 dd 命令或者 Win32 Disk Imager 把整张卡读成镜像文件存起来。这样下次卡坏了，直接烧录备份镜像，几分钟就能恢复到配好的状态，不用从头再来一遍。

备份镜像会比较大，等于卡的容量，但这一步的价值在出问题的时候体现得淋漓尽致。我吃过没备份的亏，一块跑了半年的卡突然挂掉，所有配置和项目代码全没了，只能重装重配，花了大半天。

5. 装完系统后跑不起来的排查思路

系统装完不代表万事大吉，开机黑屏、卡在彩虹屏、SSH 连不上、apt 报错，这些都是高频问题。这一节按故障现象分类，给出排查链路。

5.1 开机无显示或卡在彩虹屏

彩虹屏是树莓派 GPU 初始化的画面，正常情况下一闪而过。如果一直卡在这里，常见原因有几个。一是 TF 卡烧录不完整或者卡本身有问题，换张卡重烧试试。二是电源供电不足，树莓派 4B 和 5 对电流要求高，用手机充电头经常带不动，建议用官方电源或者 5V 3A 以上的适配器。三是镜像和板子型号不匹配，比如把树莓派 5 的镜像烧给了 4B。

排查顺序：先换电源，再换卡，最后确认镜像版本。这三个换下来基本能定位问题。

5.2 SSH 连接被拒绝或超时

前面提过一部分，这里补充几个细节。如果之前连上过、突然连不上，可能是 IP 变了（DHCP 租约到期），去路由器重新查 IP。如果一直连不上，检查 ssh 文件是否生效，可以在 boot 分区确认文件还在不在（首次启动后 ssh 文件会被删除，这是正常的，说明服务已启动）。

还有一种情况是系统启动到一半卡住了，SSH 服务没起来。这时候接个显示器看看启动日志，或者用串口调试。树莓派 4B 和 5 支持串口登录，需要 USB 转 TTL 模块，接线是 GND 对 GND、TX 对 RX、RX 对 TX。串口能看到完整的启动过程，是排查启动问题的利器。

5.3 apt 更新报错和依赖问题

换源之后 apt update 报错，常见的是 GPG 密钥错误或者源地址写错。GPG 错误一般是镜像站的密钥没导入，按提示执行导入命令即可。源地址写错的话，检查版本代号是否和系统匹配，bookworm 的源不能用在 bullseye 系统上。

依赖冲突多出现在手动装了一些第三方 deb 包之后。这时候用sudo apt --fix-broken install尝试修复，还不行就sudo apt autoremove清理无用依赖再重试。实在搞不定，回滚到换源前的备份文件，重新来一遍。

5.4 忘记密码怎么办

树莓派忘记密码是高频问题，尤其是放了很久没用的板子。解决办法是把卡拔下来插到电脑上，在 boot 分区（FAT32 格式，Windows 能直接读写）新建一个userconf.txt文件，内容格式是用户名:加密后的密码。加密密码可以用在线工具生成，或者在有 Linux 环境的机器上用openssl passwd -6 你的密码生成。

放好文件后插卡启动，系统会自动读取这个文件并设置密码，然后删除该文件。启动后用新密码登录即可。这个方法对 Raspberry Pi OS 有效，Ubuntu 系统的处理方式不同，需要进恢复模式改密码，相对麻烦一些。

6. 几个让装系统更顺手的实操心得

装系统这件事，流程是固定的，但细节上的经验能省很多时间。最后分享几个我踩坑之后总结出来的点。

第一，TF 卡买好一点的。三星 EVO、闪迪 Extreme 这类 A2 等级的卡，价格贵不了多少，但稳定性和速度差距明显。劣质卡用几个月就开始出问题，数据无价，别在这上面省。

第二，烧录工具固定用一个。我长期用 Raspberry Pi Imager，因为它的预设配置功能太省事了。工具换来换去容易在配置环节出岔子，固定一个用熟就好。

第三，第一次装系统接个显示器。虽然无屏幕安装很酷，但第一次接触树莓派的话，接个 HDMI 显示器能看到启动过程，出问题也好判断。等熟悉了再玩无屏幕部署。

第四，系统配好立刻备份。前面强调过了，这里再提一次，因为真的太重要了。备份镜像存好，下次出问题直接恢复，比重新配置快十倍。

第五，记录你的配置。主机名、用户名、密码、WiFi 信息、换源地址，这些记在一个文档里。树莓派放久了很容易忘，有记录就不用重新折腾。

装系统是树莓派所有项目的地基，地基打稳了，后面跑 Python、接传感器、部署模型才顺。这套流程我用了很多次，从 3B 到 5 都验证过，按这个走基本不会出大问题。真遇到卡住的地方，按故障现象对照排查，大部分都能自己解决。