树莓派 5 装机指南

2024 年 2 月，给我的 Raspberry Pi 5 安装 Ubuntu，最后踩了两次坑才装好。感觉搜索前几的教程都不对，没一个让我顺利装完的。那么我来记录一下安装过程吧

一、下载

你需要下载两个东西：

• ubuntu-23.10：适用于树莓派 5 的 Ubuntu 镜像
• Raspberry Pi Imager：将镜像写入 TF 卡的工具

1）ubuntu-23.10 的下载页面：ubuntu.com/download/raspberry-pi

PS: 你可以选择服务器版或桌面版，我安的是桌面版

2）Raspberry Pi Imager 的下载页面：raspberrypi.com/software

二、将镜像写入 TF 卡

下载好镜像之后，你需要把镜像写入 TF 卡。

打开 Raspberry Pi Imager，界面上有三个白框，分别是：

• CHOOSE DEVICE: 选择你的树莓派版本。选 Raspberry Pi 5
• CHOOSE OS: 选择你要安装的镜像。由于我们用的是本地镜像，下拉栏划到最底，选 Use custom
• CHOOSE STORAGE: 选择你的 TF 卡。没插卡的请插卡，然后在下拉栏选中你的卡。由于后续步骤会抹除 TF 卡数据，清确保卡内没有重要文件

三、首次启动 Ubuntu

在不插电源的情况下，将 TF 卡插入板子。

然后连接外接显示屏、鼠标、键盘、网线（如果有），插电即可直接点亮。如果 1 分钟后没有任何反应，可以尝试按 TF 卡旁边的电源键。需要注意的是，树莓派 5 新加了实体电源键，老版本没有。

启动后的画面：

接下来按开机引导完成设置就好了。

现在你可以打开终端 (Terminal)，快速过一下这块板子的硬件信息。

# 查看系统发行版本
lsb_release -a

# 查看系统硬件架构
uname -m

# 查看内存
free -h

# 查看磁盘容量
df -h

# 查看 CPU 核心数
lscpu

# 查看IP地址
ip addr

四、更新系统

1）点击桌面左下角的 Show Apps（或快捷键 Super + A）

2）点击 Software Updater

五、部署开发环境

1）基础依赖

更新 apt 及其管理的软件包

sudo apt update && sudo apt upgrade -y

🦀 安装 openssh-server, lrzsz, wget, git, curl, vim, build-essential, net-tools

sudo apt install -y vim git curl wget

# 可选装
sudo apt install -y openssh-server build-essential net-tools lrzsz

🐯 安装 snapd

sudo apt install -y snapd

# 启用 snapd 和 snapd.apparmor
sudo systemctl enable --now snapd apparmor

🐳 安装 flatpak

sudo apt install -y flatpak
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
sudo apt install gnome-software-plugin-flatpak

2）安装 Java

安装 Java 11 (which is a long-term support version)

sudo apt install openjdk-11-jdk

安装 Java 8

sudo apt install openjdk-8-jdk

3）安装 jupyter-notebook

sudo apt install jupyter-notebook

4）安装 miniconda

官方文档：docs.anaconda.com/free/miniconda

需要注意的是，树莓派 5 是 aarch64 架构，不能直接使用官方 Linux 安装命令。而是要用 Miniconda3 Linux-aarch64 64-bit 版本的下载链接，然后在安装命令中把对应的 sh 文件链接换成 aarch64 的才行。

# 下载并运行安装脚本
mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh

# 为 miniconda 配置初始化环境
~/miniconda3/bin/conda init bash
~/miniconda3/bin/conda init zsh

# 如果没啥事可以重启一下，重启后 miniconda 在命令行生效
reboot

关于 miniconda 的其他操作，可前往《Linux 运维手册》查阅。

相关章节：安装 miniconda3、miniconda3 换 Kernal

Note: miniforge 是 miniconda 的开源替代。

官网传送门 => conda-forge

安装 miniforge：

bash Miniforge3-$(uname)-$(uname -m).sh

配置环境变量：

# 对于 MacOS，在 ~/.bash_profile 中修改环境变量
forge_bin=$HOME/miniforge3/bin
if [[ ! :$PATH: =~ :$forge_bin: ]]; then
    export PATH="$forge_bin:$PATH"
fi

初始化：

conda init  # 初始化
conda activate  # 启动 miniforge

5）安装 VSCode

① 下载 .deb 安装包

官方下载页面：code.visualstudio.com/Download

⚠️ 注意，要下载 .deb 的 Arm64 版本，红框里那个

② 安装，把 <filename> 换成实际下载文件的文件名

sudo apt install ./<filename>.deb

6）安装 Samba（可选）

Samba 用于在笔记本和树莓派之间传输文件。

sudo apt install -y samba samba-client

配置 Samba 可以参考 Linux 运维手册，这里不再赘述。

7）连接 GitHub

以下内容来自阿里云云效 配置 SSH 密钥

① 查看已存在的 SSH 密钥

在生成新的 SSH 密钥前，请先确认是否需要使用本地已生成的SSH密钥，SSH 密钥对一般存放在本地用户的根目录下。

Linux、Mac 请直接使用以下命令查看已存在的公钥，Windows 用户在 WSL（需要 windows10 或以上）或 Git Bash下使用以下命令查看已生成公钥：

ED25519 算法

cat ~/.ssh/id_ed25519.pub

RSA 算法

cat ~/.ssh/id_rsa.pub

如果返回一长串以 ssh-ed25519 或 ssh-rsa 开头的字符串, 说明已存在本地公钥，你可以跳过步骤二生成 SSH 密钥，直接操作步骤三。

② 生成 SSH 密钥

若步骤一未返回指定内容字符串，表示本地暂无可用 SSH 密钥，需要生成新的 SSH 密钥，请按如下步骤操作：

1.访问终端（ Windows 请使用 WSL 或 Git Bash），运行 ssh-keygen -t。

2.输入密钥算法类型和可选的注释。

注释会出现在 .pub 文件中，一般可使用邮箱作为注释内容。

基于ED25519算法，生成密钥对命令如下：

ssh-keygen -t ed25519 -C "<注释内容>"

基于RSA算法，生成密钥对命令如下：

ssh-keygen -t rsa -C "<注释内容>"

3.点击回车，选择 SSH 密钥生成路径。

以 ED25519 算法为例，默认路径如下：

Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519):

密钥默认生成路径：/home/user/.ssh/id_ed25519，公钥与之对应为：/home/user/.ssh/id_ed25519.pub。

以 RSA 算法为例，默认路径如下：

Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa):

密钥默认生成路径：/home/user/.ssh/id_rsa，公钥与之对应为：/home/user/.ssh/id_rsa.pub。

4.设置一个密钥口令。

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

口令默认为空，你可以选择使用口令保护私钥文件。如果你不想在每次使用 SSH 协议访问仓库时，都要输入用于保护私钥文件的口令，可以在创建密钥时，输入空口令。

5.点击回车，完成密钥对创建。

③ 拷贝公钥

除了在命令行打印出已生成的公钥信息手动复制外，可以使用命令拷贝公钥到粘贴板下，请参考操作系统使用以下命令进行拷贝：

Windows（在WSL或Git Bash下）:

cat ~/.ssh/id_ed25519.pub | clip

Mac:

tr -d '\n' < ~/.ssh/id_ed25519.pub | pbcopy

GNU/Linux (requires xclip):

xclip -sel clip < ~/.ssh/id_ed25519.pub

④ 在 GitHub 上设置公钥

[头像] –> [Settings] –> [侧边栏：SSH and GPG keys] –> [New SSH key]

8）安装 GNOME Tweaks

GNOME Tweaks 可用于更换桌面主题，Ubuntu 用以下命令安装：

sudo apt install gnome-tweaks

我安装的主题是 Orchis-theme，你可以浏览资源站，选择自己喜欢的主题。

• GNOME 资源站:
  • gnome-look.org
  • pling.com
• GNOME 插件:
  • extensions.gnome.org

六、软件推荐

七、物料清单

• Raspberry Pi 5
• 电源（5V 5A USB-C）
• CPU 风扇
• TF卡（至少 32 G）
• 读卡器
• 外接显示器
• micro HDMI 转 HDMI 线（或转接头 + 双头 HDMI 线）
• USB 键盘
• USB 鼠标
• 网线（可选）
• 外壳（可选）
• 小屏（可选）

八、其他操作系统

其他适用于树莓派的操作系统：

• CentOS:
  • mirrors.tuna.tsinghua.edu.cn
  • isoredirect.centos.org
• Kali Linux:
  • kali.org
• Raspberry Pi OS:
  • raspberrypi.com

参考资料：

• YouTube: Raspberry Pi 5 Ubuntu install in 8 minutes
• Installing Ubuntu Core on a Raspberry Pi
• 配置 SSH 密钥