2. 环境准备

Raspberry Pi项目打包与部署的前提，是拥有一套稳定、可复现的基础运行环境。无论是制作镜像、配置开机自启，还是进行现场演示，硬件选型、系统安装、远程访问这三项基础工作的质量，直接决定了后续所有操作的效率与可靠性。本章将围绕“硬件选型→系统烧录→无头配置→远程连接”这条主线，系统讲解Raspberry Pi环境搭建的完整方法论，并针对常见误区给出规避策略。

2.1 硬件型号选择：从项目需求反推配置

Raspberry Pi 家族目前主流在售型号包括 Raspberry Pi 5（2023年发布）、Raspberry Pi 4 Model B（2019年发布）以及 Raspberry Pi Zero 2 W。选择哪一款，不能只看“最新”或“最贵”，而应从项目打包后的运行负载、外设接口需求、功耗约束和成本预算四个维度反向推导。

核心决策逻辑：先明确项目打包后需要常驻运行哪些服务。例如，若项目仅需运行一个 Python 脚本读取传感器数据并通过 MQTT 上报，Raspberry Pi Zero 2 W 即可胜任；若项目需要运行 OpenCV 图像处理、Node-RED 可视化面板或本地 Web 服务，则至少需要 Raspberry Pi 4B（4GB 内存版本）；若项目涉及轻量级 AI 推理（如 TensorFlow Lite）或需要同时驱动两个 4K 显示屏，Raspberry Pi 5 是更稳妥的选择。

在项目打包场景中，还需要额外考虑镜像兼容性。Raspberry Pi OS 的 ARM64 版本在 Pi 4B 和 Pi 5 上均可运行，但 Pi 5 需要较新的引导加载程序（2023年12月之后的 EEPROM 版本）。如果团队内同时使用 Pi 4B 和 Pi 5，建议统一采用 Raspberry Pi OS Bookworm（Debian 12 基础）的 64 位版本，并确保内核版本 ≥ 6.1，以保证镜像在不同硬件间迁移时行为一致。

2.2 操作系统安装：Raspberry Pi Imager 与预配置

Raspberry Pi OS 的安装早已告别“下载镜像→手动解压→dd 写入”的繁琐流程。官方推荐的 Raspberry Pi Imager 工具（支持 Windows/macOS/Linux）将烧录、预配置、验证集成在一个图形界面中，是当前最可靠、最可复现的安装方式。

标准安装流程：

1. 准备一张 ≥32GB 的 microSD 卡（建议 A2 速度等级，U3 或 V30 标识），插入读卡器连接电脑。
2. 打开 Raspberry Pi Imager，点击“选择操作系统”→ 选择“Raspberry Pi OS (64-bit)”下的 Lite 版本（无桌面，适合服务器型项目）或 Desktop 版本（带图形界面，适合需要 VNC 演示的项目）。
3. 点击“选择存储设备”，选中目标 SD 卡（务必确认盘符，避免误烧其他磁盘）。
4. 点击右下角齿轮图标（高级设置），进行预配置：
   • 勾选“启用 SSH”，选择“使用密码登录”并设置用户名（如 pi）和强密码；
   • 若使用 Wi-Fi，填写 SSID 和密码（注意 2.4GHz 频段兼容性）；
   • 勾选“设置时区”为 Asia/Shanghai，键盘布局选择 us 或 gb；
   • 可选：勾选“预填充无线局域网国家代码”为 CN。
5. 点击“写入”，等待烧录完成。Imager 会先写入镜像，然后自动挂载 boot 分区写入预配置文件，最后进行校验。

烧录完成后，将 SD 卡插入 Raspberry Pi，连接网线（或依赖预配置的 Wi-Fi），上电启动。首次启动时系统会自动扩展根文件系统至 SD 卡全容量，并生成 SSH 主机密钥，通常需要 60~90 秒。此时不要断电，等待系统完全就绪。

2.3 SSH 远程连接：从密码认证到密钥认证

SSH 是 Raspberry Pi 项目开发与部署的“生命线”。无论是执行命令、传输文件还是调试服务，SSH 都是最高频的交互通道。对于打包和演示场景，SSH 的稳定性与安全性同等重要。

基础连接方法：在终端（Windows 使用 PowerShell 或 Windows Terminal）中执行：

ssh pi@<树莓派IP地址>
# 首次连接会提示确认主机指纹，输入 yes
# 然后输入预设的密码即可登录

查找树莓派 IP 地址的常用方法：① 路由器管理后台查看 DHCP 客户端列表；② 使用 arp -a 命令扫描局域网；③ 使用 Raspberry Pi Imager 烧录时预配置静态 IP；④ 使用 ping raspberrypi.local（需网络支持 mDNS/Bonjour）。

升级为 SSH 密钥认证：密码登录每次都需要输入密码，且存在暴力破解风险。对于需要频繁部署的项目，强烈建议配置密钥认证：

# 在本地电脑生成密钥对（若已有 ~/.ssh/id_ed25519 可跳过）
ssh-keygen -t ed25519 -C "pi-project-deploy"

# 将公钥复制到树莓派（需输入一次密码）
ssh-copy-id -i ~/.ssh/id_ed25519.pub pi@<树莓派IP>

# 测试免密登录
ssh pi@<树莓派IP>

