入门

开始使用你的树莓派

提示

要开始使用树莓派，您需要以下各项：

一个电源
启动介质（例如具有充足存储空间和速度的microSD卡）

您可以将树莓派设置为带有桌面的交互式计算机，或者设置为只能通过网络访问的无需显示器的计算机。如将树莓派设置为无需显示器，您不需要任何额外的外围设备；您可以在安装操作系统时预先配置主机名、用户帐户、网络连接和ssh 。如果您想直接使用树莓派，则需要以下附加配件：

一台显示器
一根连接到显示器的视频线缆
一个键盘
一个鼠标

电源

下表显示了为各种树莓派型号供电所需的USB-PD电源模式。您可以使用任何提供正确电源模式的高质量电源。

型号	推荐电源（电压/电流）	树莓派电源
树莓派500+	5V/5A	27W USB-C 电源
树莓派5 和树莓派500	5V/5A、5V/3A(外设电流限制 600mA)	27W USB-C 电源
树莓派4B 和树莓派400	5V/3A	15W USB-C 电源
树莓派3（所有型号）	5V/2.5A	12.5W Micro USB 电源
树莓派 2B	5V/2.5A	12.5W Micro USB 电源
树莓派1（所有型号）	5V/2.5A	12.5W Micro USB 电源
树莓派Zero（所有型号）	5V/2.5A	12.5W Micro USB 电源

将电源插入标有"POWER IN"、"PWR IN"或"PWR"的端口。某些树莓派型号（例如Zero系列）具有与电源端口形状相同的USB输出端口。请确保在树莓派上使用正确的端口！

启动介质

树莓派模块缺乏板载存储，因此您必须提供它。您可以从树莓派支持的任何介质启动操作系统映像：通常是microSD卡，还可以是USB存贮设备、网络存储以及通过PCIe HAT连接的存储。但是，只有最新的树莓派型号支持所有这些媒体类型。

自树莓派1 Model A+ 以来的所有树莓派消费型号均配有microSD插槽。当microSD插槽包含卡时，您的树莓派会自动从该插槽启动。

键盘

您可以使用树莓派上的任何USB端口连接有线键盘或USB蓝牙接收器。

鼠标

您可以使用树莓派上的任何USB端口连接有线鼠标或USB蓝牙接收器。

显示

树莓派各型号具有以下显示连接：

型号	显示输出
树莓派5、400、500、500+	2个micro HDMI
树莓派4B	2个micro HDMI、音频和复合输出通过3.5mmTRRS耳麦插孔
树莓派3（所有型号）	1个HDMI、音频和复合输出通过3.5mmTRRS耳麦插孔
树莓派2B	1个HDMI、音频和复合输出通过3.5mmTRRS耳麦插孔
树莓派1A+、1B+	1个HDMI、音频和复合输出通过3.5mmTRRS耳麦插孔
树莓派1A、1B	1个HDMI、音频通过3.5mmTRRS耳麦插孔，复合输出通过phono
树莓派Zero（所有型号）	1个mini HDMI，通过焊盘输出复合视频信号

注意

没有任何 Raspberry Pi 型号支持通过 USB-C 传输视频（DisplayPort 备选模式）。

如果您的 Raspberry Pi 有多个 HDMI 端口，请将主显示器插入标有 "HDMI0 "的端口。

大多数显示器没有micro或mini HDMI端口。但是您可以使用micro HDMI转HDMI线缆或mini HDMI转HDMI线缆将树莓派上的这些端口连接到任何HDMI显示器。对于不支持HDMI的显示器，请考虑使用转换器将显示输出从HDMI转换到显示器支持的端口。

音频

所有配备HDMI、micro HDMI或mini HDMI的树莓派型号都支持通过HDMI进行音频输出。所有树莓派型号均支持USB音频。所有配备蓝牙的树莓派型号都支持蓝牙音频。树莓派 1、2、3 和 4 的系列型号均包含3.5mmTRRS耳麦插孔，可能需要功放才能获得足够的输出音量。

网络

以下树莓派型号配备WiFi和蓝牙连接：

自树莓派3B 以后的所有旗舰型号
所有键盘型号
所有的 Zero W 型号
所有的 Pico W 型号
配置无线功能的计算模块（自 CM4 起可用）

型号后缀"B"表示配备以太网端口的变体；"A"则表示未配备以太网端口。键盘型号同样包含以太网端口。若您的树莓派未配备以太网端口，仍可通过USB转以太网适配器连接有线网络。

安装操作系统

要使用树莓派，您需要一个操作系统。默认情况下，树莓派设备检查插入SD卡插槽的SD卡上的可用操作系统。

