1. 开箱之后先别急着上电香橙派RK3588首次使用的整体思路拿到香橙派RK3588这块板子的时候很多人第一反应是赶紧插电看看能不能亮。我当初也是这个心态结果因为没做任何准备连系统都没烧录就上电屏幕黑着指示灯亮着心里慌得不行。所以这篇内容的核心就是帮你把“首次使用”这件事从头到尾走一遍把该踩的坑提前填平。香橙派RK3588本质上是一台卡片大小的ARM架构计算机搭载瑞芯微RK3588芯片八核CPU4个A76大核4个A55小核内置NPU算力6TOPS拿来跑yolov5s这类轻量目标检测模型非常合适。但前提是你得先让它跑起来能联网、能远程登录、能装软件后面才能谈部署模型的事。首次使用的完整链路其实就四步系统镜像烧录到存储介质、板子启动并完成初始配置、打通SSH远程连接、配好基础开发环境。这四步里任何一步出问题后面都进行不下去。我见过太多人卡在第一步——烧录工具选错、镜像下错、TF卡质量不行折腾一整天连系统都没进去。这篇内容适合谁看如果你刚拿到香橙派RK3588或者香橙派5系列之前没接触过ARM开发板或者玩过树莓派但没碰过RK3588平台那这篇就是写给你的。我会把每个步骤的操作意图、参数选择理由、常见报错和排查方法都讲清楚让你少走弯路。提示首次使用建议先用TF卡烧录系统不要一上来就折腾eMMC或NVMe SSD。TF卡烧坏了换一张就行eMMC烧坏了修复起来麻烦得多。2. 系统镜像的选择与烧录第一步走稳后面才顺2.1 该选哪个Ubuntu版本香橙派官方为RK3588系列提供了多个系统镜像包括Ubuntu 20.04、Ubuntu 22.04、Debian 11等。很多人纠结选哪个我的建议很直接如果你后面要部署yolov5s或者yolov8优先选Ubuntu 22.04。原因有三个一是22.04的Python版本是3.10对主流深度学习工具链兼容性更好二是官方对22.04的驱动支持更新更及时三是社区里关于RK3588Ubuntu 22.04的教程和问题解答最多遇到坑容易搜到答案。Ubuntu 20.04也不是不能用但它的Python 3.8在一些新版本的pip包上会碰到兼容性问题比如某些onnxruntime的预编译轮子只提供Python 3.9以上的版本。当然如果你有特定需求必须用20.04那也没问题后面手动编译安装就行只是多花点时间。镜像文件从香橙派官网下载注意区分“桌面版”和“服务器版”。桌面版带图形界面适合调试和可视化操作服务器版没有图形界面资源占用低适合最终部署。我一般先用桌面版调试调通了再换服务器版做最终部署。但如果你一开始就打算SSH远程操作直接下服务器版也行省得后面再换。下载的时候注意核对文件大小和MD5值。我遇到过下载中断导致镜像文件不完整的情况烧录进去系统起不来排查了半天才发现是镜像本身的问题。官网一般会提供MD5校验值下载完用md5sum命令对一下几秒钟的事能省掉几小时的排查。2.2 烧录工具的选择与实操烧录工具用balenaEtcher或者RKDevTool。这两个工具适用场景不同balenaEtcher适合把镜像烧录到TF卡操作简单图形化界面选镜像、选TF卡、点烧录三步搞定RKDevTool是瑞芯微官方的工具适合通过USB线把镜像烧录到eMMC或直接烧录到板载存储操作稍微复杂一点但功能更强。首次使用我强烈建议用balenaEtcher烧录到TF卡。TF卡建议用Class 10以上、容量16GB起步的卡品牌选闪迪、三星、金士顿都行。别用杂牌卡读写速度慢不说还容易出现烧录后无法启动的问题。我有一次图便宜买了张不知名品牌的32GB卡烧录过程没问题但板子启动到一半就卡死换回闪迪的卡立刻正常。烧录步骤不复杂但有几个细节要注意下载balenaEtcher后安装打开软件点击“Flash from file”选择下载好的镜像文件通常是.img.xz格式Etcher会自动解压。插入TF卡点击“Select target”选中TF卡对应的盘符。千万注意别选错盘选成电脑硬盘就麻烦了。点击“Flash”开始烧录等待进度条走完。烧录完成后Etcher会自动校验校验通过才算真正完成。烧录完成后Windows可能会弹出“需要格式化磁盘”的提示直接关掉不要格式化。这是因为Windows不认识Linux的分区格式格式化会把刚烧录的系统毁掉。注意烧录完成后如果TF卡在Windows下显示为“未分配空间”或弹出格式化提示这是正常现象直接拔卡插到板子上就行。2.3 首次上电与启动观察TF卡烧录好之后插到香橙派RK3588的TF卡槽里。注意板子上可能有多个存储接口TF卡槽通常标注为“TF”或“MicroSD”别插错到其他槽位。上电之前先确认几件事HDMI线接好如果用桌面版、网线接好如果用有线网络、电源适配器规格对。RK3588开发板一般需要5V/4A以上的电源用手机充电器那种5V/2A的可能带不动表现为启动过程中反复重启或者根本起不来。我一开始用了个旧充电器板子灯亮但HDMI没输出换了官方推荐的电源立刻正常。上电后观察指示灯红色电源灯常亮表示供电正常绿色或蓝色灯闪烁表示系统正在启动。如果绿灯一直不闪可能是TF卡没插好或者镜像烧录有问题。HDMI接显示器的话正常启动后几十秒内会看到Ubuntu的启动日志和登录界面。首次启动系统会自动扩展文件系统、生成SSH密钥等这个过程可能需要一两分钟耐心等。启动完成后桌面版会进入图形登录界面默认用户名和密码一般是orangepi/orangepi具体看官方文档说明。3. 打通SSH远程连接让板子脱离显示器独立工作3.1 为什么一定要用SSH香橙派RK3588最终是要拿来跑yolov5s推理的你不可能一直给它接个显示器当台式机用。SSH远程连接是开发板最核心的使用方式让你在电脑上通过终端操作板子传文件、跑命令、看日志都方便。而且SSH连接打通之后板子可以放在任何有网络的地方你坐在电脑前就能操作不用来回插拔HDMI线和键盘鼠标。对于后面部署模型、调试代码来说SSH是基础设施级别的东西必须先搞定。3.2 有线网络直连与IP发现最稳妥的方式是用网线把香橙派和路由器连起来。板子启动后会自动通过DHCP获取IP地址。问题是你怎么知道它获取到了什么IP几种方法一是登录路由器管理后台在“已连接设备”列表里找香橙派对应的设备名通常显示为orangepi或rk3588二是用nmap扫描局域网网段比如nmap -sn 192.168.1.0/24找到新增的设备IP三是如果板子接了显示器直接在终端里运行ip addr或ifconfig查看。我一般用第二种方法因为路由器后台有时候设备名显示不直观而nmap扫描结果里能看到MAC地址前缀香橙派的MAC地址前缀是固定的一眼就能认出来。如果你没有路由器也可以用网线把香橙派和电脑直连。这时候需要手动给电脑网卡配一个同网段的静态IP比如电脑配192.168.1.100板子默认可能是192.168.1.1或者需要手动设置。这种方式适合临时调试长期用还是接路由器方便。3.3 SSH连接实操与常见报错知道IP之后在电脑终端里运行ssh orangepi192.168.1.xxx第一次连接会提示确认主机指纹输入yes回车然后输入密码。默认密码通常是orangepi登录成功后你就进入了香橙派的命令行界面。如果连接失败按以下顺序排查报错信息可能原因解决方法Connection refusedSSH服务未启动板子上运行sudo systemctl start sshConnection timed outIP不对或网络不通确认IP、ping一下板子Permission denied用户名或密码错误确认用户名默认密码尝试orangepiHost key verification failed主机指纹变了删除~/.ssh/known_hosts中对应条目我遇到过最坑的一种情况是板子明明获取到了IPping也能通但SSH就是连不上。后来发现是系统首次启动时SSH服务没有自动启动需要在板子上手动开启。如果你也碰到这种情况接显示器登录板子运行sudo systemctl enable ssh sudo systemctl start ssh之后就能正常连接了。提示建议首次SSH连接成功后立刻修改默认密码运行passwd命令按提示操作。开发板默认密码是公开的不改的话局域网内任何人都能登录。3.4 配置SSH免密登录提升效率每次SSH都要输密码很烦配个免密登录能省不少事。原理是在电脑上生成一对密钥把公钥放到板子的~/.ssh/authorized_keys文件里之后连接时板子用公钥验证电脑身份不需要再输密码。操作步骤在电脑上运行ssh-keygen -t rsa -b 4096一路回车生成密钥对。运行ssh-copy-id orangepi192.168.1.xxx输入一次密码公钥自动复制到板子上。之后ssh orangepi192.168.1.xxx直接登录不再需要密码。如果你用VSCode做远程开发配好免密登录后VSCode的Remote-SSH插件也能直接连编辑板子上的代码就像编辑本地文件一样方便。这个后面部署yolov5s的时候会大量用到。4. 基础环境配置为后续部署yolov5s铺路4.1 系统更新与换源首次SSH登录成功后第一件事是更新软件源和已安装的包。Ubuntu默认的官方源在国内访问速度可能不理想建议换成国内镜像源。编辑/etc/apt/sources.list文件把里面的archive.ubuntu.com和security.ubuntu.com替换成国内镜像地址。换源之后运行sudo apt update sudo apt upgrade -y这个过程可能需要几分钟到十几分钟取决于网络速度和更新包的数量。更新完成后建议重启一次sudo reboot。注意apt upgrade过程中如果提示某些配置文件有冲突一般选择保留当前版本即可。除非你明确知道新版本配置更好否则不要轻易覆盖。4.2 安装常用工具链系统更新完之后装一批后续开发必备的工具sudo apt install -y build-essential cmake git wget curl vim htop net-tools这几个包的作用分别是build-essential提供gcc、g、make等编译工具cmake是跨平台构建工具后面编译一些库会用到git用于拉取代码仓库wget和curl用于下载文件vim是终端编辑器htop看系统资源占用net-tools提供ifconfig等网络命令。如果你后面要跑yolov5sPython环境也需要提前配好。Ubuntu 22.04自带Python 3.10但pip可能需要手动安装sudo apt install -y python3-pip python3-dev python3-venv装完之后用python3 --version和pip3 --version确认版本。4.3 配置中文环境与输入法如果你用桌面版可能需要中文输入法。Ubuntu下常用的中文输入法框架是fcitx配合搜狗输入法或谷歌拼音。安装步骤sudo apt install -y fcitx fcitx-googlepinyin装完后在“语言支持”设置里把键盘输入法系统切换为fcitx重启后生效。然后在fcitx配置里添加谷歌拼音输入法。不过说实话如果你主要用SSH远程操作中文输入法不是必须的。板子上大部分操作都是命令行不需要输入中文。桌面版调试阶段可能用得上最终部署用服务器版的话完全不需要。4.4 文件传输电脑与板子互传文件开发过程中经常需要在电脑和板子之间传文件。除了scp命令还有几种方式scp是最基础的比如把本地文件传到板子scp local_file.py orangepi192.168.1.xxx:/home/orangepi/从板子下载文件到本地scp orangepi192.168.1.xxx:/home/orangepi/result.txt ./如果文件多或者目录大可以用rsync支持断点续传和增量同步rsync -avz --progress local_dir/ orangepi192.168.1.xxx:/home/orangepi/remote_dir/VSCode的Remote-SSH插件也支持拖拽上传下载文件图形化操作更直观。我平时写代码用VSCode远程编辑传大文件用rsync小文件直接scp基本覆盖所有场景。5. 常见问题与排查技巧实录5.1 板子启动不了怎么办启动不了分几种情况完全没反应灯不亮、灯亮但无输出、启动到一半卡死。完全没反应先检查电源。RK3588开发板对供电要求比较高5V/4A是基本要求有些板子甚至需要5V/5A。用万用表量一下电源适配器实际输出电压有些标称5V的充电器带载后电压掉到4.5V以下板子就起不来。灯亮但HDMI无输出先确认HDMI线没问题、显示器输入源选对了。然后检查TF卡是否插紧、镜像是否烧录正确。可以换一张卡重新烧录试试。启动到一半卡死大概率是TF卡质量问题或者镜像损坏。重新下载镜像、换卡烧录。如果换了卡还是卡死可能是板子硬件问题联系售后。5.2 SSH连不上排查清单SSH连不上是最常见的问题我整理了一个排查顺序板子是否正常启动接显示器确认系统起来了。网络是否通电脑上ping 板子IP看是否响应。SSH服务是否运行板子上systemctl status ssh查看。防火墙是否拦截sudo ufw status查看必要时sudo ufw disable临时关闭。用户名密码是否正确默认一般是orangepi/orangepi。是否在同一网段电脑IP和板子IP前三段要一致。按这个顺序走一遍基本能定位到问题。5.3 系统时间不对导致的问题ARM开发板没有板载RTC电池的话断电后系统时间会丢失启动后时间可能回到1970年。这会导致apt update时报证书错误、git操作失败等问题。解决方法联网后运行sudo ntpdate ntp.aliyun.com同步时间或者启用systemd-timesyncd服务自动同步sudo timedatectl set-ntp true如果板子有RTC电池接口可以装个纽扣电池断电后时间也能保持。5.4 存储空间不足的处理TF卡容量小的话装完系统更新几个工具包可能就满了。用df -h查看空间占用。如果不够用几种方案换大容量TF卡、外接USB存储、或者用NVMe SSD如果板子支持。香橙派RK3588一般有M.2接口可以装NVMe SSD。把系统和数据放在SSD上速度和容量都比TF卡好很多。但首次使用建议先用TF卡把系统跑通再折腾SSD启动。5.5 常见问题速查表问题现象可能原因快速解决上电无反应电源功率不足换5V/4A以上电源HDMI无输出镜像问题或TF卡故障重新烧录或换卡SSH拒绝连接SSH服务未启动板子上启动ssh服务apt更新报错系统时间不对同步NTP时间磁盘空间满TF卡容量小清理或换大卡网络时通时断网线或接口问题换网线换接口6. 首次使用完成后的检查清单走到这里你的香橙派RK3588应该已经能正常启动、SSH远程登录、联网更新、装软件了。在进入下一步部署yolov5s之前花两分钟确认以下事项系统能正常启动SSH能稳定连接默认密码已修改系统时间已同步软件源已更新apt update无报错Python3和pip3可用电脑与板子之间能互传文件板子能正常访问外网这几项都OK的话基础环境就算搭好了。后面部署yolov5s的时候还需要装NPU驱动、RKNN工具链、Python虚拟环境等那些属于下一阶段的内容。我个人在实际操作中的体会是首次使用阶段最耗时的不是操作本身而是排查各种意外问题。电源不对、TF卡质量差、镜像下载不完整、SSH服务没启动这些坑我几乎都踩过一遍。所以建议你每一步都按上面的检查点确认一遍再往下走看起来多花了几分钟实际上省掉的是后面几小时的排查时间。最后分享一个小技巧首次配置完成后用sudo dd if/dev/mmcblk0 ofbackup.img bs4M statusprogress把整张TF卡备份成镜像文件存到电脑上。后面如果系统玩坏了直接烧录备份镜像就能恢复到当前状态不用从头再配一遍。这个习惯在折腾开发板的时候特别有用尤其是后面装NPU驱动、编译工具链这些容易搞崩系统的操作之前备份一次能救命。