VSCode/Cursor 客户端

350 字约 1 分钟

VSCode/Cursor 客户端 介绍如何让客户端远程连接云原生开发环境。

使用场景：不想在浏览器里写代码时使用——例如用本地 VSCode、Cursor 或 CodeBuddy 客户端连上开发环境，沿用自己熟悉的插件与快捷键。

自定义环境配置

使用自定义开发环境时，需额外配置：

在 Dockerfile 中预装 openssh-server。注意：基础镜像不同，安装方式可能存在差异。

以下通过 vscode 事件指定自定义镜像，并在 Dockerfile 中预装 openssh-server。以 Debian 系镜像（node:22）为例：

.cnb.yml
$:
  vscode:
    - docker:
        build:
          dockerfile: .ide/Dockerfile
      services:
        - vscode

.ide/Dockerfile
FROM node:22

# 安装 SSH 服务，支持 VSCode / Cursor / CodeBuddy 客户端远程连接
RUN apt-get update && apt-get install -y openssh-server

提示

若使用 alpine 等其它基础镜像，需改用对应的包管理器（如 apk add openssh-server）安装。

下载 VSCode/Cursor/CodeBuddy 客户端并安装 Remote-SSH 插件。

点击 VSCode 客户端按钮可能覆盖已有窗口。

将 Open Folders In New Window 设置为 on 即可解决：