1. 开箱即玩不先搞定这些“地基”工作我知道很多朋友拿到树莓派这个小板子时第一反应就是兴奋地插电开机恨不得马上让它跑起来。但根据我这些年的经验心急往往吃不了热豆腐。在2025年树莓派5的性能已经相当强悍能做的事情也更多但“万事开头难”这句话依然适用。一个稳固的开始能让你后续的项目部署顺利十倍。所以别急着点亮它我们先花点时间把准备工作做扎实。首先你得搞清楚你手里的树莓派到底要扮演什么角色。是想做一个24小时在线的个人云盘和下载机还是想搭建一个控制智能家居设备的家庭自动化中枢又或者只是想做一个放在客厅的媒体播放中心目标不同后续的软件选择和配置路径会截然不同。我建议新手朋友可以先从一个具体的小目标开始比如“搭建一个能远程访问的文件服务器”这样学习路径会非常清晰每完成一步都有成就感。接下来是硬件清单。除了树莓派主板本身这几样东西必不可少一张靠谱的TF卡这是树莓派的“硬盘”。强烈建议选择A1/V10或更高规格的高速卡容量至少32GB。我踩过坑用低速卡装系统那体验简直是折磨开机慢操作卡顿会让你怀疑人生。一个稳定的电源这是重中之重树莓派5要求5V/5A的PD电源。千万别用手机充电器或者电脑USB口凑合供电不足会导致各种玄学问题比如频繁重启、外设失灵、系统崩溃。我实测下来官方电源或者知名品牌的PD充电头是最稳的选择。散热方案树莓派5性能强了发热也上去了。如果你打算让它持续工作哪怕只是基础服务一个散热片或者小风扇也是必要的。官方散热风扇套件安装简单温控效果也不错可以考虑。至于键盘鼠标显示器对于第一次启动配置我强烈推荐采用“无头模式”也就是不接屏幕完全通过网络来设置。这听起来对新手有点挑战但一旦掌握你会发现自己解放了树莓派可以放在家里任何角落通过你的笔记本电脑或手机就能管理这才是它作为微型服务器的精髓。我们接下来就会详细讲这种方法。2. 系统烧录避开新版本的“坑”一次成功系统烧录是第一步也是最容易出岔子的一步。2025年官方工具Raspberry Pi Imager已经更新了很多版本功能更强但反而给新手埋了个小坑。核心工具去树莓派官网下载Raspberry Pi Imager。安装后打开你会看到一个非常简洁的界面。第一步选择操作系统。这里我建议新手直接选择Raspberry Pi OS (64-bit)并且是带有桌面环境的版本。虽然对于服务器用途精简版Lite更省资源但桌面版有图形界面初期排查问题、熟悉环境会方便很多等熟练了再换也不迟。第二步选择存储设备。插入你的TF卡读卡器连接电脑在软件里选中它。最关键的一步高级配置CtrlShiftX很多教程忽略了这点或者一笔带过导致很多人卡在连不上网的环节。按下这个快捷键后会弹出一个设置窗口这里是你预配置系统的关键设置主机名给你的树莓派起个名字比如my-pi-server以后在网络上就能通过这个名字访问它。启用SSH务必勾选“启用SSH”并选择“使用密码认证”。这是你无屏幕连接它的生命线。设置用户名和密码这里设置的用户名和密码就是你以后登录系统的凭证。记住它默认的pi用户在新版系统中已经不再自动创建了。配置Wi-Fi填写你的Wi-Fi名称SSID和密码并务必选择国家/地区为CN。这是很多朋友烧录后无法联网的根本原因——地区设置不对Wi-Fi频道不合法。设置时区选择Asia/Shanghai。这里有个2025年实测的大坑根据我和很多社区用户的反馈最新版的 Imager如1.9.x在预配置Wi-Fi时可能存在兼容性问题。如果你严格按照上述步骤做了但树莓派还是连不上Wi-Fi可以尝试下载一个稍旧的稳定版本比如1.8.5。很多时候问题就迎刃而解了。配置完成后点击“保存”然后回到主界面点击“写入”。等待进度条走完系统就烧录好了。把TF卡插入树莓派接通电源看到绿色的ACT灯不规则地闪烁一阵后常亮就说明系统启动成功了。3. 无屏幕连接像黑客一样找到你的派没有显示器我们怎么知道树莓派启动成功又怎么知道它的IP地址呢这就是“无头启动”的核心挑战。别担心方法不止一种我们一个个来总有一种适合你。方法A路由器后台查询最推荐这是最省事的方法。确保你的树莓派和你的电脑连接在同一个路由器或同一个手机热点下。然后用电脑浏览器登录你家路由器的管理后台通常是192.168.1.1或192.168.0.1。在“已连接设备”或“DHCP客户端列表”里找一个设备名包含raspberrypi或者你之前设置的主机名如my-pi-server的设备后面跟着的IP地址就是它的地址。方法B使用手机热点如果你没有路由器用手机开热点是最简单的。让树莓派和你的电脑都连接到这个热点。然后在手机的“热点”设置或“已连接设备”里就能看到树莓派的设备名和IP地址。注意有些树莓派型号如Zero系列只支持2.4GHz Wi-Fi请确保手机热点频段设置为2.4GHz。方法C网络扫描工具万能备选如果以上方法都找不到我们就需要一点“技术手段”了。首先你需要知道你电脑在当前网络下的IP地址。在Windows上打开命令提示符CMD输入ipconfig在macOS或Linux的终端里输入ifconfig。找到你无线网卡WLAN的IPv4地址比如192.168.1.100。这个地址的前三段192.168.1就是你的网络段。我们需要扫描这个段内的所有IP。推荐使用Advanced IP Scanner这款图形化工具非常直观。在工具里输入扫描范围例如192.168.1.1到192.168.1.254然后开始扫描。在结果列表里寻找设备制造商为“Raspberry Pi Foundation”或者设备名包含“raspberry”的条目。找到IP地址例如192.168.1.25后我们就可以连接了。4. 首次登录与基础配置打造顺手的开发环境拿到IP地址后我们使用SSH协议远程登录。Windows用户我强烈推荐MobaXterm它集成了SSH、SFTP文件传输、甚至VNC远程桌面于一身非常强大。macOS和Linux用户直接使用系统自带的终端即可。打开MobaXterm点击“Session” - “SSH”在“Remote host”里填入树莓派的IP地址在“Username”里填入你烧录时设置的用户名。点击OK首次连接会弹出安全警告点击“Accept”即可。然后输入你设置的密码输入时屏幕不会显示*号这是正常的回车恭喜你你已经成功进入了树莓派的命令行世界登录后第一件事我习惯先更新系统软件源并升级现有软件。但默认的软件源在国外速度很慢。所以我们必须先换源换成国内的镜像站速度会飞起。# 首先备份原来的源列表文件这是个好习惯 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 使用nano编辑器打开源列表文件 sudo nano /etc/apt/sources.list打开文件后你会看到以deb http://archive.raspberrypi.org/debian/开头的行。我们需要把它们注释掉在行首加#然后添加清华源的地址。注意你需要先确认你的系统版本用lsb_release -a命令查看比如是bookworm。然后将文件内容替换为以bookworm为例deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware deb https://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bookworm main按CtrlO保存再按CtrlX退出nano编辑器。接着更新软件源并升级系统sudo apt update sudo apt upgrade -y这个过程会花费一些时间取决于你的网速。完成后你的树莓派就有了一个高速的软件安装通道。5. 外设驱动配置让屏幕和摄像头工作起来树莓派的可玩性很大程度上在于其丰富的GPIO接口和摄像头接口可以连接各种外设。这里我们解决两个最常用的小屏幕和摄像头。5.1 3.5寸LCD屏幕驱动市面上很多便携树莓派屏幕需要单独安装驱动。主要分两种HDMI驱动板的和直接GPIO驱动的。前者通常即插即用后者需要手动安装驱动。如果你买的是GPIO驱动的屏幕通常卖家会提供驱动。如果没有可以尝试通用的驱动库。以一款常见的3.5寸屏为例# 克隆驱动仓库如果网络不好可以先在电脑上下载好用MobaXterm的SFTP功能传上去 git clone https://github.com/goodtft/LCD-show.git # 进入目录并赋予执行权限 cd LCD-show chmod -R 755 LCD-show # 根据你的屏幕型号执行安装脚本例如35寸屏 sudo ./LCD35-show安装过程中屏幕可能会闪烁几次完成后会自动重启。重启后图形界面应该就能显示在小屏幕上了。重要提示安装这类驱动会修改显示配置可能导致通过HDMI连接的大显示器无法正常显示。如果需要切换回去可以运行驱动目录里的./LCD-hdmi脚本。5.2 摄像头配置树莓派官方和第三方摄像头模块都需要在系统配置中启用。从树莓派4B/5开始配置文件的路径和写法有变化这是很多教程过时的地方。首先确认你的摄像头型号如OV5647, IMX219, IMX708等。然后编辑配置文件# 对于树莓派5 Bookworm/Trixie系统 sudo nano /boot/firmware/config.txt # 对于树莓派4B Bullseye或更早系统 # sudo nano /boot/config.txt在文件末尾添加配置。这里有个关键区别树莓派5有两个摄像头接口CAM0和CAM1。你需要指定接口。例如一个IMX708摄像头接在靠近网口的CAM0上dtoverlayimx708,cam0树莓派4B及更早型号只有一个摄像头接口配置时不要加cam0参数加了反而可能无法识别dtoverlayimx708保存并重启 (sudo reboot)。重启后在终端输入ls /dev/video*如果看到video0和video1之类的设备说明摄像头驱动加载成功。测试摄像头# 预览5秒需要在有图形界面的环境比如接屏幕或VNC rpicam-hello # 拍摄一张照片 rpicam-still -o test.jpg # 录制一段10秒的视频 rpicam-vid -t 10000 -o test.h264如果使用旧的libcamera命令把上面的rpicam-前缀换成libcamera-即可。6. 性能优化与散热让你的派更稳定、更安静树莓派5性能提升显著但随之而来的散热问题也不容忽视。官方推出了带有PWM调速功能的散热风扇我们可以根据温度智能控制风扇转速兼顾散热和静音。编辑配置文件sudo nano /boot/firmware/config.txt在文件末尾添加以下内容这是一个比较均衡的温控策略# 风扇温控配置 # 温度低于36°C时风扇以35%的转速约90/255运行保持静音 dtparamfan_temp036000,fan_temp0_hyst2000,fan_temp0_speed90 # 温度达到40°C时转速提升到约59% dtparamfan_temp140000,fan_temp1_hyst3000,fan_temp1_speed150 # 温度达到52°C时转速提升到约78% dtparamfan_temp252000,fan_temp2_hyst4000,fan_temp2_speed200 # 温度达到58°C时风扇全速运转255 dtparamfan_temp358000,fan_temp3_hyst5000,fan_temp3_speed255参数解释fan_temp036000表示阈值温度是36.0度fan_temp0_hyst2000是2度的回差温度降到34度以下才会降速fan_temp0_speed90是此时的风扇速度0-255。这样设置后日常待机或轻负载时风扇几乎无声只有在高负载计算时才会全速运转有效延长风扇寿命。另一个重要的性能优化是从SSD启动。TF卡的读写速度和寿命是瓶颈。树莓派5的PCIe接口支持NVMe SSD速度是质的飞跃。操作步骤先用TF卡正常启动系统。运行sudo raspi-config进入Advanced Options-Boot Order选择B2 NVMe/USB Boot将SSD设为第一启动项。如果你想启用PCIe Gen3.0以获得更高速度有稳定性风险官方默认Gen2.0可以在同一菜单下的PCIe Speed中开启或者在config.txt中添加dtparampciex1_gen3。使用Raspberry Pi Imager将系统直接烧录到你的NVMe SSD上。关机拔掉TF卡将SSD插入PCIe扩展板上电。系统就会从SSD飞速启动。7. 实战项目部署搭建你的第一个家庭服务器基础打牢后我们终于可以开始有趣的部分了——部署实际项目。这里我以搭建一个“家庭媒体服务器文件共享中心”为例这是一个非常实用且能串联起多项技能的项目。7.1 安装Docker现代化应用的基石Docker是一个容器化平台可以让你像安装手机APP一样轻松部署各种服务相互隔离管理方便。安装命令很简单curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # 将当前用户加入docker组这样就不用每次都加sudo了 sudo usermod -aG docker $USER重要执行完usermod命令后你需要完全退出SSH会话然后重新登录用户组变更才会生效。7.2 部署Jellyfin私人影音库Jellyfin是一个开源的媒体服务器软件可以自动刮削你下载的电影、电视剧的封面和简介打造一个属于你自己的“Netflix”。# 创建一个目录存放媒体文件和数据 mkdir -p ~/media/{movies,tvshows} mkdir -p ~/docker/jellyfin # 使用Docker一键运行Jellyfin docker run -d \ --name jellyfin \ --restart unless-stopped \ -v ~/docker/jellyfin:/config \ -v ~/media:/media \ -p 8096:8096 \ jellyfin/jellyfin:latest命令解释-d后台运行。--restart unless-stopped除非手动停止否则容器随Docker自动启动。-v ...:/config将容器内的配置目录映射到主机这样配置不会丢失。-v ~/media:/media将你的媒体文件夹映射到容器内。-p 8096:8096将容器的8096端口映射到主机的8096端口。运行后在电脑浏览器输入http://你的树莓派IP:8096就能访问Jellyfin的Web界面进行初始化设置了。把你的电影文件放到~/media/movies目录下Jellyfin就能自动识别。7.3 部署Samba局域网文件共享虽然Jellyfin能播视频但我们还需要一个更通用的文件共享方式方便在电脑、手机上传下载任何文件。Samba就是实现Windows网络共享的协议。# 安装Samba服务 sudo apt install samba samba-common-bin -y # 编辑Samba配置文件 sudo nano /etc/samba/smb.conf在配置文件末尾添加[public] path /home/你的用户名/share browseable yes writable yes guest ok yes create mask 0777 directory mask 0777保存后创建共享目录并设置权限mkdir ~/share sudo chmod -R 777 ~/share # 设置Samba用户密码这个密码是连接共享时用的可以和系统密码不同 sudo smbpasswd -a 你的用户名 # 重启Samba服务 sudo systemctl restart smbd现在在你的电脑上打开文件资源管理器地址栏输入\\你的树莓派IP就能看到一个名为public的共享文件夹了可以自由读写。7.4 配置DDNS与远程访问让服务走出家门如果你希望在外面也能访问家里的Jellyfin服务器就需要解决家庭宽带没有固定公网IP的问题。这时需要DDNS动态域名解析服务。国内像花生壳、阿里云、腾讯云都提供这类服务。以免费的“花生壳内网版”为例你需要在树莓派上运行它的客户端它会将你变化的家宽IP绑定到一个固定的域名上。然后你需要在路由器上做端口转发Port Forwarding。登录路由器后台找到“端口转发”或“虚拟服务器”设置将外部访问的端口比如8096转发到树莓派的内网IP和对应端口上。注意此操作有一定安全风险请确保Jellyfin等服务的密码足够复杂。完成这些后你就可以通过http://你的域名:8096在任何有网络的地方访问你的私人影音库了。走到这一步你的树莓派已经从一个裸板变成了一个功能丰富的家庭服务器核心。这个过程里你不仅学会了系统安装、网络配置、外设驱动更掌握了使用Docker部署服务、配置网络共享和远程访问这些非常实用的技能。这只是一个起点基于这个平台你还可以轻松地添加下载工具如qBittorrent、智能家居网关如Home Assistant、博客网站等等。树莓派的魅力就在于你的想法有多大它的舞台就有多大。