在 RK3588 上通过 VSCode 远程开发配置指南

在 RK3588 上通过 VSCode 远程开发配置指南

RK3588 设备本身不具备可视化编程环境，但可以通过 VSCode 的 Remote - SSH 插件 实现远程代码编写与调试。以下是完整的配置流程。

---

一、连接 RK3588

1. 安装 Debian 系统

先在 RK3588 上安装 Debian 操作系统。

2. 安装 ADB 工具

在 RK3588 上执行以下命令安装 ADB：

sudo apt install adb

3. 通过 ADB 进入设备终端

使用 Type-C 数据线将 RK3588 连接到电脑，然后在电脑终端中运行：

adb shell

---

二、连接 Wi-Fi

4. 查看并连接 Wi-Fi 网络

在 ADB 终端中执行以下命令扫描并连接 Wi-Fi：

nmcli device wifi list
nmcli device wifi connect "wifi账号" password "wifi密码"

查看网络连接状态：

nmcli device status

5. 获取 IP 地址

查看分配的 IP 地址（我这里使用的端口是p2p0，分配的ip是inet对应的192.168.99.166）：

ifconfig

---

三、配置 SSH 连接

6. 使用 SSH 登录设备

SSH 登录命令如下（用户名来自 ADB 登录时的用户名，例如 root）：

ssh 用户名@ip

7. 设置登录密码

如果首次登录需设置密码，请执行：

passwd

8. 修改 SSH 配置文件

由于默认配置可能禁止密码登录或 root 登录，需修改 /etc/ssh/sshd_config：

sudo apt update
sudo apt install nano
sudo nano /etc/ssh/sshd_config

修改以下两行内容，其中PermitRootLogin Yes允许密码登录和在root账号登录，PubkeyAuthentication yes` 允许使用基于公钥的身份验证方法来进行SSH登录，方便后续配置公钥后，免密登录：

PermitRootLogin yes
PubkeyAuthentication yes

9. 重启 SSH 服务

保存配置后重启 SSH：

sudo systemctl restart ssh

10. 再次尝试 SSH 登录

使用新设置的密码登录：

ssh root@192.168.99.166

---

四、配置 SSH 公钥免密登录（推荐）

11. 生成本地 SSH 密钥

在本地电脑终端中执行：

ssh-keygen

一路回车即可完成生成。

12. 将公钥上传至 RK3588

ssh-copy-id 用户名@ip

13. 重启 SSH 服务

确保配置生效：

sudo systemctl restart ssh

---

五、使用 VSCode 远程连接 RK3588

14. 安装 Remote - SSH 插件

在 VSCode 中搜索并安装插件：Remote - SSH。

15. 添加新的 SSH 目标

点击左下角的远程连接图标 ➕

输入以下命令添加目标：

ssh root@192.168.99.166

16. 选择配置项

选择第一个选项以完成配置，顺利添加完ssh：

17. 连接远程开发环境

点击 VSCode 右下角的连接图标，即可进入远程开发环境：