企业官网建设流程全解析

1. 开箱之后先别急着上电：香橙派RK3588首次使用的整体思路

拿到香橙派RK3588这块板子的时候，很多人第一反应是赶紧插电看看能不能亮。我当初也是这么干的，结果因为没提前准备系统镜像和启动卡，对着黑屏折腾了小半天。所以这篇内容我想把“首次使用”这件事讲透，从硬件确认、系统烧录、首次上电、网络配置到SSH远程登录，把每一步的坑都提前给你标出来。

香橙派RK3588是一块基于瑞芯微RK3588芯片的开发板，8核CPU（4个A76大核加4个A55小核），自带NPU算力，跑YOLOv5s这类目标检测模型做边缘推理非常合适。但这一切的前提是，你得先让板子正常跑起来一个Ubuntu系统，并且能通过网络远程连上去。否则每次调试都要接显示器、接键盘，效率低得让人抓狂。

这篇内容适合刚拿到香橙派RK3588、准备做AI视觉项目但还没摸清门路的朋友。不管你是从零开始的新手，还是玩过树莓派想换平台的老玩家，下面的流程和注意事项都能帮你少走弯路。我会按照“硬件检查→镜像烧录→首次启动→网络与SSH→系统基础配置”的顺序来讲，每一步都附带我实际踩过的坑和验证过的参数。

2. 硬件准备与系统镜像选择：别在第一步就卡住

2.1 必须提前备齐的硬件清单

香橙派RK3588的包装里通常只有一块板子，其他配件都得自己配。我整理了一份最小可用清单，缺一样都没法顺利走完首次启动流程：

• 电源适配器：官方推荐5V/4A的Type-C电源。这里要注意，RK3588满载功耗不低，如果你用手机充电器那种5V/2A的，板子可能反复重启或者根本起不来。我实测用某品牌65W氮化镓充电器（支持5V/3A档位）也能稳定跑，但前提是线材质量过关。
• MicroSD卡：至少32GB，Class 10以上速度等级。我推荐用A2级别的卡，因为系统跑在卡上时，随机读写性能直接影响体验。手头有闲置的64GB A2卡最好。
• 读卡器：用来把镜像写入SD卡，USB 3.0接口的读卡器能省不少等待时间。
• HDMI线+显示器：首次启动建议接显示器，方便观察启动日志和排查问题。等SSH配通了就可以拔掉。
• USB键盘鼠标：首次配置网络和账户时需要。
• 网线：一根普通千兆网线，用来把板子接入路由器。虽然香橙派RK3588自带WiFi模块，但首次配置有线网络更稳妥。

注意：不要用劣质电源线。我遇到过一根看起来正常的Type-C线，实际线阻过大导致板子供电不足，启动到一半就死机，换了根线立刻正常。这种问题排查起来非常费时间。

2.2 系统镜像怎么选：Ubuntu还是Debian

香橙派官方提供了多个系统镜像，包括Ubuntu 22.04、Debian 11等。对于要跑YOLOv5s的场景，我建议直接选Ubuntu 22.04 Server版或者Desktop版。原因有几个：

第一，Ubuntu 22.04的软件源里Python版本是3.10，和YOLOv5s的依赖兼容性最好。Debian 11默认Python 3.9，虽然也能跑，但某些pip包在安装时会有版本冲突。

第二，Ubuntu的社区文档和问题解答更丰富。你在配置过程中遇到任何报错，搜索“Ubuntu 22.04 + 报错关键词”基本都能找到答案。

第三，如果你后续要用RKNN Toolkit2来转换和部署YOLOv5s模型，官方文档和示例代码大多是在Ubuntu环境下验证的。

镜像下载渠道方面，去香橙派官网的下载页面找对应RK3588的镜像。注意区分“香橙派5”和“香橙派5 Pro”的镜像，虽然都是RK3588，但外设布局有差异，镜像不完全通用。下载时优先选带日期较新的版本，老版本可能缺少某些驱动修复。

2.3 镜像烧录工具与操作细节

烧录工具我用的是balenaEtcher，跨平台且操作简单。也有人用Rufus或者dd命令，但Etcher的校验功能能帮你确认写入是否完整，避免因为烧录失败导致的启动异常。

烧录步骤不复杂，但有几个细节值得注意：

