# 创建远程服务器配置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 构建、执行、部署 | 部署`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 构建、执行、部署 | 部署`  适用于 macOS

在  remote server  配置中，服务器运行在另一台计算机（远程主机）上。 要访问远程服务器上的文件，请使用 FTP/SFTP/FTPS/WebDAV 协议。

Procedure: 启用 FTP/SFTP/WebDAV Connectivity 插件

此功能依赖于 [FTP/SFTP/WebDAV Connectivity](https://plugins.jetbrains.com/plugin/13125-ftp-sftp-webdav-connectivity)插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用 FTP/SFTP/WebDAV 连接插件。

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. 找到  FTP/SFTP/WebDAV Connectivity  插件并点击   启用  。

要在 IntelliJ IDEA 中创建远程服务器配置，您需要：

1.  为远程文件服务器 [配置连接和身份验证](#server-url)。

2.  在远程主机上 [将本地项目文件夹映射到目标文件夹](#mapping)。 web URL 映射是可选的。

> **Note:**
> 对于 SSH 服务器，请使用 SFTP 加密凭据和文件传输。 普通 FTP 不会对它们进行加密。 部署配置会传输文件；不会启动 Go 应用程序。

Procedure: 1. 指定服务器配置的名称、类型和可见性

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. 在左侧窗格中列出所有现有的服务器配置，点击 ![添加项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 并根据您将要使用的协议选择服务器配置类型，以便与服务器交换数据。

* FTP ：选择此选项可使 IntelliJ IDEA 通过 FTP [文件传输协议](https://en.wikipedia.org/wiki/File_Transfer_Protocol) 访问服务器。

* SFTP ：选择此选项可让 IntelliJ IDEA 通过 [SFTP](https://en.wikipedia.org/wiki/SFTP) 文件传输协议访问服务器。

* FTPS ：选择此选项可使 IntelliJ IDEA 通过基于 SSL 的 FTP 文件传输协议（ [FTPS](https://en.wikipedia.org/wiki/FTPS) 扩展程序）访问服务器。

* WebDAV ：选择此选项可使 IntelliJ IDEA 通过 WebDAV 文件传输协议（ [WebDAV](https://en.wikipedia.org/wiki/WebDAV) 扩展程序）访问服务器。

3. 在打开的   创建新服务器  对话框中，输入与服务器的连接名称，然后点击   OK  。   创建新服务器   对话框关闭，您返回到 [连接](deployment-connection-tab.html) 选项卡的 [部署](settings-deployment.html) 节点。

4. 从服务器列表中选择要设为默认的服务器，然后点击服务器列表上方工具栏上的 ![Use as default 按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.setDefault.svg)   用作默认  ，以 [将服务器标记为默认](configuring-synchronization-with-a-remote-host.html#default_server)。

5. 取消选中   仅对该项目可见   复选框，以便在其他项目中重用此服务器访问配置。

> **Tip:**
> 项目特定配置存储在  `.idea`  目录中。 在 [通过版本控制](version-control-integration.html)共享这些文件之前，请先查看它们。 可用于所有项目的服务器配置存储在 IDE 设置中。

Procedure: 2. 设置与远程主机及其服务器的连接

在  `连接`  选项卡（ `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))  `| 构建，执行，部署 | 部署` ）中，指定远程主机访问、文件传输形参和 web 服务器配置的设置：

1. 请指定主机地址、端口和用户凭证以访问它。 所需字段因使用的协议类型而异。

SFTP:

![创建远程主机 SFTP 连接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/remote-host-sftp.png)

* SSH 配置： 从列表中选择一个之前创建的 SSH 配置，或点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg) 并按照 [创建 SSH 配置](create-ssh-configurations.html) 中的描述创建一个新配置。

* 使用 rsync 进行下载/上传/同步： 选中复选框以使 IntelliJ IDEA 使用 [Rsync](https://rsync.samba.org) 上传和下载文件，这可以提高文件传输速度。 点击 Rsync 设置 以打开 [Rsync 设置页面](settings-tools-rsync.html)并配置 Rsync。

FTP、FTPS、WebDav:

![创建远程主机 FTP、FTPS、WebDav 连接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/remote-host-ftp.png)

* 主机： 指定用于交换数据的服务器主机名。

* 端口: 指定此服务器监听的端口。 对于 FTP 和 FTPS，默认值为 `21` 。 对于 WebDAV，默认值是 `6180` 。

* 用户名 和 密码 ：提供在主机上注册时指定的用户名和密码。 勾选 保存密码 复选框以将密码永久存储在 IntelliJ IDEA 中（否则，它只会被存储到 IDE 重启为止）。 或者，也可以选择 以匿名身份登录 复选框，以启用服务器的匿名身份验证，并使用电子邮件地址作为密码。

2. 设置服务器根路径。 如果要在浏览器中打开已部署的文件，还要设置 web 服务器 URL：

* 根路径 ：指定用于浏览远程文件系统以及设置服务器路径映射和排除路径的远程目录根文件夹。 请执行以下操作之一： * 接受默认的 `/` 路径，该路径指向服务器上的 根 文件夹。 * 手动输入路径，或点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，并在打开的 选择根路径 对话框中选择所需文件夹。 * 点击 自动检测 。 IntelliJ IDEA 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 仅在指定凭据后，此按钮才会启用。

* Web 服务器 URL ：指定为 根路径 中指定的文件夹配置的 URL 地址。 支持 HTTP 和 HTTPS 。 点击字段右侧角落的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.toolwindow.web.svg) 浏览 ，以打开并检查提供的 Web 服务器 URL。

3. （可选）展开   高级   部分，以按照以下说明配置更多设置：

* [SFTP 高级设置](deployment-connection-tab.html#sftp-advanced-settings)

* [FTP 和 FTPS 高级设置](deployment-connection-tab.html#advanced-settings-area)

Procedure: 3. 将项目文件夹映射到服务器文件夹和 URL 路径

在  `映射`  选项卡（ `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))  `| 构建，执行，部署 | 部署` ）中，指定：

1. 本地路径  ：本地项目文件夹的绝对路径。 IntelliJ IDEA 会自动使用当前打开项目的路径填充此字段。

2. 部署路径  ：服务器根目录下的一个文件夹，IntelliJ IDEA 将在   本地路径   字段中指定的项目文件夹内容上传到该文件夹。

> **Tip:**
> 部署路径   相对于   连接   选项卡中指定的   根路径  。

如果服务器上尚不存在指定名称的文件夹，IntelliJ IDEA 会在触发 [项目上传](uploading-and-downloading-files.html#manually)时创建该文件夹。

3. Web path  ：为   部署路径   中指定的文件夹配置的 URL 路径。 可以使用斜杠（  `/` ）指向根文件夹；如果该目录无法从 Web 访问，则将该字段留空。

> **Tip:**
> Web path   相对于   连接   选项卡中指定的   Web 服务器 URL  。

> **Note:**
> 有些情况下，您可能希望为每个项目添加多个映射。 例如，您可以通过为其添加单独的映射来覆盖 IntelliJ IDEA 项目中特定  `nested-folder`  在服务器上的目标文件夹：
>
>
>
> ![高级远程服务器映射示例](https://resources.jetbrains.com.cn/help/img/idea/2026.3/remote_server_mapping_example.png)
>
> 在这种情况下，  `Users/John.Smith/demo-project/nested-folder`  将被上传到服务器上的  `/root-path/nested-folder` ，而  `/demo-project`  中的所有其他文件夹和文件仍将映射到  `/root-path/my-site` 。

现在已添加服务器配置，可以在 [远程主机工具窗口](remote-host-tool-window.html) 中访问服务器的文件和文件夹。 在主菜单中转到  `工具 | 部署 | 浏览远程主机` ，然后在打开的工具窗口中，从下拉菜单中选择已配置的服务器。

![打开远程主机工具窗口并选择该服务器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/select_server_in_remote_host_tool_window.png)

## See also

### 过程

[将文件部署到服务器](deploying-applications.html) [PHP](php-specific-guidelines.html) [创建就地服务器配置](creating-in-place-server-configuration.html) [创建本地服务器配置](creating-local-server-configuration.html)

### 参考

[部署](settings-deployment.html) [部署：连接选项卡](deployment-connection-tab.html)

