# 通过SSH工具远程使用Notebook
本章节介绍在Windows环境中使用PuTTY SSH远程登录云上Notebook实例的操作。
#### 约束限制
使用SSH连接Notebook实例的约束限制如下：
- 本地用户密钥和权限必须匹配。
- 本地用户密钥需要存放在指定目录下。
  - Windows：C:\\Users\\{{user}}
  
  - macOS/Linux：\~
    ![](https://support.huaweicloud.com/usermanual-cloudrobo/public_sys-resources/note_3.0-zh-cn.png)
    在macOS和Linux系统中，\~ 表示当前用户的主目录。
    
   
- 远端镜像中的ma-user或root用户不能被锁定。
- 远端的/home/ma-user/.ssh或/root/.ssh目录权限建议设置为750或755。
- 本地或远端的OpenSSH版本不能低于8.0。
- 建议同时建立的连接数不超过10个。
 
#### 前提条件
- 已创建一个Notebook实例，并开启远程SSH开发。该实例状态必须处于"运行中"。
- 在Notebook实例的接入方式界面获取开发环境访问地址。
  图1获取开发环境访问地址示例   
  ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332650.png "点击放大") 
- 准备好SSH私钥文件。 在开启SSH远程连接后，下载SSH私钥文件（pem文件）至本地保存。
  
 
#### 步骤1：安装SSH工具
请用户到官网下载并安装SSH远程连接工具PuTTY。
#### 步骤2：使用puttygen将密钥对.pem文件转成.ppk文件
1. [下载puttygen](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)，并双击运行puttygen。
2. 单击"Load"，上传.pem密钥（即在创建Notebook实例时创建并保存的密钥对文件）。
3. 单击"Save private key"，保存生成的.ppk文件。.ppk文件的名字可以自定义，例如key.ppk。 
   图2将密钥对.pem文件转成.ppk文件   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172680.png "点击放大")
   
   
 
#### 步骤3：使用SSH工具连接云上Notebook实例
1. 运行PuTTY。
2. 单击"Session"，填写以下参数。 
   1. Host Name (or IP address)：云上开发环境Notebook实例的访问地址，即在Notebook实例详情页获取的地址。例如：dev-modelarts.cn-southwest-2.huaweicloud.com。
   
   2. Port：云上Notebook实例的端口，即在Notebook实例详情页获取的端口号。例如：30227。
   
   3. Connection Type：选择SSH。
   
   4. Saved Sessions：任务名称，在下一次使用PuTTY时单击保存的任务名称，即可打开远程连接。
   
   
   图3设置Session   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091553.png "点击放大")
   
   
3. 选择"Window \> Translation"，在"Remote character set:"中选择"UTF-8"。 
   图4设置字符格式   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002743931577.png)
   
   
4. 选择"Connection \> Data"，在"Auto-login username" 中填写用户名"ma-user"。 
   图5填写用户名   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332652.png)
   
   
5. 选择"Connection \> SSH \> Auth \> Credentials"，单击"Browse"，选择".ppk文件"。 
   图6选择目标文件   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172684.png "点击放大")
   
   
6. 单击"Open"。如果首次登录，PuTTY会显示安全警告对话框，询问是否接受服务器的安全证书。单击"Accept"将证书保存到本地注册表中。 
   图7询问是否接受服务器的安全证书   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332648.png "点击放大")
   
   
7. 成功连接到云上Notebook实例。 
   图8连接到云上Notebook实例   
   ![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002743931579.png "点击放大")