1. 下载下来的镜像通常是.img.xz压缩格式，Etcher可以直接识别并解压写入，不需要手动解压。
2. 插入SD卡后，Etcher会自动识别目标设备。务必确认选中的是你的SD卡而不是电脑硬盘，我见过有人手滑选错盘导致数据丢失的。
3. 点击“Flash”后等待写入和校验完成。一张32GB的卡大概需要5到10分钟，取决于卡的速度和读卡器性能。
4. 写入完成后，如果Windows提示“需要格式化磁盘”，千万不要点格式化。这是因为Windows不认识Linux分区格式，点取消即可。

实操心得：烧录完成后，可以先不拔卡，在电脑上打开分区看看。正常情况下你会看到一个小分区（boot分区），里面有一些启动配置文件。如果这个分区都看不到，说明烧录有问题，重新烧一次。

3. 首次上电与系统初始化：从黑屏到桌面

3.1 上电顺序与启动观察

硬件连接顺序建议这样：先插好SD卡、网线、HDMI线、键盘鼠标，最后再接电源。这样做的原因是避免带电插拔SD卡导致数据损坏。

接上电源后，板子上的指示灯会亮起。RK3588的启动过程大概需要20到40秒，期间显示器上会滚动大量启动日志。如果你看到日志一直在滚但始终进不了系统，可能是镜像不匹配或者SD卡有问题。

首次启动时，系统会自动扩展文件系统到整张SD卡，然后重启一次。这是正常现象，不要以为出问题了。重启后会进入Ubuntu的初始配置界面，让你选择语言、时区、创建用户账户和密码。

3.2 初始配置中的关键选择

语言选择上，我建议选English。虽然选中文也能用，但后续在终端里操作时，中文 locale 有时会导致某些命令行工具输出乱码，排查问题反而麻烦。系统装好之后如果需要中文输入法，可以再单独配置。

时区选Asia/Shanghai，这样系统日志的时间戳和你本地时间一致，排查问题时不会混淆。

用户名和密码方面，建议设一个自己好记的。后续SSH登录、sudo提权都要用。密码不要太简单，因为板子接入网络后，SSH端口默认是开放的。

配置完成后系统会再次重启，这次应该能正常进入桌面环境（如果你烧的是Desktop版）。到这一步，说明系统已经跑起来了。

3.3 首次启动后必须做的三件事

进入系统后别急着装软件，先把下面三件事做了：

第一，更新软件源和系统包。打开终端，执行：

sudo apt update sudo apt upgrade -y

这个过程可能需要几分钟到十几分钟，取决于网络速度和软件包数量。更新完成后建议重启一次。

第二，检查网络连接。如果你插了网线，执行ip addr看看有没有分配到IP地址。正常情况下你会看到eth0或者enp开头的一个接口，后面跟着inet加IP地址。如果没有，检查网线是否插紧、路由器是否开启了DHCP。

第三，确认SSH服务已启动。Ubuntu Desktop版默认可能没装SSH服务，执行：

sudo apt install openssh-server -y sudo systemctl enable ssh sudo systemctl start ssh sudo systemctl status ssh

看到“active (running)”就说明SSH服务正常了。

4. 网络配置与SSH远程登录：摆脱显示器和键盘

4.1 有线网络与无线网络的取舍

首次配置我强烈建议用有线网络。原因很简单：有线网络稳定，不需要输入WiFi密码，也不会因为信号问题导致SSH断连。等你SSH能稳定连上之后，再去配置WiFi作为备用。

查看有线网络是否连通：

ip addr show

找到你的有线网卡接口名（通常是eth0或enp1s0），确认它有inet地址。然后测试外网连通性：

ping -c 4 www.baidu.com

如果能通，说明网络没问题。记下这个IP地址，后面SSH连接要用。

4.2 SSH连接前的准备工作

在电脑端，你需要一个SSH客户端。Windows用户可以用PowerShell自带的ssh命令，或者装一个MobaXterm、Xshell之类的工具。Mac用户直接用终端就行。

连接命令格式：

ssh 用户名@板子IP地址

比如你的用户名是orangepi，IP是192.168.1.100，那就执行：

ssh orangepi@192.168.1.100

首次连接会提示确认主机指纹，输入yes继续，然后输入密码。密码输入时终端不会显示任何字符，这是正常的安全机制，输完直接回车。

4.3 SSH认证失败的常见原因与排查

SSH连不上是新手最容易卡住的地方。我把常见问题整理成了一张速查表：