密钥认证配置完成后，可以进一步编辑树莓派上的 /etc/ssh/sshd_config，将 PasswordAuthentication 改为 no，并重启 SSH 服务（sudo systemctl restart ssh），彻底关闭密码登录入口。但需注意：修改前务必确认密钥登录已生效，否则可能将自己锁在门外。

2.4 VNC 图形界面配置：无头模式下的可视化操作

当项目需要图形界面演示（如展示仪表盘、运行 GUI 应用）但现场没有 HDMI 显示器时，VNC（Virtual Network Computing）是标准解决方案。Raspberry Pi OS Desktop 版本内置了 RealVNC Server，只需简单配置即可启用。

启用 VNC 服务：

# 进入树莓派配置工具
sudo raspi-config
# 选择 Interface Options → VNC → 选择 <是> 启用
# 退出后重启 VNC 服务
sudo systemctl enable --now vncserver-x11-serviced

若使用 Lite 版本（无桌面），需要先安装桌面环境和 VNC 服务：

sudo apt update
sudo apt install -y raspberrypi-ui-mods realvnc-vnc-server
# 安装完成后执行 raspi-config 启用 VNC

客户端连接：在本地电脑安装 VNC Viewer（RealVNC 官方客户端），输入树莓派 IP 地址，使用 SSH 相同的用户名密码登录。首次连接时，VNC Server 会提示设置分辨率。建议在树莓派上编辑 /boot/config.txt（Bookworm 版本为 /boot/firmware/config.txt），固定 HDMI 输出模式，避免 VNC 连接时分辨率异常：

# 在 config.txt 末尾添加
hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=82  # 1920x1080 60Hz
# 或使用 1280x720 以降低网络带宽占用：hdmi_mode=85

对于演示场景，建议将 VNC 分辨率设置为 1280×720 或 1920×1080，并关闭桌面特效（raspi-config → Performance → 关闭 Compositor），以提升 VNC 画面流畅度。

2.5 环境验证与基线固化

环境搭建完成后，不要急于开始项目开发。建议执行一套标准化的验证流程，并将验证结果记录为“环境基线”，以便后续镜像打包时进行对比。

验证清单：

1. 系统信息：执行 cat /etc/os-release 确认系统版本；uname -a 查看内核版本；vcgencmd measure_temp 检查 CPU 温度（空载应低于 50°C）。
2. 网络连通性：ping -c 4 8.8.8.8 测试外网；ping -c 4 网关IP 测试内网；curl -I https://mirrors.tuna.tsinghua.edu.cn 测试软件源可达性。
3. SSH 稳定性：连续执行 ssh pi@树莓派IP "uptime" 10 次，确认无断连；检查 /var/log/auth.log 无异常认证失败记录。
4. VNC 可用性：从本地 VNC Viewer 连接，打开终端执行 glxinfo | grep "OpenGL renderer" 确认 GPU 加速正常（若未安装 mesa-utils 可跳过）。
5. 存储健康：执行 sudo fdisk -l 确认分区正确；df -h 查看根分区是否已扩展至全卡容量；sudo smartctl -a /dev/mmcblk0（若支持）查看 SD 卡健康度。

验证通过后，建议立即制作一份基础镜像备份。使用 dd 命令或 Win32DiskImager 将当前 SD 卡完整克隆为 .img 文件。这份“干净系统镜像”是后续项目打包的起点，也是出现系统损坏时快速恢复的救命稻草。

2.6 常见误区与复盘

在长期的项目交付与培训过程中，以下环境搭建误区出现频率最高，值得重点规避：

• 误区一：使用非官方镜像或精简版系统。部分教程推荐使用 Ubuntu Server 或 DietPi 以节省资源，但这些系统在硬件驱动、GPIO 库兼容性、VNC 配置等方面与 Raspberry Pi OS 存在差异，可能导致项目打包后无法在标准环境复现。除非有明确理由，否则一律使用官方 Raspberry Pi OS。
• 误区二：忽视电源质量。Raspberry Pi 对电压波动极其敏感。使用手机充电器（5V/1A）供电，在 CPU 负载升高时电压跌落，轻则性能骤降（屏幕右上角出现黄色闪电图标），重则 SD 卡文件系统损坏。务必使用官方电源或经过认证的 5V/3A 电源。
• 误区三：SD 卡热插拔。在树莓派运行时直接拔卡，或在写入镜像后未安全弹出就拔卡，都会导致分区表损坏。正确做法是：关机（sudo shutdown -h now）后等待电源灯熄灭再拔卡。
• 误区四：SSH 密钥权限错误。将私钥文件权限设置为 644 会导致 SSH 拒绝使用该密钥。私钥权限必须为 600（chmod 600 ~/.ssh/id_ed25519），公钥权限为 644 即可。
• 误区五：VNC 与 HDMI 同时使用时的分辨率冲突。当 HDMI 显示器与 VNC 同时连接时，系统可能以 HDMI 显示器的 EDID 信息为准，导致 VNC 分辨率异常。建议在演示场景中拔掉 HDMI 线，或使用 hdmi_force_hotplug=1 强制指定分辨率。

环境准备阶段的核心目标是建立可预测、可复现、可回滚的基础设施。硬件选型决定了性能上限，系统安装决定了软件基线，SSH 与 VNC 决定了交互效率。完成本章所述的全部步骤并验证通过后，后续的镜像制作、开机自启配置和演示部署才能在一个稳固的地基上展开。