根据您的树莓派型号，您还可以从其他存储设备启动操作系统，包括USB存贮设备、通过HAT连接的存储和网络存储。

要在树莓派的存储设备上安装操作系统，您需要：

可用于将系统映像写入存储设备的计算机
将存储设备插入该计算机

大多数树莓派用户选择microSD卡作为启动设备。

我们推荐使用Raspberry Pi Imager安装操作系统。

如果您没有其他计算机可以将映像写入启动设备，您可以直接从互联网在树莓派上安装操作系统。

使用Imager工具安装

Raspberry Pi Imager是一款可帮助您在macOS、Windows和Linux上下载和写入映像的工具。Imager包含许多适用于树莓派的流行操作系统映像。Imager还支持加载直接从树莓派或第三方供应商（例如Ubuntu）下载的映像。您可以使用Imager为树莓派预配置登录凭据和远程访问设置。

Imager支持以以.img格式打包的映像以及容器格式，例如.zip。

步骤1：安装并启动 Imager

将 Raspberry Pi Imager 下载至您的计算机（Windows、Mac 或 Linux）：.

通过以下任一方式安装 Imager：

在 Windows 和 Mac 上，从软件下载下载最新版本。运行安装程序。
在树莓派操作系统上，运行 sudo apt install rpi-imager。
在其他 Linux 系统上，从软件下载下载最新版本的 AppImage 文件。赋予 AppImage 可执行权限。.

通过以下任一方式启动树莓派刻录工具：

在应用程序菜单中查找。
点击桌面上的树莓派映像工具图标。
以 root 权限运行 AppImage 文件。例如使用命令：sudo ./Raspberry_Pi_Imager-2.0.0-desktop-x86_64.AppImage

步骤2：配置基础参数

告知树莓派映像工具所需的硬件与操作系统组合：

在设备选项卡中，从列表中选择您的树莓派型号。点击下一步。
在操作系统选项卡中，从可用系统中选择。点击下一步。

Imager会在列表顶部显示推荐的树莓派操作系统版本。若需安装计算机中的镜像文件，请选择使用自定义选项。
将所需存储设备连接至计算机。例如，通过外置或内置SD卡读卡器插入microSD卡。
在存储选项卡中，选择用于写入镜像的存储设备。点击下一步。

注意

若计算机连接了多个存储设备，请务必选择正确的设备！通常可通过容量大小识别存储设备。若无法确定，请断开其他设备直至确认目标设备。当您尝试覆盖计算机系统盘时，Imager会发出警告。

步骤3：自定义操作系统

树莓派操作系统及部分第三方操作系统支持自定义设置。若您安装的是此类操作系统，可通过Imager中的后续步骤进行个性化配置。这些步骤为可选操作，选择跳过自定义即可省略。但我们强烈建议您在首次启动前，通过Imager的自定义设置完成树莓派的初始配置。

可预先配置：

设备主机名
时区设置
键盘布局
用户名与密码
Wi-Fi 凭证
远程连接选项
Raspberry Pi Connect 功能

若您先前已通过 Imager 完成自定义步骤，后续操作中将自动填入您选择的值。

若未通过这些操作系统自定义设置配置树莓派，系统将在首次启动后再次要求您输入相同信息。对于树莓派操作系统，首次启动配置将在配置向导中进行。

在 自定义>主机名 选项卡中，为树莓派输入仅含字母、数字和连字符的主机名，然后选择下一步。

树莓派将通过mDNS协议向网络广播此主机名。当树莓派连接网络后，其他设备可通过 <主机名>.local 或 <主机名>.lan 与您的计算机通信。
在 自定义>本地化 选项卡中，选择您的首都城市。Imager将自动填充该城市的时区和键盘布局，您可修改这些设置。您的选择还会设置 Wi-Fi 监管域；监管域始终与所选首都城市对应。选择下一步。
在 自定义>用户 选项卡中，为树莓派管理员用户输入用户名和密码。选择下一步。
在 自定义>Wi-Fi 选项卡中，首次使用时Imager会预填当前连接Wi-Fi网络的SSID（名称）和密码。

a. 选择连接 安全网络 或 开放网络。

b. 若无预填信息或需修改，请输入无线网络的SSID（名称）。如果不想让树莓派连接 Wi-Fi 网络，请清除 SSID。

c. 对于安全网络，需输入并确认网络密码。

d. 若您的网络未公开广播SSID，请启用 隐藏SSID 设置。

e. 选择 下一步。
在 自定义>远程访问 选项卡中配置您的 SSH 设置。

