文档首页/ 魔坊（ModelArts）模型训推平台/ ModelArts用户指南（控制台）/ 使用Notebook进行AI开发调试/ 通过SSH工具远程使用Notebook
更新时间：2026-06-04 GMT+08:00
查看PDF
分享

通过SSH工具远程使用Notebook

本节操作介绍在Windows环境中使用CMD和MobaXterm工具通过SSH远程登录Notebook实例的操作步骤。

约束限制

使用SSH连接Notebook实例的约束限制如下：

  • 本地用户密钥和权限必须匹配。
  • 本地用户密钥需要存放在指定目录下。
    • Windows：C:\Users\{{user}}
    • macOS/Linux：~

      在macOS和Linux系统中，~ 表示当前用户的主目录。

  • 远端镜像中的ma-user或root用户不能被锁定。
  • 远端的~/.ssh目录权限建议设置为750或755。
  • 本地或远端的OpenSSH版本不能低于8.0。
  • 建议同时建立的连接数不超过10个。

如果遇到SSH连接问题，请参考本地通过SSH连接Notebook实例的故障排查进行解决。

前提条件

  • 已在DEW管理控制台创建账号密钥对，并将密钥文件并存放在指定目录下。具体操作，请参见创建密钥对。
    • Windows：C:\Users\{{user}}
    • macOS/Linux：~
    如果创建账号密钥对时，勾选“我同意将密钥对私钥托管”，则密钥可重复下载（在“账号密钥对“页面操作列单击“导出私钥”）；如果未勾选“我同意将密钥对私钥托管”，则仅创建时会自动下载，后续无法下载，请妥善保存。
    图1 创建账号密钥对

  • 已创建一个Notebook实例，并开启SSH远程开发（密钥对选择已创建的账号密钥对）。该实例状态必须处于“运行中”。
  • 在Notebook实例详情页面的“基本信息”页签，获取SSH远程开发的访问地址。
    图2 创建Notebook-SSH远程开发
    图3 Notebook实例详情页面

方式一：使用CMD连接Notebook实例

下文以Windows系统为例进行说明。

  1. 打开CMD。
    • 方式一：使用开始菜单
      1. 在电脑左下角，单击“开始”，或者按键盘上的Windows键。
      2. 在开始菜单中，输入CMD，单击“命令提示符”。
        图4 打开CMD
    • 方式二：使用运行对话框
      1. 在键盘按“Windows+R”键，打开“运行”对话框。
      2. 在“运行”对话框中输入CMD，按Enter键或单击“确定”。
  2. 在CMD中，进入密钥所在目录并执行以下命令，连接Notebook实例。 
    ssh -o StrictHostKeyChecking=no -i {密钥文件名} {启动用户}@{域名} -p {端口}

    命令中的{密钥文件名}、{启动用户}、{域名}、{端口}请替换为您实际的信息，从前提条件获取。

    例如，密钥文件名为KeyPair-1234-test.pem，SSH远程开发的访问地址为ssh://ma-user@authoring-ssh-modelarts-*****.huawei.com:31092，其中ma-user为启动用户，authoring-ssh-modelarts-*****.huawei.com为域名，31092为端口。命令示例如下：

    ssh -o StrictHostKeyChecking=no -i KeyPair-1234-test.pem ma-user@authoring-ssh-modelarts-*****.huawei.com -p 31092

    如下图所示，出现交互界面，表示连接成功。

    图5 使用CMD连接Notebook实例

方式二：使用MobaXterm连接Notebook实例

  1. 下载并安装MobaXterm。
  2. 打开MobaXterm，在左上角单击“Session”，在“Session settings”对话框的SSH页签，配置Remote host、Username、Port和Use private key，单击“OK”。
    图6 配置Session

    SSH远程开发的访问地址、密钥文件的路径从前提条件获取。例如，SSH远程开发的访问地址为ssh://ma-user@authoring-ssh-modelarts-*****.huawei.com:31092，配置示例如下。

    表1 配置说明

    配置项

    说明

    示例值

    Basic SSH settings

    Remote host

    远程主机的地址，从SSH远程开发的访问地址中获取。

    authoring-ssh-modelarts-*****.huawei.com

    Username

    用于连接远程主机的用户名，从SSH远程开发的访问地址中获取。

    ma-user

    Port

    用于连接远程主机的端口号，从SSH远程开发的访问地址中获取。

    31092

    Advanced SSH settings

    Use private key

    密钥文件的路径。从前提条件获取。

    C:\Users\***\KeyPair-1234-test.pem

    如下图所示，出现交互界面，表示连接成功。

    图7 使用MobaXterm连接Notebook实例

相关文档