实操心得：如果你在板子上改了SSH端口或者配置了密钥登录，记得同步更新电脑端的连接配置。我有一次改了端口忘了同步，排查了半小时才发现问题。

4.4 配置SSH密钥登录：更安全更省事

密码登录每次都要输入，麻烦且不够安全。配置密钥登录后，电脑和板子之间可以免密连接。

在电脑上生成密钥对（如果还没有的话）：

ssh-keygen -t ed25519 -C "orangepi-rk3588"

一路回车即可。然后把公钥复制到板子上：

ssh-copy-id orangepi@192.168.1.100

输入一次密码后，公钥就写入板子的~/.ssh/authorized_keys文件了。之后再用ssh连接就不需要输密码了。

如果ssh-copy-id命令不可用，可以手动操作：在电脑上执行cat ~/.ssh/id_ed25519.pub，复制输出内容，然后在板子上执行：

mkdir -p ~/.ssh echo "粘贴公钥内容" >> ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys

4.5 固定IP地址：避免每次找IP的麻烦

路由器分配的IP地址可能会变，每次SSH连接前都要去板子上查IP很烦。可以在路由器里设置静态DHCP绑定，把板子的MAC地址和固定IP关联起来。或者直接在板子上配置静态IP。

Ubuntu 22.04使用netplan管理网络配置。编辑配置文件：

sudo nano /etc/netplan/01-netcfg.yaml

内容参考如下（根据你的实际网段调整）：

network: version: 2 ethernets: eth0: dhcp4: no addresses: - 192.168.1.100/24 gateway4: 192.168.1.1 nameservers: addresses: - 223.5.5.5 - 114.114.114.114

保存后执行sudo netplan apply生效。注意YAML格式对缩进非常严格，建议用空格而不是Tab。

5. 系统基础配置与开发环境准备

5.1 更换软件源为国内镜像

官方源在国内访问速度可能不理想。换成国内镜像源能显著提升apt安装软件的速度。以清华源为例，先备份原配置：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

然后编辑sources.list，把内容替换为对应Ubuntu 22.04的镜像地址。具体地址可以在清华镜像站找到。替换后执行：

sudo apt update

如果更新过程没有报错且速度明显变快，说明源配置正确。

5.2 安装常用工具与Python环境

做YOLOv5s部署需要一些基础工具和Python环境。先装一批常用工具：

sudo apt install -y git curl wget vim htop net-tools python3-pip python3-venv

然后建议用虚拟环境管理Python依赖，避免污染系统Python：

python3 -m venv ~/yolo-env source ~/yolo-env/bin/activate pip install --upgrade pip

后续安装YOLOv5s相关依赖时，都在这个虚拟环境里操作。这样即使依赖冲突，删掉虚拟环境重建就行，不会影响系统。

5.3 配置中文输入法与远程桌面（可选）

如果你需要中文输入法，可以安装fcitx5和拼音输入法：

sudo apt install -y fcitx5 fcitx5-chinese-addons fcitx5-pinyin

安装后在系统设置里配置输入法框架为fcitx5，重启后即可使用。

远程桌面方面，Ubuntu自带的GNOME桌面可以通过VNC或者xrdp来远程访问。不过对于跑YOLOv5s来说，大部分操作在SSH终端里完成就够了，远程桌面不是必须的。如果确实需要图形界面，可以装xrdp：

sudo apt install -y xrdp sudo systemctl enable xrdp sudo systemctl start xrdp

然后用Windows自带的远程桌面连接工具连板子IP即可。

5.4 检查NPU驱动与RKNN环境

香橙派RK3588的NPU是跑YOLOv5s的核心硬件。首次使用建议确认NPU驱动是否正常加载：

ls /dev/rknpu*

如果看到/dev/rknpu设备节点，说明驱动已经加载。如果没有，可能需要更新内核或者安装对应的驱动包。

RKNN Toolkit2的安装稍微复杂一些，涉及Python版本匹配和依赖库。这部分我建议参考官方文档一步步来，不要跳步。安装完成后可以用官方提供的示例模型测试NPU是否正常工作。

6. 常见问题与排查技巧实录

6.1 启动类问题

板子通电后没有任何反应，指示灯不亮。先检查电源是否达标，用万用表量一下输出电压。然后确认SD卡是否插紧、镜像是否烧录成功。如果SD卡在电脑上能看到boot分区，说明烧录没问题，那就要考虑是不是电源功率不够。

