【树莓派】树莓派从入门到入土（2026 更新）

更新于 2026-10-14。本文保留最初折腾树莓派 4B、想把小板子当家用服务器的经历，同时重写已经过时的安装步骤。旧版中的 CentOS 8、默认口令、固定网络信息和未经维护的镜像命令不再适用，请不要照抄。

为什么买一块树莓派

最开始只是想弄明白：一台比手机充电器大不了多少的小电脑，能不能装 Linux、跑服务、接传感器？于是买了树莓派 4B、散热器、外壳、电源和存储卡，先把系统烧进去，再折腾无线网络、Docker、Nginx 和个人页面。它确实让我把“服务器”从云控制台搬到了桌面上，也很快让我发现：硬件买回来不等于项目就会自己出现。

这次更新把经验拆成三件事：先安全地启动设备，再明确它适合承担什么工作，最后给每一步都留可复现的检查点。旧教程中的 CentOS 8 已经不适合作为今天的新手安装起点；系统、镜像和软件包都应以设备官方文档当前推荐为准。

安装系统

最省心的入口是官方 Raspberry Pi Imager：选择实际的板型、操作系统和目标存储卡，再核对存储设备后写入。写入会覆盖所选设备，电脑同时接了多个 U 盘或移动硬盘时，先按容量和设备名确认目标。

无显示器安装时，可以在 Imager 的自定义选项中预设主机名、用户、无线网络和远程访问。需要 SSH 时优先使用公钥认证；至少为每台设备设置独立的强口令，不要使用教程示例口令，也不要把口令、Wi-Fi 密码或私钥放进公开文章、仓库、截图和 shell 历史。

第一次启动后，先确认系统和硬件信息：

uname -m
cat /etc/os-release
df -h
ip -brief address

更新前确认系统版本、供电和可用存储；在 Raspberry Pi OS 上可使用系统包管理器更新：

sudo apt update
sudo apt full-upgrade

先阅读将要更新的包列表，再确认执行。内核或固件更新后按系统提示重启。正式开始前给原始 SD 卡做一份可恢复备份；后续实验优先用可替换的存储介质，别把唯一工作环境当成临时试验盘。

远程连接与网络边界

无显示器设备通常通过 SSH 管理。先在本地网络完成第一次连接，确认设备身份和 SSH 主机密钥，再逐步切换到密钥登录。修改 SSH、防火墙或网络配置前，准备一条本地恢复路径，避免把自己锁在设备之外。

不要把家用路由器端口直接转发到 SSH、数据库或 Docker 管理端口。
远程访问优先使用经过认证的 VPN 或设备官方远程访问方案，并了解它们的账户、更新和权限边界。
Wi-Fi 配置通过 Imager 或受保护的系统设置完成；不要把真实 SSID、地址、用户名、密码或密钥贴进技术博客。
只开放当前确实需要的服务。开发完成后关闭临时调试端口，并确认服务监听在预期网卡上。

排障时先用只读信息定位问题：ip -brief address 看接口，systemctl --failed 看失败服务，journalctl -u 服务名 -n 50 --no-pager 看有限日志。贴日志到外部之前先删掉账号、令牌、公共 IP、私有域名和设备标识。

把它当小型 Linux 主机

树莓派很适合做低功耗实验节点、家庭自动化入口、轻量服务或硬件网关，但它不是“免费的云服务器”。公网访问还涉及网络运营商、NAT、域名、TLS、备份和监控；microSD 也不适合承受所有持续写入。

如果使用 Docker：

确认镜像有与设备匹配的 linux/arm64 架构，固定明确版本，不要长期使用漂移的 latest。
数据写入单独的数据卷或可靠存储；定期备份，并实际验证恢复。
数据库、Redis 等服务默认只绑定本机或可信内网，不因“容器启动成功”就把端口暴露到公网。
容器只挂载确实需要的目录和设备。不要为了省事把整个 /dev、宿主密钥目录或所有权限交给容器。
持续观察温度、内存、磁盘空间和写入量；出现不稳定时先降负载、查电源和散热，再决定是否升级硬件。

从 Linux 走到 ROS 2

如果目标是机器人，不要一上来就把所有东西塞进树莓派。先熟悉 Linux、网络、Python 和容器，再按“ROS 节点与 Topic → 参数和 launch → 传感器消息与 QoS → rosbag 回放 → 视觉检测 → 轨迹跟踪 → 标定和坐标变换 → 控制”的顺序推进。

我后续的羽毛球视觉机器人复盘记录了 Raspberry Pi、容器化 ROS 2、图像检测和卡尔曼跟踪之间的分层，也明确哪些只是项目文档记录、哪些还没有摄像头或执行器实测：树莓派入门到入土：ROS 2 视觉机器人项目复盘。先把消息的坐标系、单位、时间戳和失效状态定义清楚，再考虑驱动电机；未经标定的像素位置不能直接变成机械动作。

如果想从基础开始练 ROS 2 环境和节点通信，而不是看项目复盘，可继续阅读树莓派 ROS 2 入门：从 Python 小练习到机器人节点。这是一份学习路线，不表示本机练习或真实设备已经完成 ROS 验收。

ROS 发行版、操作系统和 CPU 架构要作为一组来选。安装前查看 ROS REP-2000 和对应发行版文档，不要照搬几年前的容器标签或宿主系统命令。需要在 Debian 等非目标平台运行时，容器能隔离用户空间依赖，但不会自动解决 ARM64 镜像、设备映射、网络发现和实时性能问题。

这次折腾教会我的事

树莓派最有价值的部分不是替代云主机，而是让“系统、网络、存储、服务和硬件”这些平时藏在控制台后面的东西变得可触摸。第一次装好 Nginx 时很有成就感，后来设备吃灰也很正常：没有明确的使用场景，再小的主机也会变成抽屉里的硬件。

现在我更愿意先写下一个能在半天内验收的小目标，例如读取温度、发布一条 ROS Topic、保存一段传感器数据或在局域网查看状态。做到之后再决定要不要加摄像头、模型、数据库和公网访问。项目可以逐步长大，但权限、备份和恢复路径要从第一天就算进去。