a. 若需通过网络远程使用树莓派，请将 启用 SSH 开关切换至激活状态。

若计划运行无显示器的树莓派，请启用此选项或为设备配置树莓派连接工具。

b. 启用 SSH 后，请选择认证方式：
- 选择使用密码认证，通过自定义>用户选项卡中设置的用户名和密码进行网络登录。
- 选择使用公钥认证，配置基于SSH密钥的认证机制。Imager将显示公钥输入框。若SSH配置中已存在RSA公钥，Imager将自动采用该公钥。若未配置，可将公钥复制到Imager或浏览本地计算机查找公钥文件。
部分操作系统现已显示 自定义>Raspberry Pi Connect 选项卡。要将设备关联至您的树莓派Connect账户，请完成以下步骤：

a. 将 启用树莓派Connect 开关切换至激活状态。

b. 选择 打开树莓派Connect。树莓派Connect网站将在默认浏览器中打开。

c. 使用您的树莓派ID账户登录，若尚未注册请创建账户。

d. 在 新建认证密钥 页面创建您的认证密钥。

该密钥为一次性临时令牌。树莓派连接网站会显示令牌自生成起有效期。使用令牌前，请确保在过期时间前启动树莓派并连接网络。
- 若您的树莓派ID账户未加入任何组织，请选择 创建认证密钥并启动树莓派Imager。
- 若您已加入一个或多个组织，请先选择关联该密钥的组织或账户，再选择 创建认证密钥并启动树莓派Imager。
e. 浏览器可能询问是否允许该网站打开 Raspberry Pi Imager。请确认您希望启动 Imager。

Raspberry Pi Imager 将自动跳转至 Raspberry Pi Connect 标签页。该标签页会显示一条确认信息，表明 Imager 已从浏览器接收认证令牌，并提供包含令牌的输入框。

若令牌未自动复制，可手动将其粘贴至 Imager。打开 Raspberry Pi Connect 网页的 遇到问题？ 部分，复制令牌并粘贴到 Imager 的令牌字段中。

f. 选择 下一步。

步骤4：设置Imager选项

您可选择配置 Imager 在写入过程中的行为。在写入映像前，随时可通过选择 应用程序选项 进行设置。

在 应用程序选项 对话框中，可配置以下选项：

Imager 在写入完成时是否播放提示音
Imager 在写入完成时是否弹出存储介质
是否向我们发送有关设备和操作系统的匿名遥测数据。详情参见匿名指标（遥测）。
写入过程中是否显示警告信息。

（高级用户）应用选项对话框还允许您设置自定义存储库，用于检索操作系统和设备列表。更多信息请参阅 Imager 存储库 URL。

第5步：将映像写入存储设备

完成Imager各选项卡设置后，系统将显示摘要页面供您核对选项。

若确认无误，请选择写入。
Imager将弹出警告提示即将覆盖存储介质上的所有数据。继续操作请选择我已知晓，清除并写入。

若出现管理员权限提示，要求授予存储介质读写权限，请允许Imager继续操作。

Imager开始将映像写入存储介质。此过程可能需要数分钟，请稍作休息。

Imager正在向存储设备写入镜像。

写入完成后，Imager将验证镜像是否正确写入。建议您完成验证步骤。若需取消验证，请选择 跳过验证。

写入完成后，Imager将执行验证。

映像写入并验证完成后，Imager将显示完成选项卡。选择结束即可退出程序。

镜像操作已完成。

接下来请转至配置树莓派章节，启动您的树莓派设备。

通过网络安装

网络安装使树莓派能够使用通过网络下载的树莓派Imager版本在存储设备上安装操作系统。通过网络安装，您可以在树莓派上安装操作系统，无需单独的SD卡读卡器，也不需要除树莓派之外的任何计算机。您可以在任何兼容的存储设备上运行网络安装，包括SD卡和USB存贮设备。

自 Raspberry Pi 4B 和键盘型号起，网络安装只能在旗舰型号上运行。如果你的 Raspberry Pi 运行旧版引导加载器，你可能需要更新引导加载器才能使用网络安装。

网络安装需要以下内容：

支持网络安装固件的树莓派型号
一台显示器
一个键盘
有线互联网连接

要启动网络安装，请在满足以下配置的情况下按住SHIFT键的同时打开树莓派电源：

无可启动存储设备
连接了键盘
连接了兼容存储设备，例如SD卡或USB存贮设备

如果您尚未将树莓派连接到互联网，请使用以太网线将其连接。

连接到互联网后，您的树莓派将下载树莓派安装程序。如果下载失败，您可以重复该过程重试。

