1. 开箱之后先别急着上电香橙派RK3588首次使用的整体思路拿到香橙派5或者香橙派5 Pro的那一刻大多数人的第一反应是插电、接屏、开机。我当初也是这么干的结果就是对着一个黑屏或者一个不知道密码的登录界面发呆。香橙派RK3588这块板子跟树莓派最大的区别在于它出厂自带的系统往往是一个最简化的镜像很多我们习以为常的东西——比如桌面环境、SSH服务、中文输入法——都需要自己动手补上。所以这篇内容的核心思路就是一条主线先让板子能稳定跑起来再让它能被远程访问最后为后续部署yolov5s模型打好系统基础。为什么是这个顺序因为如果你一上来就想着跑模型结果发现系统都没配好SSH连不上文件传不进去那后面的每一步都是死胡同。我踩过最典型的坑就是板子烧录了一个不带桌面环境的Ubuntu镜像开机后只有命令行想装个图形界面又发现网络配置有问题最后只能重新烧录。所以首次使用的核心目标不是“跑通什么大项目”而是建立一个可靠、可远程、可复现的基础环境。这篇文章适合谁看如果你手里正好有一块香橙派RK3588系列的板子不管是5还是5 Pro准备用它来做yolov5s或者yolov8的边缘部署但卡在了“第一次开机之后不知道干什么”这一步那接下来的内容就是为你准备的。我会从镜像选择、烧录、首次开机配置、SSH远程连接、基础环境搭建这几个环节把每一步的操作意图和容易翻车的地方都讲清楚。整个过程不需要你有Linux大神级别的经验但需要你愿意动手敲命令。2. 镜像选择与烧录别让第一步就埋雷2.1 官方镜像和第三方镜像怎么选香橙派RK3588的镜像来源主要有两个渠道一是香橙派官网提供的官方镜像二是社区维护的第三方镜像。官方镜像的优势是硬件适配最完整尤其是NPU驱动、GPU驱动这些跟RK3588芯片强相关的部分官方镜像通常已经预装好了。第三方镜像有时候会集成更多软件包但硬件兼容性参差不齐我遇到过第三方Ubuntu镜像WiFi模块无法识别的情况。具体到版本选择目前比较稳妥的是Ubuntu 20.04 LTS和Ubuntu 22.04 LTS这两个长期支持版本。20.04的优势是生态成熟很多RK3588的NPU工具链比如RKNN-Toolkit2对它的支持最完善22.04的优势是软件包更新但部分驱动可能需要手动编译。如果你后续要部署yolov5s并做模型量化转换我建议优先选20.04因为RKNN的官方文档和社区案例大多是基于这个版本验证的。注意下载镜像时一定要确认对应的是香橙派5还是5 Pro虽然都是RK3588/RK3588S芯片但外设接口和设备树配置有差异烧错镜像可能导致部分接口无法工作。2.2 烧录工具和存储介质的选择烧录工具方面Windows下常用的是balenaEtcher和RKDevToolLinux下可以直接用dd命令。balenaEtcher的好处是图形化、操作简单适合新手RKDevTool则是瑞芯微官方的工具支持分区烧录和固件升级功能更强但界面相对复杂。我个人的习惯是首次烧录用balenaEtcher把镜像写到TF卡后续如果需要更新固件再用RKDevTool通过USB线烧录到eMMC。存储介质的选择上TF卡和eMMC各有优劣。TF卡的好处是烧录方便、可以随时更换缺点是读写速度受卡的质量影响很大劣质卡会导致系统卡顿甚至启动失败。eMMC的读写速度稳定适合长期运行但烧录需要USB连接和专用工具。如果你只是做开发和测试先用TF卡跑起来是最快的路径如果准备做产品原型或者长期运行的边缘设备建议把系统烧到eMMC。TF卡的选择有个硬指标Class 10以上UHS-I标准容量至少32GB。我实测过用一张杂牌16GB的卡系统启动花了将近三分钟换成三星的32GB UHS-I卡之后启动时间降到40秒左右。这个差距在后续编译代码、加载模型的时候会更明显。2.3 烧录过程中的关键细节烧录本身的操作不复杂但有几个细节容易忽略。第一烧录完成后Windows可能会弹出“是否格式化”的提示千万不要点格式化因为TF卡上现在有多个Linux分区Windows识别不了就会问你要不要格式化点了就把系统分区破坏了。第二烧录完成后不要急着拔卡等balenaEtcher提示“Flash Complete”并且校验通过之后再拔。如果你用的是RKDevTool烧录到eMMC需要先把板子进入MaskROM模式或者Loader模式。具体操作是按住板子上的Recovery按键然后插入电源或者USB线等待RKDevTool识别到设备后松开按键。这个步骤不同批次的板子按键位置可能不同建议对照香橙派官方的用户手册确认。3. 首次开机从黑屏到能用的系统3.1 开机前的硬件连接检查在插电之前有几件事必须确认。首先是散热RK3588这颗芯片的性能很强但发热也不含糊。如果你买的是带散热风扇的套餐先把风扇接好如果是裸板至少贴一个散热片。我在没有散热措施的情况下跑了一次系统更新芯片温度直接飙到80度以上系统开始降频操作明显卡顿。其次是电源RK3588需要5V/4A以上的供电用普通的手机充电器5V/2A可能会导致系统不稳定表现为随机重启或者USB设备识别失败。香橙派官方的电源适配器是最稳妥的选择如果自己配注意看电源接口的规格Type-C还是DC圆口以及电压电流是否达标。显示输出方面香橙派5系列通常有HDMI输出部分型号还有Type-C DP输出。如果你用的是HDMI转VGA的老显示器可能会遇到分辨率不匹配的问题建议直接用HDMI显示器或者通过串口调试。串口调试是更专业的方式通过USB转TTL模块连接板子的调试串口可以在没有显示器和网络的情况下看到系统启动日志排查问题非常方便。3.2 首次启动的登录与初始配置烧录好系统、插上电源之后系统会自动启动。首次启动的时间会比后续启动长因为系统需要扩展文件系统、初始化各种服务。如果你接的是HDMI显示器等待一两分钟后应该能看到登录界面或者桌面环境。香橙派官方Ubuntu镜像的默认用户名和密码通常是orangepi/orangepi部分版本可能是root/orangepi。如果你烧录的是不带桌面的服务器版镜像启动后直接就是命令行登录界面。登录成功后的第一件事是修改默认密码这是基本的安全习惯。接下来要做的是扩展文件系统。虽然很多镜像在首次启动时会自动扩展但有些版本需要手动执行。可以用df -h命令查看根分区的可用空间如果发现根分区只有几GB而TF卡是32GB那就需要手动扩展。香橙派通常提供了一个orangepi-config工具里面有一项“Expand Filesystem”可以一键扩展。如果没有这个工具可以用resize2fs命令手动操作。3.3 网络配置有线还是无线网络是后续所有操作的基础。香橙派5系列通常带有一个千兆以太网口和WiFi模块。有线网络的稳定性最好插上网线后系统一般会自动通过DHCP获取IP地址。可以用ip addr或者ifconfig命令查看是否获取到了IP。WiFi的配置稍微麻烦一点。如果是带桌面环境的镜像可以直接在图形界面里选择WiFi并输入密码。如果是命令行环境需要用nmcli或者修改/etc/netplan/下的配置文件。我一般用nmcli操作比较直观# 扫描可用WiFi nmcli dev wifi list # 连接WiFi nmcli dev wifi connect 你的WiFi名称 password 你的密码连接成功后同样用ip addr确认是否获取到了IP地址。记下这个IP后面SSH连接要用。提示如果你在的公司或学校网络需要网页认证香橙派这种没有图形界面的设备会比较麻烦。这种情况下建议先用手机热点测试确认板子网络功能正常后再处理认证问题。4. SSH远程连接让板子脱离显示器独立运行4.1 为什么SSH是RK3588开发的必备技能香橙派RK3588的典型使用场景是作为边缘计算设备放在某个角落跑模型推理而不是像台式机一样摆在桌面上。这就意味着你不可能一直给它接显示器、键盘、鼠标。SSHSecure Shell就是解决这个问题的核心工具——它让你通过网络从另一台电脑远程登录到板子的命令行执行所有操作。更重要的是后续部署yolov5s的过程中你需要频繁地在PC和板子之间传输文件模型文件、代码、配置文件SSH提供的SCP和SFTP功能可以让这个传输过程变得非常简单。另外像VSCode这样的编辑器支持通过SSH连接远程服务器你可以直接在PC上编辑板子上的代码体验接近本地开发。4.2 在香橙派上开启SSH服务大多数香橙派官方Ubuntu镜像默认已经安装了SSH服务但可能没有设置为开机自启。登录板子后先检查SSH服务状态# 查看SSH服务状态 systemctl status ssh # 如果没有安装先安装 sudo apt update sudo apt install openssh-server # 设置开机自启并启动 sudo systemctl enable ssh sudo systemctl start ssh确认SSH服务运行后还需要检查防火墙设置。Ubuntu默认的ufw防火墙可能没有放行SSH端口默认22端口# 查看防火墙状态 sudo ufw status # 如果防火墙是开启的放行SSH sudo ufw allow ssh4.3 从PC端连接香橙派Windows下常用的SSH客户端有PuTTY、MobaXterm和Windows Terminal自带的ssh命令。我个人推荐MobaXterm因为它同时集成了SSH终端和SFTP文件传输一个软件搞定所有操作。Mac和Linux用户直接打开终端用ssh命令即可。连接命令的格式是ssh 用户名板子的IP地址 # 例如 ssh orangepi192.168.1.100首次连接会提示确认主机指纹输入yes后回车然后输入密码即可登录。登录成功后你就拥有了一个和板子本地终端完全一样的命令行环境。4.4 SSH免密登录和文件传输每次连接都输密码比较麻烦可以配置SSH密钥免密登录。在PC上生成密钥对如果还没有的话# 生成密钥对 ssh-keygen -t rsa -b 4096 # 将公钥复制到板子 ssh-copy-id orangepi192.168.1.100配置完成后再次ssh连接就不需要输密码了。文件传输方面用scp命令可以方便地在PC和板子之间拷贝文件# 从PC拷贝文件到板子 scp ./yolov5s.pt orangepi192.168.1.100:/home/orangepi/ # 从板子拷贝文件到PC scp orangepi192.168.1.100:/home/orangepi/result.jpg ./如果你用VSCode安装Remote-SSH插件后可以直接连接板子在VSCode里打开板子上的文件夹进行编辑代码补全、语法高亮都能正常使用体验非常好。注意SSH连接不上的时候先检查板子和PC是否在同一个网段然后确认板子的SSH服务是否运行最后检查防火墙规则。这三个环节排查下来90%的连接问题都能解决。5. 基础环境搭建为yolov5s部署做准备5.1 系统更新与常用工具安装板子能远程访问之后下一步是把系统更新到最新状态并安装一些后续会用到的工具。系统更新用标准的apt命令sudo apt update sudo apt upgrade -y这个过程可能需要几分钟到十几分钟取决于网络速度和更新包的数量。更新完成后安装一些基础工具sudo apt install -y build-essential cmake git wget curl vim htop这些工具的作用分别是build-essential提供gcc、g、make等编译工具cmake用于构建项目git用于拉取代码仓库wget和curl用于下载文件vim是命令行编辑器htop用于查看系统资源占用。后续编译RKNN工具链、转换模型的时候这些工具都会用到。5.2 Python环境配置yolov5s的部署离不开Python环境。Ubuntu 20.04默认自带Python 3.822.04自带Python 3.10。先确认Python版本python3 --version pip3 --version如果pip3没有安装用sudo apt install python3-pip安装。接下来建议安装虚拟环境工具避免不同项目的依赖冲突sudo apt install python3-venv python3 -m venv ~/yolov5_env source ~/yolov5_env/bin/activate虚拟环境激活后命令行提示符前面会出现(yolov5_env)的标识。后续安装的Python包都会在这个虚拟环境里不会影响系统自带的Python环境。5.3 中文输入法和时区设置如果你需要直接在板子上进行中文输入可以安装中文输入法。命令行环境下推荐fcitx配合fcitx-googlepinyinsudo apt install -y fcitx fcitx-googlepinyin安装完成后需要配置环境变量在~/.bashrc或者~/.profile中添加export GTK_IM_MODULEfcitx export QT_IM_MODULEfcitx export XMODIFIERSimfcitx时区设置也很重要默认可能是UTC时间导致日志时间戳和本地时间对不上sudo timedatectl set-timezone Asia/Shanghai5.4 常见环境问题排查在环境搭建过程中有几个高频问题值得提前说明。第一个是apt更新速度慢这是因为默认的软件源在国外。可以替换为国内镜像源编辑/etc/apt/sources.list把archive.ubuntu.com替换为mirrors.aliyun.com或者mirrors.tuna.tsinghua.edu.cn。替换后执行sudo apt update刷新缓存。第二个是pip安装包超时同样可以通过配置国内pip源解决pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple第三个是磁盘空间不足如果你用的是16GB的TF卡系统更新和安装工具之后可能就剩不下多少空间了。用df -h查看剩余空间如果紧张可以清理apt缓存sudo apt clean sudo apt autoremove -y6. 常见问题与排查技巧实录6.1 开机无显示或卡在启动界面这是最常见的问题之一。排查思路按优先级排列首先确认电源是否达标用万用表量一下电压是否稳定在5V以上其次确认HDMI线缆和显示器是否正常工作可以换一根线或者换一个显示器测试然后检查TF卡是否插紧有时候卡没插到位会导致启动失败最后考虑镜像是否烧录正确重新烧录一次排除镜像损坏的可能。如果以上都排除了还是不行就需要用串口调试。通过USB转TTL模块连接板子的调试串口通常是UART0波特率设为1500000可以在PC上看到完整的启动日志根据日志中的错误信息定位问题。6.2 SSH连接被拒绝或超时SSH连不上的原因有很多按以下顺序排查确认板子是否正常启动并获取到了IP地址通过显示器或者串口查看确认PC和板子是否在同一网段互相ping一下确认板子的SSH服务是否运行systemctl status ssh确认防火墙是否放行了22端口确认SSH配置文件/etc/ssh/sshd_config中PermitRootLogin和PasswordAuthentication的设置是否符合你的登录方式。如果之前能连上突然连不上了可能是板子的IP地址变了DHCP租约到期后重新分配。这种情况下可以在路由器管理界面查看板子的新IP或者给板子配置静态IP。6.3 系统时间不正确导致的问题系统时间不对会导致很多奇怪的问题比如apt更新时报证书错误、编译代码时报时间戳警告、日志时间混乱等。除了前面提到的设置时区还需要确认系统时间是否同步。可以安装NTP服务sudo apt install -y ntp sudo systemctl enable ntp sudo systemctl start ntp如果板子没有网络可以手动设置时间sudo date -s 2025-01-01 12:00:006.4 常见问题速查表问题现象可能原因排查方法解决方案开机黑屏电源不足测量电压更换5V/4A以上电源开机黑屏镜像损坏重新烧录用balenaEtcher重新烧录系统卡顿TF卡速度慢测试读写速度更换Class 10以上TF卡SSH连不上IP地址变化查看路由器配置静态IPSSH连不上服务未启动systemctl status ssh启动并设置开机自启apt更新慢源在国外查看sources.list替换国内镜像源pip安装超时源在国外查看pip配置配置国内pip源磁盘空间不足缓存未清理df -hapt clean和autoremove中文乱码未安装中文字体locale命令安装中文字体和输入法时间不对时区未设置timedatectl设置Asia/Shanghai时区7. 首次使用后的系统备份与恢复7.1 为什么要做系统备份系统配置好之后建议做一次完整的备份。原因很简单后续部署yolov5s的过程中你可能会安装各种依赖、修改系统配置、编译内核模块万一某个操作把系统搞崩了重新从头配置一遍非常耗时。有了备份直接恢复镜像就能回到一个干净可用的状态。7.2 备份方法如果系统烧录在TF卡上备份最简单的方式是在PC上用dd命令或者balenaEtcher的“Read”功能把整张卡读成镜像文件。Linux下用dd# 查看TF卡设备名 lsblk # 备份镜像假设TF卡是/dev/sdb sudo dd if/dev/sdb of~/orangepi_backup.img bs4M statusprogress备份出来的镜像文件可以压缩保存节省空间gzip ~/orangepi_backup.img恢复的时候把镜像写回TF卡即可。如果系统烧录在eMMC上可以用RKDevTool的“导出固件”功能备份。7.3 备份策略建议我的习惯是分阶段备份第一次是系统刚配置好网络和SSH之后备份一个“基础版”第二次是安装完RKNN工具链和Python环境之后备份一个“开发版”第三次是yolov5s模型部署成功之后备份一个“生产版”。这样出问题的时候可以根据需要恢复到不同的阶段不用每次都从头来。8. 从首次使用到yolov5s部署的衔接系统配好、SSH能连、基础环境就绪之后下一步就是部署yolov5s模型了。这里简单说一下衔接点yolov5s在RK3588上的部署通常需要把PyTorch模型转换为ONNX格式再通过RKNN-Toolkit2转换为RKNN格式最后用RKNPU2的运行时库在板子上加载推理。这个过程中板子上需要安装RKNN的运行时库PC上需要安装RKNN-Toolkit2做模型转换。板子端的运行时库安装、模型传输、推理代码编写这些内容会在后续的教程里展开。首次使用阶段把系统基础打好后续的每一步都会顺畅很多。我见过太多人卡在系统配置这一步就放弃了其实只要把网络、SSH、基础工具这三样搞定后面的路就宽了。最后分享一个我在实际使用中的小技巧给板子配一个静态IP。在路由器里绑定板子的MAC地址和固定IP这样每次重启后IP不变SSH连接、文件传输、VSCode远程开发都不用重新查IP。具体操作是在路由器的DHCP设置里找到板子的MAC地址添加一条静态绑定规则。如果没法操作路由器也可以在板子上手动配置静态IP编辑/etc/netplan/下的配置文件即可。这个小小的改动能省下很多重复操作的时间。