本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 通过远程访问将您的远程 IDE 连接到 SageMaker 空间
<a name="remote-access"></a>

您可以从远程 IDE 远程连接到 Amazon SageMaker Studio 空间。您可以将自定义的本地 IDE 设置（包括 AI 辅助开发工具和自定义扩展）与 Amazon A SageMaker I 中的可扩展计算资源配合使用。本指南为管理员和用户提供概念介绍与设置说明。

远程 IDE 连接可在本地 IDE 和 SageMaker 空间之间建立安全连接。此连接可让您：
+ **访问 SageMaker AI 计算资源** — 从本地环境在可扩展的 SageMaker AI 基础架构上运行代码
+ **维护安全边界** — 在与 SageMaker AI 相同的安全框架内工作
+ **保持熟悉的 IDE 体验** — 使用支持远程开发的兼容本地扩展、主题和配置

**注意**  
并非所有 IDE 扩展都与远程开发兼容。需要本地 GUI 组件、存在架构依赖关系或需要特定的客户端-服务器交互的扩展在远程环境中可能无法正常工作。使用前，请确认所需的扩展支持远程开发。

**Topics**
+ [重要概念](#remote-access-key-concepts)
+ [连接方法](#remote-access-connection-methods)
+ [支持的 IDEs](#remote-access-supported-ides)
+ [IDE 版本要求](#remote-access-ide-version-requirements)
+ [操作系统要求](#remote-access-os-requirements)
+ [本地计算机先决条件](#remote-access-local-prerequisites)
+ [映像要求](#remote-access-image-requirements)
+ [实例要求](#remote-access-instance-requirements)
+ [设置远程访问](remote-access-remote-setup.md)
+ [设置远程 IDE](remote-access-local-ide-setup.md)
+ [支持的 AWS 区域](remote-access-supported-regions.md)

## 重要概念
<a name="remote-access-key-concepts"></a>
+ **远程连接** — 远程 IDE 和 SageMaker 空间之间的安全隧道。此连接支持使用 SageMaker AI 计算资源进行交互式开发和代码执行。
+ [https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-spaces.html) — 亚马逊 SageMaker Studio 内的专用环境，您可以在其中管理 Studio 应用程序的存储空间和资源。
+ **深度链接** — SageMaker 用户界面中的一个按钮（直接 URL），用于启动与本地 IDE 的远程连接。

## 连接方法
<a name="remote-access-connection-methods"></a>

将远程 IDE 连接到 SageMaker 空间的主要方法有三种：
+ **深度链接访问** — 您可以使用 SageMaker AI 中提供的**带按钮的 Open space 直接连接到特定空间**。它使用 URL 模式来建立远程连接并在远程 IDE 中打开您的 SageMaker 空间。
+ [https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) – 可以使用 AWS Toolkit for Visual Studio Code进行身份验证。这允许您从远程 IDE 连接到空间并打开远程连接的窗口。
+ **SSH 终端连接** – 可以使用 SSH 配置通过命令行进行连接。

## 支持的 IDEs
<a name="remote-access-supported-ides"></a>

与 Studio 空间的远程连接支持：
+ [Visual Studio Code](https://code.visualstudio.com/)
+ [Kiro](https://kiro.dev/)
+ [Cursor](https://cursor.com/home)

## IDE 版本要求
<a name="remote-access-ide-version-requirements"></a>

下表列出了每个支持的远程 IDE 的最低版本要求。


| IDE | 最低版本 | 
| --- | --- | 
| Visual Studio Code | [v1.90](https://code.visualstudio.com/updates/v1_90) 或更高版本。我们建议使用[最新的稳定版本](https://code.visualstudio.com/updates)。 | 
| Kiro | v0.10.78 或更高版本 | 
| Cursor | v2.6.18 或更高版本 | 

将您的远程 IDE 连接到 Studio 空间需要使用 AWS Toolkit 扩展。对于 Kiro 和 Cursor，需要 AWS 工具包扩展版本 v3.100 或更高版本。

## 操作系统要求
<a name="remote-access-os-requirements"></a>

您需要使用下列操作系统之一，才能远程连接到 Studio 空间：
+ macOS 13\+
+ Windows 10
  + [Windows 10 支持将于 2025 年 10 月 14 日终止](https://support.microsoft.com/en-us/windows/windows-10-support-ends-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281)
+ Windows 11
+ Linux
  + 对于 VS Code，请安装[适用于 Linux 的官方微软 VS 代码](https://code.visualstudio.com/docs/setup/linux)，而不是开源版本

## 本地计算机先决条件
<a name="remote-access-local-prerequisites"></a>

在将远程 IDE 连接到 Studio 空间之前，请确保您的本地计算机具有所需的依赖项和网络访问权限。

**重要**  
具有软件安装限制的环境可能会阻止用户安装所需的依赖项。在启动远程连接时 AWS Toolkit for Visual Studio Code 会自动搜索这些依赖关系，如果缺少任何依赖关系，则会提示安装。与您的 IT 部门协调，确保这些组件可用。

**必需的本地依赖关系**

您的本地计算机必须安装以下组件：
+ **[Remote-SSH 扩展](https://code.visualstudio.com/docs/remote/ssh)** — 适用于你的 IDE 的远程开发扩展（在 VS Code、Kiro 和 Cursor 的扩展市场中可用）
+ **[会话管理器插件](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)**-安全会话管理所必需的
+ **SSH 客户端** — 大多数计算机上的标准组件（[建议在 Windows 上使用 OpenSSH](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse)）
+ **IDE CLI 命令** — 通常包含在 IDE 安装中（`code`例如，对于 VS Code，对于 Kiro，对于 Cursor，`kiro`对`cursor`于 Cursor）

**特定于平台的要求**
+ **Windows 用户** — SSH 终端连接需要 PowerShell 5.1 或更高版本

**网络连接要求**

您的本地计算机必须具有访问[会话管理器端点](https://docs.aws.amazon.com/general/latest/gr/ssm.html)的网络访问权限。例如，在美国东部（弗吉尼亚北部）（us-east-1），它们可以是：
+ ssm.us-east-1.amazonaws.com
+ ssm.us-east-1.api.aws
+ ssmmessages.us-east-1.amazonaws.com
+ ec2messages.us-east-1.amazonaws.com

## 映像要求
<a name="remote-access-image-requirements"></a>

**SageMaker 分发图片**

使用具有远程访问权限的 SageMaker 分发版时，请使用[SageMaker 分发](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-distribution.html)版本 2.7 或更高版本。

**自定义图片**

当您[自带映像（BYOI）](studio-updated-byoi.md)进行远程访问时，请确保遵循[自定义映像规范](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-byoi-specs.html)，并确保安装了以下依赖项：
+ `curl`或 `wget` — 下载 AWS CLI 组件时必填项
+ `unzip`— 解压缩 AWS CLI 安装文件所必需的
+ `tar`— 档案提取所必需的
+ `gzip`— 处理压缩文件所必需的

## 实例要求
<a name="remote-access-instance-requirements"></a>
+ **内存** – 8GB 或更多
+ **实例类型** – 使用内存至少为 8GB 的实例。因内存不足（小于 8GB），*无法*支持以下实例类型：`ml.t3.medium`、`ml.c7i.large`、`ml.c6i.large`、`ml.c6id.large` 和 `ml.c5.large`。有关更完整的实例类型列表，请参阅 [Amazon EC2 按需定价页面](https://aws.amazon.com/ec2/pricing/on-demand/)。

**Topics**
+ [重要概念](#remote-access-key-concepts)
+ [连接方法](#remote-access-connection-methods)
+ [支持的 IDEs](#remote-access-supported-ides)
+ [IDE 版本要求](#remote-access-ide-version-requirements)
+ [操作系统要求](#remote-access-os-requirements)
+ [本地计算机先决条件](#remote-access-local-prerequisites)
+ [映像要求](#remote-access-image-requirements)
+ [实例要求](#remote-access-instance-requirements)
+ [设置远程访问](remote-access-remote-setup.md)
+ [设置远程 IDE](remote-access-local-ide-setup.md)
+ [支持的 AWS 区域](remote-access-supported-regions.md)