本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用遠端存取將您的遠端 IDE 連接到 SageMaker 空間
<a name="remote-access"></a>

您可以從遠端 IDE 遠端連線至 Amazon SageMaker Studio 空間。您可以使用自訂的本機 IDE 設定，包括 AI 輔助開發工具和自訂擴充功能，以及 Amazon SageMaker AI 中的可擴展運算資源。本指南提供管理員和使用者的概念和設定指示。

遠端 IDE 連線會在本機 IDE 和 SageMaker 空間之間建立安全連線。此連線可讓您：
+ **存取 SageMaker AI 運算資源** - 從本機環境對可擴展的 SageMaker AI 基礎設施執行程式碼
+ **維護安全界限** - 在與 SageMaker AI 相同的安全架構內運作
+ **保持熟悉的 IDE 體驗** — 使用相容的本機延伸模組、主題和支援遠端開發的組態

**注意**  
並非所有 IDE 擴充功能都與遠端開發相容。需要本機 GUI 元件、具有架構相依性或需要特定用戶端與伺服器互動的延伸模組可能無法在遠端環境中正常運作。使用前，請確認所需的擴充功能支援遠端開發。

**Topics**
+ [重要概念](#remote-access-key-concepts)
+ [連線方法](#remote-access-connection-methods)
+ [支援的 IDE](#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) - Amazon SageMaker Studio 內的專用環境，您可以在其中管理 Studio 應用程式的儲存和資源。
+ **深層連結** - 來自 SageMaker UI 的按鈕 (直接 URL)，可啟動與本機 IDE 的遠端連線。

## 連線方法
<a name="remote-access-connection-methods"></a>

將遠端 IDE 連線到 SageMaker 空間有三種主要方式：
+ **深層連結存取**：您可以使用 SageMaker AI 中可用的按鈕**開啟空間**，直接連線至特定空間。這使用 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 組態透過命令列連線。

## 支援的 IDE
<a name="remote-access-supported-ides"></a>

Studio 空間的遠端連線支援：
+ [Visual Studio 程式碼](https://code.visualstudio.com/)
+ [Kiro](https://kiro.dev/)
+ [游標](https://cursor.com/home)

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

下表列出每個支援的遠端 IDE 的最低版本需求。


| IDE | 最低版本 | 
| --- | --- | 
| Visual Studio 程式碼 | [1.90 版](https://code.visualstudio.com/updates/v1_90)或更新版本。建議使用[最新的穩定版本](https://code.visualstudio.com/updates)。 | 
| Kiro | v0.10.78 或更新版本 | 
| 游標 | v2.6.18 或更新版本 | 

需要 AWS Toolkit 擴充功能，才能將遠端 IDE 連線至 Studio 空間。對於 Kiro 和 Cursor，Toolkit AWS 延伸模組版本 3.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 程式碼，請安裝適用於 [Linux 的官方 Microsoft VS 程式碼](https://code.visualstudio.com/docs/setup/linux)，而不是開放原始碼版本

## 本機機器先決條件
<a name="remote-access-local-prerequisites"></a>

將遠端 IDE 連線至 Studio 空間之前，請確定您的本機機器具有必要的相依性和網路存取。

**重要**  
具有軟體安裝限制的環境可能會讓使用者無法安裝必要的相依性。啟動遠端連線時， AWS Toolkit for Visual Studio Code 會自動搜尋這些相依性，如果有任何遺失， 會提示安裝。與您的 IT 部門協調，以確保這些元件可用。

**必要的本機相依性**

您的本機機器必須安裝下列元件：
+ **[遠端 SSH 延伸](https://code.visualstudio.com/docs/remote/ssh)** — IDE 的遠端開發延伸模組 （適用於 VS Code、Kiro 和 Cursor 的延伸模組市集）
+ **[Session Manager 外掛程式](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 程式碼、`kiro`用於 Kiro、`cursor`用於游標）

**平台特定需求**
+ **Windows 使用者** — SSH 終端機連線需要 PowerShell 5.1 或更新版本

**網路連線需求**

您的本機機器必須具有 [Session Manager 端點](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 Distribution 時，請使用 [SageMaker Distribution](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)
+ [支援的 IDE](#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)