Cloud-RiscV-Connect

云RISC-V开发板远程连接工具，支持SSH终端、VNC远程桌面和文件管理。

Remote connection tool for cloud RISC-V development boards with SSH terminal, VNC desktop, and file management.

简介 Introduction

这是一个VSCode扩展，帮助您通过动态域名连接到云端RISC-V开发板。

This is a VSCode extension that helps you connect to cloud-based RISC-V development boards via dynamic domains.

主要功能 Key Features

• VNC远程桌面 VNC remote desktop
• SSH终端 SSH terminal
• 远程文件管理 Remote file management
• 内置SSL隧道 Built-in SSL tunnel
• 跨平台支持 Cross-platform support (Windows, Linux, macOS)

使用流程 Usage Flow

1. 安装扩展 Install Extension

在VSCode扩展市场搜索并安装 Cloud-RiscV-Connect

Search and install Cloud-RiscV-Connect in VSCode Extension Marketplace

2. 打开命令面板 Open Command Palette

按 Ctrl+Shift+P (macOS: Cmd+Shift+P)

Press Ctrl+Shift+P (macOS: Cmd+Shift+P)

3. 连接开发板 Connect to Board

输入命令 Enter command:

SSH远程连接：连接Linux开发板（动态域名）

4. 输入连接信息 Enter Connection Info

• 动态域名前缀 Dynamic domain prefix (32位字符 32 characters)
• SSH用户名 SSH username (默认 default: root)
• SSH密码 SSH password (默认 default: bianbu)

5. 开始使用 Start Using

连接成功后 After connection:

• 左侧：远程文件管理器 Left: Remote file manager
• 右侧：VNC远程桌面 Right: VNC remote desktop
• 底部：SSH终端 Bottom: SSH terminal

6. 断开连接 Disconnect

按 Ctrl+Shift+P，输入命令 Press Ctrl+Shift+P, enter command:

断开连接：关闭所有远程连接（SSH+VNC+SFTP）

系统要求 System Requirements

必需 Required

• VSCode 1.80.0+
• SSH客户端 SSH client (Windows 10 1809+自带 built-in, macOS/Linux系统自带 pre-installed)

可选 Optional

• sshpass (用于自动密码输入 for automatic password input)

安装SSH客户端 Install SSH Client

Windows

Windows 10 1809及以上版本已内置，无需安装

Built-in for Windows 10 1809+, no installation needed

旧版本安装方法 For older versions:

设置 → 应用 → 可选功能 → 添加功能 → OpenSSH客户端
Settings → Apps → Optional Features → Add Feature → OpenSSH Client

macOS

系统自带，无需安装

Pre-installed, no installation needed

Linux

Ubuntu/Debian:

sudo apt-get install openssh-client

CentOS/RHEL:

sudo yum install openssh-clients

常见问题 FAQ

Q: 提示未检测到SSH客户端？

Q: SSH client not detected?

A: 请按照上述说明安装SSH客户端。VNC和文件管理功能不受影响。

A: Please install SSH client following the instructions above. VNC and file management will still work.

Q: VNC连接成功但看不到画面？

Q: VNC connected but no display?

A: 检查远程VNC服务是否运行，防火墙是否允许VNC端口。

A: Check if remote VNC service is running and firewall allows VNC port.

Q: 文件编辑后没有同步？

Q: File changes not synced?

A: 确保SFTP连接正常，远程目录有写入权限。

A: Ensure SFTP connection is active and remote directory has write permission.