引言
树莓派3B+作为一款经典的单板计算机，自2018年发布以来，凭借其强大的性能和丰富的接口，成为了学习、开发和DIY项目的热门选择。而Ubuntu作为最受欢迎的Linux发行版之一，其Server版本为树莓派提供了稳定、高效的运行环境。本教程将详细介绍如何在树莓派3B+上安装Ubuntu系统，从准备工作到系统配置，再到常见问题的解决，力求为您提供一份全面、实用的指南。
一、准备工作
1.1 硬件需求
在开始安装之前，请确保您拥有以下硬件：
树莓派3B+
：主板本身。
MicroSD卡
：建议使用8GB或更大容量的Class 10高速卡，推荐品牌如SanDisk、Samsung等。
电源适配器
：5V/2.5A的Micro USB电源，确保供电稳定。
读卡器
：用于将系统镜像写入MicroSD卡。
网络连接
：网线或Wi-Fi（建议初次配置使用网线）。
显示器和HDMI线
（可选）：用于连接显示器进行初始配置，但Ubuntu Server默认无图形界面，通常通过SSH远程连接。
键盘和鼠标
（可选）：仅在需要本地操作时使用。
1.2 软件准备
Ubuntu Server镜像
：访问
Ubuntu官方下载页面
，选择适用于树莓派3B+的版本。注意，树莓派3B+使用的是ARMv7架构，应选择
armhf
架构的镜像。推荐下载最新的LTS（长期支持）版本，如Ubuntu 22.04 LTS。
镜像写入工具
：推荐使用
Raspberry Pi Imager
或
BalenaEtcher
。这两个工具操作简单，且能验证写入的正确性。
SSH客户端
：如Windows下的PuTTY，或macOS/Linux下的终端。
二、安装Ubuntu Server
2.1 下载并验证镜像
访问Ubuntu官方下载页面，找到适用于树莓派的Ubuntu Server镜像。对于树莓派3B+，请确保下载的镜像架构为
armhf
（32位）或
arm64
（64位）。虽然树莓派3B+是64位处理器，但为了更好的兼容性，可以选择32位版本。
下载完成后，建议验证镜像的完整性。在Linux/macOS下，可以使用
sha256sum
命令：
sha256sum ubuntu-22.04-preinstalled-server-armhf+raspi.img.xz
将输出的哈希值与官网提供的值进行比对。
2.2 将镜像写入MicroSD卡
将MicroSD卡插入读卡器，连接到电脑。
打开Raspberry Pi Imager。
点击”CHOOSE OS”，选择”Use custom”，然后选择你下载的Ubuntu Server镜像文件。
点击”CHOOSE STORAGE”，选择你的MicroSD卡。
点击”WRITE”，等待写入完成。写入过程可能需要几分钟。
2.3 首次启动前的配置（可选）
在某些情况下，你可能需要在首次启动前进行一些配置，例如设置Wi-Fi或启用SSH。
方法一：使用Imager的高级选项
在Raspberry Pi Imager中，点击右下角的齿轮图标（Advanced Options），可以设置：
Hostname
：树莓派的网络名称。
Enable SSH
：启用SSH，并设置密码。
Set username and password
：设置默认用户和密码。
Configure wireless LAN
：设置Wi-Fi连接。
方法二：手动配置
如果Imager的高级选项无法满足需求，可以手动创建配置文件：
写入镜像后，MicroSD卡会分为两个分区：
system-boot
（FAT32）和
writable
（EXT4）。
打开
system-boot
分区，找到并编辑
network-config
文件，配置网络：
version: 2
ethernets:
eth0:
dhcp4: true
wifis:
wlan0:
dhcp4: true
access-points:
“your-ssid”:
password: “your-wifi-password”
如果需要启用SSH，在
system-boot
分区根目录下创建一个名为
ssh
的空文件（无扩展名）。
三、首次启动与基础配置
3.1 启动树莓派
将写入完成的MicroSD卡插入树莓派。
连接网线（如果使用有线网络）。
连接电源，启动树莓派。
等待系统启动完成。首次启动会自动扩展文件系统并完成初始化，可能需要几分钟。
3.2 查找树莓派的IP地址
路由器管理界面
：登录路由器后台，查看连接设备列表，找到名为
ubuntu
或你设置的hostname的设备。
使用
nmap
扫描
（Linux/macOS）：
nmap -sn 192.168.1.0/24
根据你的网络段进行扫描。
3.3 连接树莓派
使用SSH客户端连接到树莓派。默认用户名为
ubuntu
，密码也是
ubuntu
（首次登录会强制修改密码）。
ssh ubuntu@<树莓派的IP地址>
四、系统初始化配置
4.1 更新系统
登录后，首先更新系统软件包：
sudo apt update
sudo apt upgrade -y
4.2 配置时区
sudo timedatectl set-timezone Asia/Shanghai
4.3 配置静态IP（可选）
为了避免IP地址变化导致SSH连接失败，建议配置静态IP。
使用netplan配置
：
查看网络接口名称：
ip a
通常有线网卡为
eth0
，无线网卡为
wlan0
。
编辑netplan配置文件：
sudo nano /etc/netplan/50-cloud-init.yaml
修改为类似以下内容（根据你的网络环境调整）：
network:
version: 2
ethernets:
eth0:
dhcp4: false
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 114.114.114.114]
应用配置：
sudo netplan apply
4.4 创建新用户（可选）
出于安全考虑，建议创建一个新用户并赋予sudo权限。
# 创建新用户
sudo adduser myuser
# 将用户加入sudo组
sudo usermod -aG sudo myuser
# 切换到新用户
su – myuser
4.5 配置防火墙
启用UFW（Uncomplicated Firewall）并允许SSH：
sudo ufw allow ssh
sudo ufw enable
5. 常见问题解决指南
5.1 无法SSH连接
可能原因及解决方法
：
IP地址错误
：确保使用正确的IP地址。
SSH服务未启动
：检查树莓派是否启动完成，等待几分钟后重试。
防火墙阻止
：检查路由器或树莓派的防火墙设置。
网络配置错误
：检查
/etc/netplan/50-cloud-init.yaml
配置是否正确。
用户名或密码错误
：默认用户是
ubuntu
，密码是
ubuntu
。如果修改过，请使用新密码。
5.2 系统启动失败
可能原因及解决方法
：
电源不足
：使用5V/2.5A的电源适配器，避免使用电脑USB口供电。
MicroSD卡问题
：重新写入镜像，或更换一张高速卡。
镜像损坏
：重新下载并验证镜像完整性。
HDMI显示问题
：如果连接了显示器但无显示，可能是HDMI兼容性问题。尝试在
config.txt
中添加：
hdmi_force_hotplug=1
5.3 Wi-Fi连接问题
可能原因及解决方法
：
SSID或密码错误
：检查
/etc/netplan/50-cloud-init.yaml
中的配置。
Wi-Fi驱动问题
：树莓派3B+的Wi-Fi驱动通常已内置，但可以尝试更新固件：
sudo apt install linux-firmware
国家代码设置
：在
/etc/default/crda
中设置正确的国家代码：
REGDOMAIN=CN
5.4 性能问题
可能原因及解决方法
：
CPU温度过高
：树莓派3B+没有散热片，建议加装散热片或风扇。
# 查看温度
vcgencmd measure_temp
内存不足
：关闭不必要的服务，或增加交换空间：
sudo fallocate -l 1G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
永久生效需在
/etc/fstab
中添加一行：
/swapfile none swap sw 0 0
5.5 软件包安装失败
可能原因及解决方法
：
软件源问题
：更换为国内镜像源，如清华源或阿里云源。
sudo sed -i ‘s/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g’ /etc/apt/sources.list
sudo apt update
依赖关系错误
：运行
sudo apt –fix-broken install
修复。
六、进阶使用与优化
6.1 安装图形界面（可选）
虽然Ubuntu Server是无图形界面的，但你可以安装轻量级桌面环境，如XFCE：
sudo apt install xfce4 xfce4-goodies
# 安装VNC服务器以便远程桌面
sudo apt install tigervnc-standalone-server
# 配置VNC密码
vncpasswd
# 启动VNC服务器
vncserver :1 -geometry 1280×800 -depth 24
6.2 部署Docker环境
树莓派是运行Docker容器的理想平台：
# 安装Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 安装Docker Compose
sudo apt install docker-compose-plugin
# 测试
docker run hello-world
6.3 配置GPIO控制
树莓派的GPIO是其核心功能之一。安装RPi.GPIO库：
sudo apt install python3-pip
pip3 install RPi.GPIO
示例：控制LED闪烁
import RPi.GPIO as GPIO
import time
LED_PIN = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(LED_PIN, GPIO.OUT)
try:
while True:
GPIO.output(LED_PIN, GPIO.HIGH)
time.sleep(1)
GPIO.output(LED_PIN, GPIO.LOW)
time.sleep(1)
except KeyboardInterrupt:
GPIO.cleanup()
6.4 系统监控
安装
htop
和
glances
进行系统监控：
sudo apt install htop glances
htop # 交互式进程查看器
glances # 全面的系统监控工具
七、安全加固建议
7.1 修改默认密码
立即修改
ubuntu
用户的密码：
passwd
7.2 禁用密码登录（使用密钥）
生成SSH密钥对（在本地电脑）：
ssh-keygen -t rsa -b 4096
ssh-copy-id ubuntu@<树莓派IP>
然后在树莓派上禁用密码登录：
编辑
/etc/ssh/sshd_config
：
PasswordAuthentication no
重启SSH服务：
sudo systemctl restart ssh
7.3 定期更新系统
设置自动更新：
sudo apt install unattended-upgrades
sudo dpkg-reconfigure unattended-upgrades
八、总结
通过以上步骤，您应该能够在树莓派3B+上成功安装并配置Ubuntu Server系统。树莓派3B+虽然硬件配置有限，但配合Ubuntu系统，依然可以胜任多种任务，如家庭服务器、物联网网关、学习平台等。遇到问题时，请参考本教程的常见问题解决部分，或查阅官方文档。祝您使用愉快！
注意
：本教程基于Ubuntu 22.04 LTS编写，不同版本的Ubuntu可能略有差异。树莓派3B+的性能有限，建议运行轻量级服务以获得最佳体验。
# Ubuntu系统如何在树莓派3B+上安装与使用详解教程及常见问题解决指南
一、前言
树莓派3B+作为一款经典的单板计算机，自2018年发布以来，凭借其强大的性能和丰富的接口，成为了学习、开发和DIY项目的热门选择。而Ubuntu作为最受欢迎的Linux发行版之一，其Server版本为树莓派提供了稳定、高效的运行环境。本教程将详细介绍如何在树莓派3B+上安装Ubuntu系统，从准备工作到系统配置，再到常见问题的解决，力求为您提供一份全面、实用的指南。
二、准备工作
2.1 硬件需求
在开始安装之前，请确保您拥有以下硬件：
树莓派3B+
：主板本身。
MicroSD卡
：建议使用8GB或更大容量的Class 10高速卡，推荐品牌如SanDisk、Samsung等。
电源适配器
：5V/2.5A的Micro USB电源，确保供电稳定。
读卡器
：用于将系统镜像写入MicroSD卡。
网络连接
：网线或Wi-Fi（建议初次配置使用网线）。
显示器和HDMI线
（可选）：用于连接显示器进行初始配置，但Ubuntu Server默认无图形界面，通常通过SSH远程连接。
键盘和鼠标
（可选）：仅在需要本地操作时使用。
2.2 软件准备
Ubuntu Server镜像
：访问
Ubuntu官方下载页面
，选择适用于树莓派3B+的版本。注意，树莓派3B+使用的是ARMv7架构，应选择
armhf
架构的镜像。推荐下载最新的LTS（长期支持）版本，如Ubuntu 22.04 LTS。
镜像写入工具
：推荐使用
Raspberry Pi Imager
或
BalenaEtcher
。这两个工具操作简单，且能验证写入的正确性。
SSH客户端
：如Windows下的PuTTY，或macOS/Linux下的终端。
三、安装Ubuntu Server
3.1 下载并验证镜像
访问Ubuntu官方下载页面，找到适用于树莓派的Ubuntu Server镜像。对于树莓派3B+，请确保下载的镜像架构为
armhf
（32位）或
arm64
（64位）。虽然树莓派3B+是64位处理器，但为了更好的兼容性，可以选择32位版本。
下载完成后，建议验证镜像的完整性。在Linux/macOS下，可以使用
sha256sum
命令：
sha256sum ubuntu-22.04-preinstalled-server-armhf+raspi.img.xz
将输出的哈希值与官网提供的值进行比对。
3.2 将镜像写入MicroSD卡
将MicroSD卡插入读卡器，连接到电脑。
打开Raspberry Pi Imager。
点击”CHOOSE OS”，选择”Use custom”，然后选择你下载的Ubuntu Server镜像文件。
点击”CHOOSE STORAGE”，选择你的MicroSD卡。
点击”WRITE”，等待写入完成。写入过程可能需要几分钟。
3.3 首次启动前的配置（可选）
在某些情况下，你可能需要在首次启动前进行一些配置，例如设置Wi-Fi或启用SSH。
方法一：使用Imager的高级选项
在Raspberry Pi Imager中，点击右下角的齿轮图标（Advanced Options），可以设置：
Hostname
：树莓派的网络名称。
Enable SSH
：启用SSH，并设置密码。
Set username and password
：设置默认用户和密码。
Configure wireless LAN
：设置Wi-Fi连接。
方法二：手动配置
如果Imager的高级选项无法满足需求，可以手动创建配置文件：
写入镜像后，MicroSD卡会分为两个分区：
system-boot
（FAT32）和
writable
（EXT4）。
打开
system-boot
分区，找到并编辑
network-config
文件，配置网络：
version: 2
ethernets:
eth0:
dhcp4: true
wifis:
wlan0:
dhcp4: true
access-points:
“your-ssid”:
password: “your-wifi-password”
如果需要启用SSH，在
system-boot
分区根目录下创建一个名为
ssh
的空文件（无扩展名）。
四、首次启动与基础配置
4.1 启动树莓派
将写入完成的MicroSD卡插入树莓派。
连接网线（如果使用有线网络）。
连接电源，启动树莓派。
等待系统启动完成。首次启动会自动扩展文件系统并完成初始化，可能需要几分钟。
4.2 查找树莓派的IP地址
路由器管理界面
：登录路由器后台，查看连接设备列表，找到名为
ubuntu
或你设置的hostname的设备。
使用
nmap
扫描
（Linux/macOS）：
nmap -sn 192.168.1.0/24
根据你的网络段进行扫描。
4.3 连接树莓派
使用SSH客户端连接到树莓派。默认用户名为
ubuntu
，密码也是
ubuntu
（首次登录会强制修改密码）。
ssh ubuntu@<树莓派的IP地址>
五、系统初始化配置
5.1 更新系统
登录后，首先更新系统软件包：
sudo apt update
sudo apt upgrade -y
5.2 配置时区
sudo timedatectl set-timezone Asia/Shanghai
5.3 配置静态IP（可选）
为了避免IP地址变化导致SSH连接失败，建议配置静态IP。
使用netplan配置
：
查看网络接口名称：
ip a
通常有线网卡为
eth0
，无线网卡为
wlan0
。
编辑netplan配置文件：
sudo nano /etc/netplan/50-cloud-init.yaml
修改为类似以下内容（根据你的网络环境调整）：
network:
version: 2
ethernets:
eth0:
dhcp4: false
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 114.114.114.114]
应用配置：
sudo netplan apply
5.4 创建新用户（可选）
出于安全考虑，建议创建一个新用户并赋予sudo权限。
# 创建新用户
sudo adduser myuser
# 将用户加入sudo组
sudo usermod -aG sudo myuser
# 切换到新用户
su – myuser
5.5 配置防火墙
启用UFW（Uncomplicated Firewall）并允许SSH：
sudo ufw allow ssh
sudo ufw enable
六、常见问题解决指南
6.1 无法SSH连接
可能原因及解决方法
：
IP地址错误
：确保使用正确的IP地址。
SSH服务未启动
：检查树莓派是否启动完成，等待几分钟后重试。
防火墙阻止
：检查路由器或树莓派的防火墙设置。
网络配置错误
：检查
/etc/netplan/50-cloud-init.yaml
配置是否正确。
用户名或密码错误
：默认用户是
ubuntu
，密码是
ubuntu
。如果修改过，请使用新密码。
6.2 系统启动失败
可能原因及解决方法
：
电源不足
：使用5V/2.5A的电源适配器，避免使用电脑USB口供电。
MicroSD卡问题
：重新写入镜像，或更换一张高速卡。
镜像损坏
：重新下载并验证镜像完整性。
HDMI显示问题
：如果连接了显示器但无显示，可能是HDMI兼容性问题。尝试在
config.txt
中添加：
hdmi_force_hotplug=1
6.3 Wi-Fi连接问题
可能原因及解决方法
：
SSID或密码错误
：检查
/etc/netplan/50-cloud-init.yaml
中的配置。
Wi-Fi驱动问题
：树莓派3B+的Wi-Fi驱动通常已内置，但可以尝试更新固件：
sudo apt install linux-firmware
国家代码设置
：在
/etc/default/crda
中设置正确的国家代码：
REGDOMAIN=CN
6.4 性能问题
可能原因及解决方法
：
CPU温度过高
：树莓派3B+没有散热片，建议加装散热片或风扇。
# 查看温度
vcgencmd measure_temp
内存不足
：关闭不必要的服务，或增加交换空间：
sudo fallocate -l 1G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
永久生效需在
/etc/fstab
中添加一行：
/swapfile none swap sw 0 0
6.5 软件包安装失败
可能原因及解决方法
：
软件源问题
：更换为国内镜像源，如清华源或阿里云源。
sudo sed -i ‘s/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g’ /etc/apt/sources.list
sudo apt update
依赖关系错误
：运行
sudo apt –fix-broken install
修复。
七、进阶使用与优化
7.1 安装图形界面（可选）
虽然Ubuntu Server是无图形界面的，但你可以安装轻量级桌面环境，如XFCE：
sudo apt install xfce4 xfce4-goodies
# 安装VNC服务器以便远程桌面
sudo apt install tigervnc-standalone-server
# 配置VNC密码
vncpasswd
# 启动VNC服务器
vncserver :1 -geometry 1280×800 -depth 24
7.2 部署Docker环境
树莓派是运行Docker容器的理想平台：
# 安装Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 安装Docker Compose
sudo apt install docker-compose-plugin
# 测试
docker run hello-world
7.3 配置GPIO控制
树莓派的GPIO是其核心功能之一。安装RPi.GPIO库：
sudo apt install python3-pip
pip3 install RPi.GPIO
示例：控制LED闪烁
import RPi.GPIO as GPIO
import time
LED_PIN = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(LED_PIN, GPIO.OUT)
try:
while True:
GPIO.output(LED_PIN, GPIO.HIGH)
time.sleep(1)
GPIO.output(LED_PIN, GPIO.LOW)
time.sleep(1)
except KeyboardInterrupt:
GPIO.cleanup()
7.4 系统监控
安装
htop
和
glances
进行系统监控：
sudo apt install htop glances
htop # 交互式进程查看器
glances # 全面的系统监控工具
八、安全加固建议
8.1 修改默认密码
立即修改
ubuntu
用户的密码：
passwd
8.2 禁用密码登录（使用密钥）
生成SSH密钥对（在本地电脑）：
ssh-keygen -t rsa -b 4096
ssh-copy-id ubuntu@<树莓派IP>
然后在树莓派上禁用密码登录：
编辑
/etc/ssh/sshd_config
：
PasswordAuthentication no
重启SSH服务：
sudo systemctl restart ssh
8.3 定期更新系统
设置自动更新：
sudo apt install unattended-upgrades
sudo dpkg-reconfigure unattended-upgrades
九、总结
通过以上步骤，您应该能够在树莓派3B+上成功安装并配置Ubuntu Server系统。树莓派3B+虽然硬件配置有限，但配合Ubuntu系统，依然可以胜任多种任务，如家庭服务器、物联网网关、学习平台等。遇到问题时，请参考本教程的常见问题解决部分，或查阅官方文档。祝您使用愉快！
注意
：本教程基于Ubuntu 22.04 LTS编写，不同版本的Ubuntu可能略有差异。树莓派3B+的性能有限，建议运行轻量级服务以获得最佳体验。