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
官方文档:https://docs.anaconda.com/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
# 一般来说,运行一下 ~/.bashrc 就行
source ~/.bashrc
# 如果没啥事,重启一下,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 插件:
六、软件推荐
软件名 | 用途 | 下载方式 |
---|---|---|
Firefox | 浏览器 | 官方自带的 App Center |
Chromium | 浏览器 | 官方自带的 App Center |
VSCode | 代码编辑器 | visualstudio 官网 |
Sublime | 代码编辑器 | 官方自带的 App Center |
IntelliJ IDEA | 代码编辑器 | jetbrains 官网 |
Alacritty | Terminal | sudo apt install alacritty |
VLC | 视频播放器 | sudo apt install vlc |
UFW | 防火墙 | 官方自带的 App Center |
cmatrix | 黑客帝国风格的“数字雨” | sudo apt install cmatrix |
七、物料清单
- Raspberry Pi 5
- 电源(5V 5A USB-C)
- CPU 风扇
- TF卡(至少 32 G)
- 读卡器
- 外接显示器
- micro HDMI 转 HDMI 线(或转接头 + 双头 HDMI 线)
- USB 键盘
- USB 鼠标
- 网线(可选)
- 外壳(可选)
- 小屏(可选)
八、其他操作系统
其他适用于树莓派的操作系统:
- CentOS:
- Kali Linux:
- Raspberry Pi OS:
参考资料: