# 连接并使用 JetBrains Gateway > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). 您可以使用 SSH 连接连接到远程服务器，以开发、运行和部署您的项目。 您还可以连接到运行在 [JetBrains CodeCanvas](#code_canvas_integration)、 [Gitpod](#gitpod_integration)、 [Google Cloud](#google_cloud_integration)、 [Amazon CodeCatalyst](#amazon_code_catalyst) 和 [Coder](#coder_integration) 上的开发环境。 > **Warning:** > 在您开始开发之前，请确保满足 [系统要求](prerequisites-for-dev-containers.html)。 ## JetBrains Gateway JetBrains Gateway 是一个轻量级启动器，可将远程服务器与您的本地计算机连接，下载后端所需组件，并在 JetBrains 客户端 中打开您的项目。 请参阅有关如何开始使用 JetBrains Gateway 的快速视频。 [Video](https://www.youtube.com/v/TH8wrm449kM) 您可以使用 JetBrains Gateway 作为独立的启动器或者从您的 IDE 连接到远程服务器的入口点。 Procedure: 启动 JetBrains Gateway 并连接到远程服务器 1. 请使用其中一个 [安装场景](jetbrains-gateway.html)来打开 远程开发 向导。 2. 请点击 新建连接 下的 SSH 连接提供程序。 ![通过 SSH 连接](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers.png) > **Note:** > 您也可以点击 通过链接连接 并输入您之前 [生成的](#use_local_ide) 链接，以连接到 Code With Me 会话或远程服务器。 3. 在向导的下一页中，指定您想通过其连接到远程服务器的 SSH 配置。 ![SSH 设置](https://resources.jetbrains.com/help/img/idea/2026.3/ssh_settings.png) 或者，点击 ![SSH 配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)以打开 SSH 配置 对话框并配置SSH设置。 在 SSH 配置 对话框中，添加以下信息： ![SSH 配置](https://resources.jetbrains.com/help/img/idea/2026.3/ssh_configuration.png) * 主持人 ：指定您的远程服务器地址。 * 端口 ：指定 SSH 端口，默认为 `22` 。 * 用户名 ：指定将用于连接远程服务器的用户名称。 * 身份验证类型 ：选择以下身份验证方法之一： * 密码 ：以密码访问主机。 要将密码保存在 IntelliJ IDEA 中，请选中 保存密码 复选框。 * 密钥对（OpenSSH 或 PuTTY） ：使用 [SSH 身份验证](https://www.ssh.com/)与密钥对。 要应用此身份验证方法，您必须在客户端计算机上拥有私钥，并在远程服务器上拥有公钥。 IntelliJ IDEA 支持使用 [OpenSSH](https://www.openssh.com/) 工具生成的私钥。 请指定保存了您的 私钥 的文件路径，并在相应字段中输入密码短语（如果有）。 要让 IntelliJ IDEA 记住该密码短语，请选中 保存密码短语 复选框。 * 解析配置文件 ~/.ssh/config ：如果您希望 JetBrains Gateway 使用 `.ssh/config` 文件，请选择此选项。 * 测试连接 ：点击此按钮以查看连接是否已建立。 * 连接参数 ：使用此部分配置连接的附加参数。 有关更多信息，请参见 [连接参数](settings-tools-ssh-configurations.html#connection-parameters)。 * HTTP/SOCKS 代理 ：使用本节配置代理设置。 如需更多信息，请参阅 [Proxy settings](settings-http-proxy.html)。 点击 OK 以保存更改并返回到 欢迎使用 JetBrains Gateway 对话框。 请点击 检查连接并继续 以检查连接是否已建立。 4. 在下一页面，指定要下载到远程服务器的 IntelliJ IDEA 版本。 JetBrains Gateway 显示可供下载和已安装的 IDE 版本列表。 您也可以使用“其他选项”来设置 [IDE 安装程序](remote-development-starting-page.html#connect_to_rd_ij)的备用源。 下载到本地计算机的 JetBrains 客户端 版本始终与远程 IDE 版本匹配。 ![IDE 版本](https://resources.jetbrains.com/help/img/idea/2026.3/ide_version.png) 默认情况下，下载的 IntelliJ IDEA 位于远程服务器上的以下文件夹中： `~/.cache/JetBrains/RemoteDev/dist` 。 但是，您可以按以下步骤更改它并将 IntelliJ IDEA 安装到自定义位置： 1. 点击 其他选项 并选择 自定义安装路径 选项。 2. 在 安装路径 字段中添加需要的安装位置。 ![安装到自定义位置](https://resources.jetbrains.com/help/img/idea/2026.3/rd_install_to_custom_location.png) 添加项目在远程主机上的路径。 ![远程项目路径](https://resources.jetbrains.com/help/img/idea/2026.3/path_to_remote_project.png) 点击 上传 IDE 并连接 。 JetBrains Gateway 下载 IDE，并在 JetBrains 客户端 中打开您的远程项目。 连接显示在 JetBrains Gateway 窗口中，您可以从中连接到其他 IDE 或禁用连接。 该窗口默认隐藏到托盘。 ![网关窗口](https://resources.jetbrains.com/help/img/idea/2026.3/gateway_window.png) 在打开项目之前，可以重写后端的 `-Xmx` 虚拟机选项。 Procedure: 重写 -Xmx VM 选项 1. [启动](#launch_gateway) JetBrains Gateway. 2. 请按照向导的步骤操作。 点击 检查连接并继续 。 3. 在打开的页面上，在 IDE 版本 字段下，点击 安装选项 。 4. 从下拉菜单中选择 自定义堆大小 。 ![自定义堆大小](https://resources.jetbrains.com/help/img/idea/2026.3/customize_heap_size.png) 5. 在 最大堆大小 字段中，根据需要重写默认堆大小。 ![最大堆大小](https://resources.jetbrains.com/help/img/idea/2026.3/max_heap_size.png) 请注意，此字段只能包含数值且不能超过 `INT_MAX` 的值。 > **Note:** > 如果您想恢复默认值，请再次点击 安装选项 并选择 使用默认堆大小 。 6. 完成配置后，点击 下载 IDE 并连接 以开始您的项目。 Procedure: 打开最近的项目 1. 在 JetBrains Gateway 向导中，从左侧选项中选择 SSH 。 2. 在搜索字段中输入项目名称以快速导航到该项目。 ![最近项目](https://resources.jetbrains.com/help/img/idea/2026.3/recent_projects.png) 如果您需要快速访问终端，请点击 ![打开终端](https://resources.jetbrains.com/help/img/idea/2026.3/terminal.icons.OpenTerminal_13x13.svg)。 Procedure: 更改后端版本 * 在 JetBrains Gateway 向导中，点击 ![更多按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg)旁边的最近项目名称，然后选择您要用来打开项目的后端版本。 ![更改后端版本](https://resources.jetbrains.com/help/img/idea/2026.3/change_backend_version.png) 如果在列表中找不到所需的版本，请点击 选择其他 IDE ，并在 IDE 版本 字段中选择所需的 IDE 版本。 ![选择 IDE 版本](https://resources.jetbrains.com/help/img/idea/2026.3/select_ide_version.png) Procedure: 停止运行中的实例 1. 在 JetBrains Gateway 向导中，从左侧选项中选择 SSH 。 2. 当您的远程会话处于激活状态时， 运行 指示器将显示在项目旁边。 ![运行实例](https://resources.jetbrains.com/help/img/idea/2026.3/active_instance.png) 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.moreHorizontal.svg)旁边的项目，并选择 停止 IDE Backend 以停止该项目的远程会话。 ![停止 IDE Backend](https://resources.jetbrains.com/help/img/idea/2026.3/stop_instance.png) 您也可以选择 从最近项目中移除 从页面上完全删除列出的项目。 Procedure: 卸载 后端 IDE 版本 1. 在 JetBrains Gateway 向导中，点击 ![显示选项菜单图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)旁边的远程服务器名称，然后选择 管理 IDE 后端 以打开已安装的 IDE 版本列表。 ![管理 IDE](https://resources.jetbrains.com/help/img/idea/2026.3/manage_ide.png) 2. 在打开的窗口中，点击所需卸载的 backend IDE version 旁边的 ![关闭图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.close.svg)，然后点击 是 以确认操作。 ## 连接到手动启动的远程 IDE 上的远程项目（服务器到客户端流程） 如果已在远程服务器上安装 IntelliJ IDEA，可以手动启动它，并连接到在该 IDE 中启动的远程项目。 它的工作方式与从 [JetBrains Gateway](#gateway) 一样。 如果公司有自定义编排，或者远程 IDE 会在远端自动启动，请使用此方法。 该过程可描述如下： Procedure: 1. 在远程 IDE 中启动后端项目。 2. 选择后端生成的连接链接之一。 3. 在本地计算机上打开该链接。 用于运行远程 IDE 的主脚本是 `remote-dev-server.sh` ，位于解压后的 IDE 的 `bin` 子目录中。 > **Note:** > 如果后端是通过 JetBrains Gateway 安装的，默认路径为 `/home/your_system_user/.cache/JetBrains/RemoteDev/dist/` 。 > **Note:** > 如需了解更多信息和可用参数，请运行 `remote-dev-server.sh --help` > **Note:** > 请注意，连接会绑定到特定项目。 要连接到另一个远程项目，您需要配置一个新的 [连接](work-inside-remote-project.html#multiple_connections)。 Procedure: 连接到远程 IDE 1. 请确保已 [下载并安装 JetBrains Gateway](#launch_gateway)，或者本地计算机上有带 JetBrains Gateway 插件的 IDE。 2. 请确保已使用 IntelliJ IDEA 通过 SSH 连接到远程计算机。 3. 在远程服务器的终端中运行以下命令： ``` remote-dev-server.sh run /path_to_project/ --ssh-link-host host_server_address --ssh-link-user remote_side_user --ssh-link-port ssh_connection_port ``` 请查看以下示例： ```SHELL ~/ideaIU-213.3469/bin/remote-dev-server.sh run ~/spring-boot-example/ --ssh-link-host ec2-11-50-136-85.eu-north-1.compute.amazonaws.com --ssh-link-user ubuntu ``` 如果未传递形参，脚本将使用默认值：端口为 22、系统用户的用户名，以及来自 `主机名` 命令的主机。 4. 如果项目启动成功，终端中应会输出以下 3 个链接： * 加入链接：tcp://127.0.0.1:5990...[ ] ：包含远程 IDE 当前正在侦听的本地地址和端口。 示例： ``` tcp://127.0.0.1:5991#jt=71e779a1-070e-4fd3-a4e6-83c1f8cb65a5&p=IU&fp=A42F6041C2878D7A22339ECABF4A9C294F643BG05E91E3DFC06035E03DB71BF8&cb=222.4167.29&jb=17.0.4b469.53 ``` 要使用它，请确保可通过此本地地址访问远程计算机。 例如，适用于在 Docker 中运行且端口已转发或开放的 IDE。 > **Tip:** > 有关详细信息，请参阅命令行中 `ssh -L` 命令的输出。 * Http 链接: https://code-with-me.jetbrains.com/remoteDev...[ ] ：包含有关主机-端口-用户、IDE 及其版本的信息。 示例： ``` https://code-with-me.jetbrains.com/remoteDev#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false ``` 在本地浏览器中打开时，它会显示欢迎页面，并尝试调用本地 Gateway 应用程序，其中已预填连接设置值。 如果在本地计算机上未找到 JetBrains Gateway 应用程序，可以从欢迎页面下载它。 * Gateway 链接：jetbrains-gateway://connect#idePath... [ ] ：还包含有关主机-端口-用户、IDE 及其版本的信息。 示例： ``` jetbrains-gateway://connect#idePath=%2Fhome%2Fubuntu%2F.cache%2FJetBrains%2FRemoteDev%2Fdist%2F3e4cd27bfbb95_ideaIU-2022.2.2&projectPath=%2Fhome%2Fubuntu%2Fdevelopment%2Fspring-petclinic&host=ec2-xx-xx-xxx-xx.eu-north-1.compute.amazonaws.com&port=22&user=ubuntu&type=ssh&deploy=false ``` 在本地浏览器中打开时，它会直接启动本地 JetBrains Gateway 应用程序，而不显示欢迎页面。 5. 复制生成的链接并将其粘贴到本地浏览器中，以允许其 打开 JetBrains Gateway 。 6. 所有这些链接也可以在已启动的 JetBrains Gateway 中打开。 为此，请在 JetBrains Gateway 欢迎屏幕的 连接到运行中的 IDE 字段中粘贴链接，然后点击 连接 。 IntelliJ IDEA 会下载所需版本的 JetBrains Client，并在其中打开远程项目。 Procedure: 注册之前已安装的远程 IDE 从版本 221.5481 开始，可以在远程服务器上手动注册现有的后端 IDE，并使其在 Gateway 中可见。 要注册已安装的 IDE 并使其显示在可用构建列表中，请执行以下步骤： 1. 通过 SSH 连接到远程服务器。 2. 找到解压后的 IDE 所在文件夹并打开 `bin` 目录。 3. 请使用命令行运行以下命令： ``` remote-dev-server.sh registerBackendLocationForGateway ``` 示例： ``` sh WebStorm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway ``` ## 连接到 Google Cloud 您可以使用 JetBrains Gateway 连接到 Google Cloud 以处理远程项目。 在连接 Google Cloud 之前，请确保您已完成以下操作： * 设置 Cloud Workstations 配置文件和集群（由您或管理员完成） * [创建](https://cloud.google.com/workstations/docs/create-workstation) 一台工作站 * 访问了工作站 Cloud Workstations [plugin](https://plugins.jetbrains.com/plugin/19900-cloud-workstations) 允许您连接工作站并在 IntelliJ IDEA 中使用。 Procedure: 连接到您在 Google Cloud 的工作站 1. 启动 [JetBrains Gateway](#launch_gateway)。 2. 从左侧选项中选择 所有提供商 。 3. 在 安装更多提供商 部分，找到 Google 云 并点击 安装 。 ![Google 云](https://resources.jetbrains.com/help/img/idea/2026.3/gateway_all_providers.png) 插件安装完成后，您可以在 远程运行 IDE 部分找到它。 4. 从左侧的选项中找到 Cloud Workstations 并点击 连接到 Google Cloud 。 5. 在打开的窗口中，选择首选工作站并点击 下一步 。 ![连接到 Cloud Workstation](https://resources.jetbrains.com/help/img/idea/2026.3/connect_to_cloud_workstation.png) > **Note:** > 请点击 云控制台 如果您需要切换到 Google Cloud 仪表板并管理 Cloud Workstations。 6. 在下一页，选择您在配置文件中选择的 IDE 版本作为代码提供者，以及您想要处理的项目。 ![IDE 版本和项目](https://resources.jetbrains.com/help/img/idea/2026.3/ide_backend_project.png) 连接已建立，带有项目的工作站在 JetBrains Client 中打开，您可以在 IDE 中继续工作。 ## 连接到 Gitpod Classic 或 Ona 通过 Gitpod Gateway 插件，可以创建或连接到 [Gitpod Classic](https://ona.com/docs/classic/user/integrations/jetbrains-gateway) 工作区，并在 IntelliJ IDEA 中工作。 对于 Ona 环境，请使用 [Toolbox App 中的 Ona 插件](https://www.jetbrains.com/zh-cn/help/toolbox-app/manage-providers.html)。 Procedure: 连接到 您在 Gitpod 上的工作区 1. 启动 [JetBrains Gateway](#launch_gateway)。 2. 从左侧选项中选择 远程开发 。 3. 在 安装更多提供商 部分，找到 Gitpod 并点击 安装 。 ![安装 Gitpod](https://resources.jetbrains.com/help/img/idea/2026.3/gateway_all_providers.png) 插件安装完成后，您可以在 远程开发 节点以及 安装更多提供商 部分找到它。 4. 从右侧的选项中找到 Gitpod 并点击 连接到 Gitpod 。 ![欢迎屏幕：安装了 Gitpod 插件](https://resources.jetbrains.com/help/img/idea/2026.3/rd_welcome_screen_installed_gitpod.png)。 。 5. 在打开的窗口中，选择您想要使用的 IDE。 ![Gitpod IDE 选择](https://resources.jetbrains.com/help/img/idea/2026.3/rd_gitpod_ide_selection.png) > **Note:** > 如需切换到 Gitpod 仪表板、阅读 Gitpod 文档或退出 Gitpod，请点击 ![齿轮图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)。 6. 点击 新建工作区 。 JetBrains Gateway 通过浏览器连接到您的 Gitpod 工作区。 Gitpod 准备工作区并显示有关在 JetBrains Client 内部打开工作区的通知。 ![在浏览器中打开 JetBrains Gateway](https://resources.jetbrains.com/help/img/idea/2026.3/browser_open_gateway_gitpod.png) 点击 允许 然后 是 在身份验证对话框中。 已建立连接，带有项目的工作区已在 JetBrains Client 中打开，您可以在 IDE 中继续工作。 创建的工作区已添加到 最近工作区 部分。 如果已有工作区，它们会被添加到最近工作区列表中，您可以随时点击所需工作区旁边的 连接 连接到这些工作区。 ![最近工作区](https://resources.jetbrains.com/help/img/idea/2026.3/recent_workspaces.png) 如果您想直接从 Gitpod 连接到 JetBrains Gateway，请参阅 [Gitpod 文档](https://www.gitpod.io/changelog/jetbrains-desktop-available-in-beta)。 ## 连接 Amazon CodeCatalyst 开发环境 > **Note:** > Amazon CodeCatalyst 已于 2025 年 11 月 7 日起停止接受新客户 这些说明适用于现有客户。 有关详细信息，请参阅 [AWS 可用性通知](https://aws.amazon.com/codecatalyst/)。 Amazon CodeCatalyst 是一个面向软件开发团队的基于云的协作空间。 您可以使用 JetBrains Gateway 连接到 Amazon CodeCatalyst ，以处理您的远程项目。 或者，您可以从 CodeCatalyst 端连接并在 JetBrains Client 中打开您的项目。 Amazon CodeCatalyst 可以通过 AWS Toolkit 插件在 JetBrains Gateway 中使用，您可以使用它连接到现有环境或创建新环境并在 IntelliJ IDEA 中使用。 在您尝试连接之前，请确保满足以下先决条件： * 您必须拥有一个有效的 AWS Builder ID 和 CodeCatalyst 帐户。 * 您已安装并启用 [AWS Toolkit](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)。 Procedure: 从 JetBrains Gateway 连接到您的开发环境 1. 启动 [JetBrains Gateway](#launch_gateway)。 2. 点击屏幕底部的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.gear.svg)，然后选择 管理提供商 。 3. 在打开的页面上，找到 AWS Toolkit ， [安装并启用](managing-plugins.html#install_plugin_from_repo) 该插件。 该插件会添加到 连接 列表中。 4. 从左侧选项中选择 所有提供商 。 5. 从右侧的选项中找到 Amazon CodeCatalyst 并点击 登录 AWS Builder ID 。 6. 在向导的下一页中，登录到您的 AWS 帐户。 ![登录 AWS Builder ID](https://resources.jetbrains.com/help/img/idea/2026.3/connect_to_AWS_builder.png) 7. 选择 IDE，添加创建开发环境所需的信息，然后点击 创建开发环境 。 ![创建新的 Dev 环境](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_dev_env.png) 开发环境已创建，项目在 IDE 中打开。 ![打开项目](https://resources.jetbrains.com/help/img/idea/2026.3/project_aws.png) 您还可以从 Amazon CodeCatalyst 控制台创建一个 Dev Environment，并使用 JetBrains Gateway 连接到它。 Procedure: 从 Amazon CodeCatalyst 连接 1. 登录到您的 Amazon CodeCatalyst 帐户。 2. 在创建的 Space 中，找到并打开您的 Project。 3. 如果您没有设置开发环境，请点击 创建开发环境 。 4. 在可用的 IDE 列表中，选择您需要的那个，添加必要的信息，然后点击 创建 。 ![创建开发环境](https://resources.jetbrains.com/help/img/idea/2026.3/create_dev_env_from_aws.png) Dev 环境已创建并显示活动状态。 5. 点击 继续在 打开 JetBrains Gateway 并在 JetBrains Client 中打开项目。 ![在 JetBrains Gateway 中打开](https://resources.jetbrains.com/help/img/idea/2026.3/open_jetbrains_gateway_from_aws.png) 当开发环境准备就绪时，项目将在 IDE 中打开，您可以在其中进一步处理。 ## 连接 Coder 您可以使用 JetBrains Gateway 连接到 [Coder](https://coder.com/docs/v2/latest)，以在远程项目上工作。 JetBrains Gateway 中提供了 Coder 插件，您可以使用它连接到现有环境或创建新环境，并在 IntelliJ IDEA 中进行工作。 Procedure: 连接到 Coder 工作区 1. 启动 [JetBrains Gateway](#launch_gateway)。 2. 点击屏幕底部的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.build.task.svg)，然后选择 管理提供商 。 3. 在打开的页面上，找到 编码器 ， [安装并启用](managing-plugins.html#install_plugin_from_repo) 该插件。 该插件会添加到 连接 列表中。 4. 从左侧选项中选择 所有提供商 。 ![所有提供者](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers_coder.png) 5. 请确保您已在 [Coder](https://coder.com/docs/v2/latest/workspaces#create-workspaces) 中配置了工作区，并复制访问 URL。 ![Coder Workspace](https://resources.jetbrains.com/help/img/idea/2026.3/coder_workspace.png) 6. 在 JetBrains Gateway 中，点击 连接 Coder 。 7. 在向导的下一页，在 URL 字段中，粘贴 [已复制的 URL](#url)并点击 连接 。 ![连接到 Coder](https://resources.jetbrains.com/help/img/idea/2026.3/connecting_to_coder.png) 8. 从浏览器中复制会话令牌，并将其粘贴到 会话令牌 字段中的 JetBrains Gateway。 ![会话令牌](https://resources.jetbrains.com/help/img/idea/2026.3/session_token.png) 点击 OK 。 9. 当所有内容都已认证完毕，您将看到已配置的工作区列表，选择所需的一个并点击 选择 IDE 和项目 。 10. 在向导的下一页中，选择所需的 IDE 并指定工作区中项目的路径。 如果您需要使用工作区终端，请点击 使用终端 。 ![IDE 和项目路径](https://resources.jetbrains.com/help/img/idea/2026.3/ide_and_project_coder.png) 当所有内容都选中后，请点击 启动 IDE 并连接 。 在 JetBrains Client 中打开包含所选项目的 Coder 开发环境，您可以在 IDE 中继续工作。 ## 连接到 JetBrains CodeCanvas [JetBrains CodeCanvas](https://www.jetbrains.com/zh-cn/help/codecanvas/introduction.html) 是一种解决方案，可以让公司将软件开发从个人用户机器转移到远程开发环境。 您可以使用 JetBrains Gateway 连接到 CodeCanvas ，以处理您的远程项目。 或者，您可以从 CodeCanvas 端连接并在 JetBrains Client 中打开您的项目。 JetBrains CodeCanvas 可在 JetBrains Gateway 中通过 CodeCanvas 插件使用，您可以用它连接到现有环境，或创建新环境并在 IntelliJ IDEA 中使用。 Procedure: 连接到 Code Canvas 开发环境 1. 启动 [JetBrains Gateway](#launch_gateway)。 CodeCanvas 插件默认已启用。 2. 从左侧选项中选择 所有提供商 。 ![所有提供者](https://resources.jetbrains.com/help/img/idea/2026.3/all_providers_code_canvas.png) 3. 在 JetBrains Gateway 中，点击 连接到 CodeCanvas 。 4. 在向导的下一页中，输入访问 URL 并点击 继续在浏览器中 。 5. 在打开的浏览器窗口中，点击 Accept 以授予所需权限。 如果尚未登录 CodeCanvas web 应用，系统还会提示输入用户名和密码。 然后将把您重定向回 JetBrains Gateway。 6. 点击 新环境 并配置新的开发环境（如果项目已有必要的开发环境，请跳过此步骤）： * 选择要用于开发环境的 [模板](https://www.jetbrains.com/zh-cn/help/codecanvas/get-started-as-namespace-administrator.html#create-a-dev-environment-template)。 * 环境名称 会自动选中。 * 选择必要的分支和可用的预热快照。 点击 创建环境 。 ![创建环境](https://resources.jetbrains.com/help/img/idea/2026.3/create_dev_env_code_canvas.png) 7. 创建开发环境后，项目会在 JetBrains Client 中打开，您可以开始编码。 在 JetBrains Gateway 欢迎屏幕上，选择 JetBrains CodeCanvas 下的 连接 节点以查看现有开发环境的列表。 ![CodeCanvas 开发环境](https://resources.jetbrains.com/help/img/idea/2026.3/code_canvas_dev_environments.png) ## 连接到在 WSL2 上运行的项目 您可以配置 IDE 后端，使其直接在 WSL2 中启动。 在开始连接 WSL 之前，请确保已满足以下先决条件： * 计算机上已安装 Windows 10 或 11 版本，并在 WSL2 下安装了 Ubuntu 20.04 版本。 * Windows 计算机上已配置 WSL2。 有关详细信息，请参阅 [WSL2 配置](https://www.jetbrains.com/zh-cn/help/idea/how-to-use-wsl-development-environment-in-product.html#wsl-general)部分。 * 您至少有 200 GB 的可用空间、8 GB 内存和 4 个 CPU。 * 您使用了最新的 JetBrains Gateway EAP 构建版本。 * 您使用最新的 EAP 版本的后端 IDE。 Procedure: 连接到 WSL 1. 启动 [JetBrains Gateway](#launch_gateway)。 2. 在 所有提供商 列表中选择 WSL。 3. 从右侧选项中点击 新建连接 。 ![新建连接](https://resources.jetbrains.com/help/img/idea/2026.3/new_connection_wsl.png) 4. 在下一页，选择 WSL 实例并点击 下一步 。 ![选择 WSL 实例](https://resources.jetbrains.com/help/img/idea/2026.3/choose_wsl_instance.png) 5. 在下一页，选择 IDE 版本和要打开的项目。 点击 启动 IDE 并连接 。 ![选择 IDE 版本和项目](https://resources.jetbrains.com/help/img/idea/2026.3/choose_ide_and_project.png) 连接已建立，后端 IDE 已下载，项目会在 JetBrains Client 中打开。 从 IntelliJ IDEA 版本 2025.3 开始，您可以在后端运行于 WSL2 的同一窗口中打开远程项目。 不会打开其他窗口。 Procedure: 将 WSL 系统中的项目作为本地项目打开 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `高级设置` 。 2. 在 高级设置 页面上的搜索字段中，输入 Gateway 。 3. 在搜索结果中，确保已选择 将 WSL 项目作为本地项目原生打开(无需使用远程开发功能) 选项。 4. [连接到 WSL](#connect_to_wsl)，方法与平常一样。 项目会在不部署后端的情况下启动，并作为常规本地项目打开。