启动日志滚动后卡住不动。可能是镜像与板子型号不匹配。确认你下载的是香橙派5或者5 Pro对应的镜像。另外，某些批次的板子可能需要更新bootloader，这个在官方论坛有说明。

系统启动后显示器无信号。检查HDMI线是否插紧，换一根线试试。RK3588的HDMI输出有时需要显示器支持特定的分辨率，如果显示器较老可能不兼容。可以尝试通过SSH连接后修改显示配置。

6.2 网络与SSH类问题

SSH连接时提示“Connection refused”。最常见的原因是SSH服务没启动。在板子上执行sudo systemctl start ssh并设置开机自启。另外检查防火墙是否拦截了22端口。

SSH连接后经常断开。可能是网络不稳定或者板子供电不足。先换有线网络试试，如果问题依旧，检查电源。另外可以在SSH客户端配置中开启KeepAlive，定期发送心跳包保持连接。

忘记了板子的IP地址。如果没配静态IP，可以登录路由器管理界面查看已连接设备列表，找到香橙派的MAC地址对应的IP。或者接上显示器，在终端执行ip addr查看。

6.3 系统配置类问题

apt update报错“Could not resolve”。说明DNS解析有问题。检查/etc/resolv.conf里的nameserver配置，改成可用的DNS地址。或者检查网线是否插好、路由器是否正常。

Python包安装失败，提示缺少依赖。很多Python包需要系统级的开发库。比如安装opencv-python可能需要libgl1-mesa-glx等。根据报错信息用apt安装对应的dev包即可。

系统时间不对。执行timedatectl查看时间状态。如果时间偏差较大，可以安装ntp服务自动同步：

sudo apt install -y ntp sudo systemctl enable ntp sudo systemctl start ntp

6.4 独家避坑技巧汇总

第一个技巧：首次启动时不要插任何USB外设，除了键盘鼠标。我遇到过插了一个USB网卡导致系统启动时卡在检测阶段的情况。等系统完全起来后再插其他设备。

第二个技巧：SD卡的质量直接影响体验。便宜卡用一段时间后可能出现文件系统错误，导致系统无法启动。建议买正规品牌的高速卡，并且定期备份重要配置。

第三个技巧：修改任何系统配置文件前先备份。比如改netplan配置、改sources.list，先cp一份备份文件。改错了可以快速恢复，不用重装系统。

第四个技巧：SSH连接不稳定时，用mosh替代ssh。mosh对网络波动的容忍度更高，适合WiFi环境。安装方法：sudo apt install mosh，连接命令是mosh 用户名@IP。

第五个技巧：记录你的配置过程。每次改了什么东西、装了什么包，简单记一笔。过一段时间回头看，能省去大量回忆和排查的时间。

7. 从首次使用到YOLOv5s部署的衔接

系统跑通、SSH连上之后，下一步就是准备YOLOv5s的部署环境了。这里简单说一下衔接思路，方便你规划后续工作。

首先，确认Python虚拟环境已经激活，然后安装YOLOv5s需要的依赖。YOLOv5s官方仓库的requirements.txt里列了所有依赖包，但直接在RK3588上装可能会遇到版本冲突。建议先装PyTorch的CPU版本验证流程，再换用RKNN的推理接口。

其次，模型转换是关键一步。YOLOv5s的PyTorch模型需要先导出为ONNX格式，再用RKNN Toolkit2转换成RK3588 NPU能识别的.rknn格式。转换过程中要注意输入尺寸、量化方式等参数，这些会直接影响推理精度和速度。

最后，推理代码的编写要调用RKNN的Python API。官方提供了示例代码，可以参考着改。重点注意输入数据的预处理要和模型训练时保持一致，否则检测结果会不准。

这些内容展开又是一大篇，我打算放在下一篇里详细讲。当前这篇先把首次使用的流程走通，确保你的香橙派RK3588能稳定跑起来、能远程连上、能正常装软件。基础打牢了，后面部署YOLOv5s就是水到渠成的事。

我个人在实际操作中的体会是，首次使用阶段最耗时的往往不是技术难点，而是各种小问题叠加在一起——电源不对、卡没烧好、网络不通、SSH连不上。把这篇内容里的检查清单过一遍，能帮你把这些低级问题提前排除掉，把时间花在真正有价值的事情上。