1. 香橙派RK3588首次开机从拆箱到SSH远程登录的完整路径香橙派5Orange Pi 5这块板子最近在边缘计算圈子里热度一直不低核心原因就一个RK3588这颗芯片的算力放在这个价位段确实能打。8核64位架构4个Cortex-A76大核加4个Cortex-A55小核内置NPU算力标称6TOPS拿来跑YOLOv5s这类轻量级目标检测模型推理帧率能到比较舒服的水平。但很多朋友拿到板子之后卡在第一步——系统怎么烧、怎么连、SSH怎么通。这篇内容就是解决这个问题的从镜像选择、烧录、首次上电、网络配置到SSH远程登录把首次使用的完整链路走一遍。适合谁看如果你手上刚拿到香橙派5或者5 Pro之前没怎么接触过RK3588平台的Linux开发板或者用过树莓派但想转到RK3588生态这篇内容可以帮你把首次使用的坑一次性踩完。整个流程我会按实际操作顺序展开每一步都说明为什么这么做以及我踩过哪些坑。2. 首次使用前的整体思路与准备工作2.1 为什么首次使用要按这个顺序走很多人拿到开发板第一反应是直接插电看能不能亮这个习惯在树莓派上问题不大但在RK3588平台上容易出问题。原因在于RK3588的启动链路比树莓派复杂得多板载SPI Flash里可能预装了引导程序eMMC或TF卡的启动优先级需要确认再加上官方镜像有多个版本Ubuntu、Debian、Android选错了镜像可能连HDMI都没有输出。所以正确的首次使用顺序应该是先确认硬件版本和启动介质再选镜像并烧录然后上电验证基础功能最后配置网络和SSH。这个顺序的核心逻辑是“先让板子能跑起来再让它能被远程访问”避免一上来就折腾网络配置结果发现系统本身没起来。2.2 硬件清单与工具准备在动手之前先把需要的东西备齐。下面这张表是我实际用到的完整清单物品规格要求备注香橙派5/5 Pro主板RK3588/RK3588S确认版本5和5 Pro接口布局不同TF卡32GB以上Class 10或U3建议三星EVO或闪迪 Extreme读卡器USB 3.0烧录速度差别很大电源适配器5V/4AType-C接口必须够功率否则会反复重启HDMI线显示器首次调试用确认系统正常启动网线超五类以上有线连接比WiFi稳定USB转TTL串口模块CH340或CP2102可选但强烈建议备一个电源这块要特别说一下。香橙派5官方推荐5V/4A我试过用5V/2A的手机充电器系统能启动但一跑负载就掉电重启。RK3588满负荷运行时功耗不低电源不够会导致各种莫名其妙的问题比如SSH连上了但一会儿就断、系统日志里出现 undervoltage 报警。这个坑很隐蔽因为板子看起来是“能用”的但稳定性极差。TF卡的选择也值得展开说。我一开始用了一张杂牌32GB卡烧录完系统启动特别慢后来换成三星EVO Plus启动时间从将近两分钟缩短到四十秒左右。TF卡的随机读写性能直接影响系统启动和运行流畅度这个钱不能省。2.3 镜像选择Ubuntu还是Debian香橙派官方提供了多个系统镜像主要分Ubuntu和Debian两大系列。如果你的目标是后续部署YOLOv5s做推理我建议直接选Ubuntu 22.04 Server版或者Desktop版。原因有几个Ubuntu的软件源更丰富Python环境和相关依赖的安装更顺畅RKNN工具链在Ubuntu上的兼容性验证更充分社区里关于RK3588部署YOLO系列的教程大多基于Ubuntu遇到问题更容易找到参考。Server版和Desktop版的区别在于是否带图形界面。如果你打算用SSH远程操作Server版就够了资源占用更少。但首次使用建议先用Desktop版因为可以通过HDMI直接看到系统界面确认硬件没问题之后再切换到Server版或者关闭图形界面。镜像下载去香橙派官网的下载页面找到Orange Pi 5对应的Ubuntu镜像。注意区分5和5 Pro的镜像虽然都是RK3588系列但设备树文件不同混用可能导致部分外设不工作。3. 系统烧录与首次上电实操3.1 镜像烧录的完整步骤烧录工具我推荐用balenaEtcher跨平台操作简单烧录完会自动校验。具体步骤把TF卡插入读卡器连接到电脑打开balenaEtcher选择下载好的镜像文件通常是.img.xz格式Etcher会自动解压选择目标磁盘确认是TF卡而不是电脑硬盘点击Flash等待烧录和校验完成烧录完成后先别急着拔卡。如果用的是Server版镜像需要提前配置网络否则首次启动后没有图形界面又连不上网会很麻烦。具体做法是烧录完成后电脑上会出现一个名为boot的分区在里面新建一个wpa_supplicant.conf文件WiFi配置或者修改network-config文件有线网络配置。WiFi配置文件的格式如下countryCN ctrl_interfaceDIR/var/run/wpa_supplicant GROUPnetdev update_config1 network{ ssid你的WiFi名称 psk你的WiFi密码 }有线网络一般不需要额外配置插上网线后系统会自动通过DHCP获取IP。但如果你需要设置静态IP可以在network-config文件里修改。3.2 首次上电与系统初始化TF卡插入香橙派接好HDMI、网线和电源上电。首次启动会比后续启动慢一些因为系统要做初始化包括扩展文件系统、生成SSH密钥等。等待时间大概一到三分钟取决于TF卡速度。如果HDMI有输出说明系统正常启动了。首次登录的默认用户名和密码香橙派官方镜像通常是orangepi/orangepi有些版本是root/orangepi。登录后第一件事是修改默认密码这是基本的安全习惯。系统初始化完成后建议先做几件事更新软件源sudo apt update sudo apt upgrade -y确认网络连通ping -c 4 www.baidu.com查看系统信息uname -a确认内核版本cat /etc/os-release确认系统版本这里有个细节要注意首次apt upgrade可能会更新内核更新完需要重启。重启后如果HDMI没有输出不要慌可能是内核更新后显示驱动加载顺序变了等一会儿或者重新插拔HDMI线通常能恢复。3.3 串口调试HDMI没输出时的救命稻草如果HDMI一直没有输出或者系统启动到一半卡住串口调试就是最直接的排查手段。USB转TTL模块接到香橙派的调试串口上通常是靠近40针排针的那组三针GND、TX、RX电脑上用PuTTY或者minicom打开串口波特率设为1500000。串口连上后上电能看到完整的启动日志。如果日志停在某一行不动了那一行就是问题所在。我遇到过卡在Starting kernel ...的情况后来发现是TF卡烧录不完整重新烧录就好了。也遇到过卡在文件系统检查阶段原因是TF卡有坏块换卡解决。串口调试这个技能在后续部署YOLOv5s的过程中也会用到因为NPU相关的内核模块加载信息有时候只在串口日志里能看到。所以建议首次使用就把串口调通后面会省很多事。4. 网络配置与SSH远程登录4.1 确认IP地址与网络连通性系统启动后第一件事是确认板子的IP地址。如果接了HDMI直接在终端里运行ip addr show找到eth0或者wlan0对应的inet地址。如果没接HDMI可以通过路由器的管理界面查看已连接设备列表找到香橙派对应的IP。拿到IP后先在电脑上ping一下确认连通ping 192.168.1.100如果ping不通检查几个点板子和电脑是否在同一网段、路由器是否开启了AP隔离、板子防火墙是否拦截了ICMP。香橙派默认的Ubuntu镜像一般不会开防火墙所以大概率是网络配置问题。4.2 SSH服务开启与首次连接香橙派Ubuntu镜像默认应该已经安装了SSH服务但有些版本可能没有自动启动。如果SSH连不上先在板子上确认sudo systemctl status ssh如果显示未启动执行sudo systemctl start ssh sudo systemctl enable ssh然后在电脑上连接ssh orangepi192.168.1.100首次连接会提示确认主机指纹输入yes继续然后输入密码。连上之后建议立即配置SSH密钥登录避免每次输密码。4.3 SSH密钥配置与免密登录在电脑上生成密钥对如果还没有的话ssh-keygen -t ed25519 -C orangepi然后把公钥复制到板子上ssh-copy-id orangepi192.168.1.100完成后就可以免密登录了。密钥登录不仅方便安全性也比密码登录高。配置完成后建议在板子上修改SSH配置禁用密码登录sudo nano /etc/ssh/sshd_config找到PasswordAuthentication yes改成PasswordAuthentication no然后重启SSH服务sudo systemctl restart ssh注意禁用密码登录之前务必确认密钥登录已经生效否则可能把自己锁在外面。建议先开一个已经连上的SSH会话不要关另开一个窗口测试密钥登录确认没问题再禁用密码。4.4 常见SSH连接问题排查SSH连不上是最常见的问题我整理了一个排查表现象可能原因解决方法Connection refusedSSH服务未启动板子上执行sudo systemctl start sshConnection timed out网络不通或IP错误确认IP地址检查网线/WiFiPermission denied用户名或密码错误确认默认用户名密码检查大小写Host key verification failed主机指纹变了删除~/.ssh/known_hosts中对应条目连接后立即断开电源供电不足换5V/4A电源适配器电源问题导致的SSH断连特别隐蔽因为看起来像是网络问题。我遇到过SSH连上后几秒钟就断换了电源就好了。所以如果SSH连接不稳定先排除电源因素。5. 首次使用后的基础配置与优化5.1 系统基础环境配置SSH通了之后建议把基础环境配好为后续部署YOLOv5s做准备。首先是换软件源国内用户建议换成清华源或者阿里源下载速度会快很多。Ubuntu 22.04的源配置文件在/etc/apt/sources.list替换成国内源之后执行sudo apt update。然后是安装常用工具sudo apt install -y git cmake build-essential python3-pip python3-dev这些工具在后续编译RKNN相关库和部署YOLOv5s时都会用到。Python版本方面Ubuntu 22.04自带Python 3.10这个版本跑YOLOv5s没问题。5.2 中文输入法与显示配置如果你用的是Desktop版镜像可能需要配置中文输入法和中文显示。Ubuntu下常用的中文输入法是搜狗输入法或者fcitx5。安装搜狗输入法的步骤稍微繁琐一些需要先安装fcitx框架再安装搜狗输入法deb包最后配置环境变量。不过对于做YOLOv5s部署来说中文输入法不是必须的因为大部分操作都在终端里完成。如果你确实需要建议用fcitx5加拼音方案比搜狗更轻量兼容性也更好。中文显示方面如果终端里中文显示为方块安装中文字体sudo apt install -y fonts-noto-cjk5.3 性能与散热注意事项RK3588满负荷运行时发热量不小特别是后续跑YOLOv5s推理的时候。首次使用阶段建议先确认散热方案官方散热风扇或者散热片至少装一个。我实测过不加散热片跑满载芯片温度能到80度以上会触发降频。查看CPU温度的指令cat /sys/class/thermal/thermal_zone0/temp返回值除以1000就是摄氏度。待机温度一般在40-50度满载70度以内算正常。如果待机就超过60度检查散热片是否贴紧或者考虑换更好的散热方案。6. 常见问题与排查技巧实录6.1 系统启动类问题问题一上电后HDMI无输出电源灯亮但系统不启动。这种情况先检查TF卡是否插紧然后确认烧录的镜像是否对应香橙派5。如果镜像没问题尝试用串口看启动日志。我遇到过TF卡接触不良导致启动失败重新插拔就好了。另外有些TF卡在香橙派上兼容性不好换一张卡试试。问题二系统启动后反复重启。大概率是电源功率不够。香橙派5需要5V/4A用手机充电器或者电脑USB口供电经常会出现这个问题。换官方电源或者确认输出功率足够的充电器。问题三启动卡在文件系统检查阶段。TF卡有坏块或者烧录不完整。重新烧录镜像如果还是不行就换卡。建议用balenaEtcher烧录它自带校验功能能发现烧录错误。6.2 网络与SSH类问题问题四SSH连接不稳定经常断开。先排除电源问题然后检查网络。如果用的是WiFi信号强度可能不够建议换有线连接。另外有些路由器会定期清理空闲连接可以在SSH配置里加上ServerAliveInterval 60让客户端定期发送心跳包。问题五SSH密钥登录配置后仍然提示输入密码。检查~/.ssh目录权限必须是700authorized_keys文件权限必须是600。权限不对SSH会忽略密钥。另外确认公钥内容完整复制到了authorized_keys文件里没有换行或者截断。问题六通过SSH运行的服务在断开连接后停止。这是因为服务没有以守护进程方式运行。解决方法是用nohup或者screen/tmux。比如跑YOLOv5s推理脚本时用tmux开一个会话断开SSH后脚本继续运行。这个技巧在后续部署阶段非常实用。6.3 首次使用避坑清单根据我自己的踩坑经验整理了几条首次使用时容易忽略的点不要用电脑USB口给香橙派供电功率不够会出现各种奇怪问题TF卡买好一点的杂牌卡不仅慢还可能出现数据损坏首次启动前先配置好WiFi否则Server版系统启动后没有网络会很被动SSH密钥登录配好之后再禁用密码登录顺序不能反散热片或者风扇首次使用就装上不要等过热降频了才加系统首次apt upgrade后重启一次确保内核更新生效7. 为后续YOLOv5s部署做的准备首次使用阶段把系统跑通、SSH连上之后下一步就是部署YOLOv5s。在进入那个阶段之前有几件事可以提前做确认NPU驱动是否正常加载。RK3588的NPU需要通过RKNN工具链来调用首次使用阶段可以先检查内核模块lsmod | grep rknpu如果有输出说明NPU驱动已经加载。如果没有可能需要更新内核或者手动加载模块。另外Python环境建议用虚拟环境管理避免污染系统Python。安装python3-venv之后创建虚拟环境python3 -m venv yolov5-env source yolov5-env/bin/activate后续安装RKNN Toolkit和YOLOv5相关依赖都在这个虚拟环境里进行系统升级或者重装时不会影响已有配置。存储空间方面YOLOv5s的模型文件加上RKNN转换工具大概需要2-3GB空间。如果TF卡是32GB系统占掉一部分之后剩余空间足够。但如果要存数据集或者多个模型版本建议用64GB以上的卡或者外接USB存储。我在实际使用中的体会是首次使用阶段花时间把基础环境搭稳后面部署模型会顺畅很多。特别是SSH密钥登录和tmux这两个东西看起来是小事但每天都要用配好了能省不少时间。另外电源和散热这两个硬件层面的问题很多人容易忽略但恰恰是导致“板子不稳定”的主要原因。把这两点解决好香橙派5跑YOLOv5s的体验会好很多。