1. 从零开始树莓派4B与Ubuntu 22.04的初次邂逅树莓派这个小玩意儿真是越用越上瘾特别是4B版本性能足够应付大多数轻量级开发需求。最近给团队搭建物联网原型机时发现Ubuntu 22.04 3.5寸屏的组合特别适合移动调试场景。不过整个过程踩了不少坑今天就把这套保姆级配置方案分享给大家。先说清楚这套方案适合谁如果你需要一台能随身携带的Linux开发机或者想搭建带本地显示的轻量级家庭服务器这篇文章就是为你准备的。整个流程包含系统烧录、网络配置、远程桌面搭建和屏幕驱动适配四大环节实测从零开始到完整配置大约需要2小时不算下载时间。先看需要准备的硬件树莓派4B主板建议4GB内存版本至少16GB的TF卡推荐三星EVO系列官方3.5寸显示屏或兼容型号网线、5V3A电源、读卡器软件方面需要Ubuntu Server 22.04 LTS镜像注意不是桌面版Raspberry Pi Imager官方烧录工具Windows自带的远程桌面客户端特别提醒Ubuntu 22.04默认禁用了密码登录这个改动坑了不少人后续配置时会重点说明解决方案。2. 系统烧录与初始配置2.1 镜像烧录的隐藏陷阱很多人觉得烧录系统就是把ISO写入TF卡但在树莓派上远不止这么简单。首先到Ubuntu官网下载64位Server版镜像注意不要选成桌面版我们后续会单独安装图形界面。用Raspberry Pi Imager烧录时一定要点开右下角的齿轮图标进行高级设置启用SSH服务设置用户名和密码建议用户名用ubuntu密码8位以上配置Wi-Fi连接可选# 查看已连接设备的小技巧macOS/Linux arp -a | grep -i dc:a6:32烧录完成后千万别急着弹出TF卡还需要做两个关键操作在boot分区根目录新建空文件ssh无扩展名如果是校园网等需要认证的网络建议先配置手机热点2.2 首次启动的避坑指南插卡通电后树莓派第一次启动会比较慢约3-5分钟这时可以通过网线直连电脑进行配置。在Windows上打开命令提示符输入arp -a在一堆IP地址中找以192.168开头的逐个尝试SSH连接。连接成功后你会看到Ubuntu的欢迎信息这时立即做三件事修改默认软件源为国内镜像大幅提升下载速度安装必要工具包设置静态IP可选但推荐# 更换阿里云镜像源 sudo sed -i shttp://.*archive.ubuntu.comhttp://mirrors.aliyun.comg /etc/apt/sources.list sudo sed -i shttp://.*security.ubuntu.comhttp://mirrors.aliyun.comg /etc/apt/sources.list # 安装基础工具集 sudo apt update sudo apt install -y vim git net-tools3. 远程桌面配置实战3.1 图形界面安装的玄机Ubuntu Server本身没有图形界面我们需要先安装桌面环境。这里有个坑直接安装ubuntu-desktop会附带大量不必要的软件推荐用以下精简方案# 安装Xfce轻量桌面 sudo apt install -y xubuntu-desktop # 或者安装GNOME核心版 sudo apt install -y --no-install-recommends ubuntu-desktop-minimal安装过程中可能会遇到依赖问题特别是遇到进度条卡住时不要强制重启试试这个解决方案sudo NEEDRESTART_MODEa apt-get dist-upgrade --yes3.2 远程桌面服务配置远程访问推荐使用xrdp方案比VNC更流畅且兼容性好。按这个顺序安装先装tightvncserverxrdp的依赖再装xrdp主服务最后配置防火墙sudo apt install -y tightvncserver sudo apt install -y xrdp sudo ufw allow 3389/tcp服务安装完成后需要调整一个关键配置sudo vim /etc/xrdp/xrdp.ini找到use_vsocktrue改为false然后重启服务sudo systemctl restart xrdp现在就可以用Windows自带的远程桌面连接了输入树莓派IP地址用户名密码用之前设置的。如果连接后是灰屏试试这个解决方案echo xfce4-session ~/.xsession chmod x ~/.xsession4. 3.5寸屏驱动攻克记4.1 驱动兼容性难题市面上常见的3.5寸屏驱动多数是为32位系统设计的而Ubuntu 22.04默认是64位系统。我测试过三种驱动方案最终这个最稳定先安装基础依赖库编译安装定制版fbtft驱动配置显示输出优先级# 安装编译工具链 sudo apt install -y raspberrypi-kernel-headers build-essential dkms # 获取驱动源码 git clone https://github.com/tianyoujian/rpi-fbtft.git cd rpi-fbtft sudo ./install.sh4.2 显示配置优化驱动安装后需要调整几个关键参数# 编辑配置文件 sudo vim /boot/firmware/config.txt添加以下内容dtparamspion dtoverlayvc4-kms-v3d max_framebuffers2 hdmi_force_hotplug1重启后通过这个命令切换显示输出# 查看可用显示设备 xrandr --listmonitors # 将输出切换到fb0 xrandr --output fb0 --auto --primary如果遇到触摸屏不准的问题试试校准sudo apt install -y xinput-calibrator xinput_calibrator --device ADS7846 Touchscreen5. 系统优化与实用技巧5.1 性能调优方案树莓派4B跑Ubuntu 22.04虽然流畅但做些优化会更好启用zswap内存压缩调整swappiness值禁用不必要的服务# 启用zswap sudo vim /etc/default/grub # 修改GRUB_CMDLINE_LINUX为 GRUB_CMDLINE_LINUXzswap.enabled1 zswap.compressorlz4 # 调整swappiness echo vm.swappiness10 | sudo tee -a /etc/sysctl.conf5.2 自动化运维脚本我整理了几个常用操作的快捷脚本比如一键更新#!/bin/bash sudo apt update sudo NEEDRESTART_MODEa apt-get dist-upgrade -y sudo apt autoremove -y保存为update.sh后添加执行权限chmod x update.sh ./update.sh6. 常见问题解决方案黑屏问题如果启动后屏幕不亮尝试在config.txt中添加hdmi_safe1 hdmi_force_hotplug1触摸屏反向编辑xorg.conf.d配置sudo vim /usr/share/X11/xorg.conf.d/99-calibration.conf添加以下内容Section InputClass Identifier calibration MatchProduct ADS7846 Touchscreen Option Calibration 3936 227 268 3886 Option SwapAxes 0 EndSectionWiFi断连修改网络管理器配置sudo vim /etc/NetworkManager/conf.d/default-wifi-powersave-on.conf将wifi.powersave 3改为2
树莓派4B实战：Ubuntu 22.04系统、3.5寸屏驱动与远程桌面一站式部署指南
发布时间：2026/5/28 14:18:50
1. 从零开始树莓派4B与Ubuntu 22.04的初次邂逅树莓派这个小玩意儿真是越用越上瘾特别是4B版本性能足够应付大多数轻量级开发需求。最近给团队搭建物联网原型机时发现Ubuntu 22.04 3.5寸屏的组合特别适合移动调试场景。不过整个过程踩了不少坑今天就把这套保姆级配置方案分享给大家。先说清楚这套方案适合谁如果你需要一台能随身携带的Linux开发机或者想搭建带本地显示的轻量级家庭服务器这篇文章就是为你准备的。整个流程包含系统烧录、网络配置、远程桌面搭建和屏幕驱动适配四大环节实测从零开始到完整配置大约需要2小时不算下载时间。先看需要准备的硬件树莓派4B主板建议4GB内存版本至少16GB的TF卡推荐三星EVO系列官方3.5寸显示屏或兼容型号网线、5V3A电源、读卡器软件方面需要Ubuntu Server 22.04 LTS镜像注意不是桌面版Raspberry Pi Imager官方烧录工具Windows自带的远程桌面客户端特别提醒Ubuntu 22.04默认禁用了密码登录这个改动坑了不少人后续配置时会重点说明解决方案。2. 系统烧录与初始配置2.1 镜像烧录的隐藏陷阱很多人觉得烧录系统就是把ISO写入TF卡但在树莓派上远不止这么简单。首先到Ubuntu官网下载64位Server版镜像注意不要选成桌面版我们后续会单独安装图形界面。用Raspberry Pi Imager烧录时一定要点开右下角的齿轮图标进行高级设置启用SSH服务设置用户名和密码建议用户名用ubuntu密码8位以上配置Wi-Fi连接可选# 查看已连接设备的小技巧macOS/Linux arp -a | grep -i dc:a6:32烧录完成后千万别急着弹出TF卡还需要做两个关键操作在boot分区根目录新建空文件ssh无扩展名如果是校园网等需要认证的网络建议先配置手机热点2.2 首次启动的避坑指南插卡通电后树莓派第一次启动会比较慢约3-5分钟这时可以通过网线直连电脑进行配置。在Windows上打开命令提示符输入arp -a在一堆IP地址中找以192.168开头的逐个尝试SSH连接。连接成功后你会看到Ubuntu的欢迎信息这时立即做三件事修改默认软件源为国内镜像大幅提升下载速度安装必要工具包设置静态IP可选但推荐# 更换阿里云镜像源 sudo sed -i shttp://.*archive.ubuntu.comhttp://mirrors.aliyun.comg /etc/apt/sources.list sudo sed -i shttp://.*security.ubuntu.comhttp://mirrors.aliyun.comg /etc/apt/sources.list # 安装基础工具集 sudo apt update sudo apt install -y vim git net-tools3. 远程桌面配置实战3.1 图形界面安装的玄机Ubuntu Server本身没有图形界面我们需要先安装桌面环境。这里有个坑直接安装ubuntu-desktop会附带大量不必要的软件推荐用以下精简方案# 安装Xfce轻量桌面 sudo apt install -y xubuntu-desktop # 或者安装GNOME核心版 sudo apt install -y --no-install-recommends ubuntu-desktop-minimal安装过程中可能会遇到依赖问题特别是遇到进度条卡住时不要强制重启试试这个解决方案sudo NEEDRESTART_MODEa apt-get dist-upgrade --yes3.2 远程桌面服务配置远程访问推荐使用xrdp方案比VNC更流畅且兼容性好。按这个顺序安装先装tightvncserverxrdp的依赖再装xrdp主服务最后配置防火墙sudo apt install -y tightvncserver sudo apt install -y xrdp sudo ufw allow 3389/tcp服务安装完成后需要调整一个关键配置sudo vim /etc/xrdp/xrdp.ini找到use_vsocktrue改为false然后重启服务sudo systemctl restart xrdp现在就可以用Windows自带的远程桌面连接了输入树莓派IP地址用户名密码用之前设置的。如果连接后是灰屏试试这个解决方案echo xfce4-session ~/.xsession chmod x ~/.xsession4. 3.5寸屏驱动攻克记4.1 驱动兼容性难题市面上常见的3.5寸屏驱动多数是为32位系统设计的而Ubuntu 22.04默认是64位系统。我测试过三种驱动方案最终这个最稳定先安装基础依赖库编译安装定制版fbtft驱动配置显示输出优先级# 安装编译工具链 sudo apt install -y raspberrypi-kernel-headers build-essential dkms # 获取驱动源码 git clone https://github.com/tianyoujian/rpi-fbtft.git cd rpi-fbtft sudo ./install.sh4.2 显示配置优化驱动安装后需要调整几个关键参数# 编辑配置文件 sudo vim /boot/firmware/config.txt添加以下内容dtparamspion dtoverlayvc4-kms-v3d max_framebuffers2 hdmi_force_hotplug1重启后通过这个命令切换显示输出# 查看可用显示设备 xrandr --listmonitors # 将输出切换到fb0 xrandr --output fb0 --auto --primary如果遇到触摸屏不准的问题试试校准sudo apt install -y xinput-calibrator xinput_calibrator --device ADS7846 Touchscreen5. 系统优化与实用技巧5.1 性能调优方案树莓派4B跑Ubuntu 22.04虽然流畅但做些优化会更好启用zswap内存压缩调整swappiness值禁用不必要的服务# 启用zswap sudo vim /etc/default/grub # 修改GRUB_CMDLINE_LINUX为 GRUB_CMDLINE_LINUXzswap.enabled1 zswap.compressorlz4 # 调整swappiness echo vm.swappiness10 | sudo tee -a /etc/sysctl.conf5.2 自动化运维脚本我整理了几个常用操作的快捷脚本比如一键更新#!/bin/bash sudo apt update sudo NEEDRESTART_MODEa apt-get dist-upgrade -y sudo apt autoremove -y保存为update.sh后添加执行权限chmod x update.sh ./update.sh6. 常见问题解决方案黑屏问题如果启动后屏幕不亮尝试在config.txt中添加hdmi_safe1 hdmi_force_hotplug1触摸屏反向编辑xorg.conf.d配置sudo vim /usr/share/X11/xorg.conf.d/99-calibration.conf添加以下内容Section InputClass Identifier calibration MatchProduct ADS7846 Touchscreen Option Calibration 3936 227 268 3886 Option SwapAxes 0 EndSectionWiFi断连修改网络管理器配置sudo vim /etc/NetworkManager/conf.d/default-wifi-powersave-on.conf将wifi.powersave 3改为2