下载完树莓派Installer后，您的树莓派将自动启动树莓派Imager。有关运行树莓派Imager的更多信息，请参阅安装操作系统。

有关网络安装配置的更多信息，请参阅HTTP boot。

设置你的树莓派

安装操作系统映像后，将存储设备插入（或连接到）树莓派。

首先，拔掉树莓派的电源，以确保在连接外围设备时树莓派处于断电状态。如果您将操作系统安装在microSD卡上，您现在可以将其插入树莓派的卡插槽。如果您在其他存储设备上安装了操作系统，您现在可以将其连接到树莓派。

然后，插入其他外围设备，例如鼠标、键盘和显示器。

最后，将电源连接到树莓派。当树莓派开机时，您应该会看到状态LED亮起。如果您的树莓派连接到显示器，您应该会在几分钟内看到启动屏幕。

首次启动配置

若您已在Imager安装过程中自定义了树莓派操作系统，恭喜您，设备已准备就绪。继续执行下一步，了解如何充分利用树莓派。

如果您的树莓派在5分钟内未启动，请检查状态LED。如果闪烁，请参阅LED警告闪烁代码以获取更多信息。如果您的树莓派不能启动，请尝试以下缓解步骤：

如果您使用SD卡以外的启动设备，请尝试从SD卡启动
重新刷新映像到您的SD卡；确保在Imager中完成整个验证步骤
更新树莓派上的bootloader，然后重新刷新映像到您的SD卡

如果您选择跳过Imager中的自定义选项，您的树莓派将在首次启动时将运行配置向导。您需要显示器和键盘来查看向导；鼠标是可选的。

蓝牙

如果您使用的是蓝牙键盘或鼠标，此步骤将引导您完成设备配对。您的树莓派将扫描可配对设备并连接到为每个项目找到的第一个设备。

此过程适用于内置或外部USB蓝牙适配器。如果您使用USB适配器，请在启动树莓派之前将其插入。

区域设置

此页面可帮助您配置您的国家/地区、语言、时区以及键盘布局。

用户

此页面帮助您配置默认用户帐户的用户名和密码。

默认情况下，旧版本的树莓派OS将用户名设置为"pi"。如果您使用用户名"pi"，请避免使用旧的默认密码"raspberry"，以确保树莓派的安全。

WiFi

此页面可帮助您连接到WiFi网络。从列表中选择您首选的网络。

如果您的网络需要密码，您可以在此处输入。

浏览器

此页面允许您选择Firefox或Chromium作为默认互联网浏览器。您可以选择卸载未设置为默认的浏览器。

选择浏览器页面。

Raspberry Pi 连接

此页面可让您启用 Raspberry Pi Connect，它提供了无需手动网络配置即可远程访问 Raspberry Pi 的功能。

启用 Raspberry Pi 连接页面

软件更新

一旦您的树莓派可以访问互联网，此页面将帮助您将操作系统和软件更新到最新版本。在软件更新过程中，如果您在浏览器选择步骤中选择卸载非默认浏览器，向导将删除它。下载更新可能需要几分钟的时间。

提示

若您是首次为树莓派500+进行系统更新，整个过程可能需要长达半小时。等待期间不妨泡杯咖啡或外出散步。

当您看到弹出窗口表明您的系统是最新的时，单击确定继续下一步。

结束

在配置向导结束时，单击重新启动以重新启动树莓派。您的树莓派将应用您的配置并启动到桌面。

下一步

现在您的树莓派已设置完毕并准备就绪，下一步是什么？

教程

我们的教程演示了使用新计算机的各种方法。您可以按照激发您兴趣教程来学习编码、控制外部设备以及构建令人兴奋的新项目。

支持

如需官方树莓派产品的支持，或与其他树莓派用户联系，请访问树莓派论坛。

进一步阅读

您可以在 Gareth Halfacree 撰写的最新版《官方树莓派初学者指南》中找到有关如何开始使用树莓派的更多信息。

了解如何：

设置您的树莓派安装其操作系统，然后开始使用这台功能齐全的计算机。
通过使用Scratch 3、Python和MicroPython编程语言的分步指南开始编码项目。
尝试连接电子元件，并享受创建令人惊叹的项目的乐趣。

第五版新增内容：

针对最新的树莓派计算机进行了更新：树莓派5和树莓派Zero 2W。
涵盖最新的树莓派操作系统。
包括有关树莓派Pico的新章节！

您可以在树莓派Press 网站上购买这本书。

中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352

入门

开始使用你的树莓派

电源

启动介质

推荐的SD卡

键盘

鼠标

显示

音频

网络