# 创建本地服务器配置

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

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

本地服务器 通过本地 URL 提供本地或已挂载文件夹中的文件。 在本地服务器配置中，在  IntelliJ IDEA 项目 中开发应用程序，然后将项目文件上传到服务器的  文档根目录 ，即服务器提供文件的文件夹。

要在 IntelliJ IDEA 中创建本地服务器配置，请 [配置连接](#server-url)至服务器。 然后，将 [项目文件夹映射](#mapping)到服务器上的目标文件夹和对应的 URL 路径。

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  插件并点击   启用  。

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)，然后在弹出菜单中选择   本地或已挂载的文件夹  。

![添加本地或挂载文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/select_local_server_type.png)

3. 在打开的   创建新服务器   对话框中，输入要创建的服务器名称，然后点击   OK  。   创建新服务器   对话框将关闭，并返回到 [部署](settings-deployment.html) 节点的 [连接](deployment-connection-tab.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 服务器将文件提供给 Web 服务器 URL 的文件夹。

> **Note:**
> 示例：
>
>
>
> *
>
> * `/var/www/html` 或 `/usr/local/apache/htdocs` ，适用于本地独立安装的 Apache 服务器。

* Web 服务器 URL  ：在服务器配置文件中映射到服务器文档根目录的 URL 地址（主机名和（可选）端口）。 这是应用程序 Web 地址的基础 URL。 同时支持  HTTP  和  HTTPS 。

> **Note:**
> 示例：
>
>
>
> * `http://localhost:80`
>
> * `http://localhost:80/MySite1` （如果选择在服务器文档根目录下建立更复杂的文件夹结构，并在当前配置中仅使用其中一个子文件夹）

点击字段右侧角落的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.toolwindow.web.svg)   浏览  ，以打开并检查提供的 Web 服务器 URL。

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))  `| 构建，执行，部署 | 部署` ）中，指定在 IntelliJ IDEA 中打开的项目与服务器文档根目录下对应文件夹之间的映射：

![部署映射选项卡](https://resources.jetbrains.com.cn/help/img/idea/2026.3/deployment_mappings_tab.png)

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

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

> **Tip:**
> 部署路径   是相对于   文件夹   在   连接   选项卡中指定的路径。

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

最简单的方法是将整个项目根文件夹映射到服务器文档根目录下的某个文件夹。 在这种情况下，项目文件夹结构将在服务器上重新创建。

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

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

> **Note:**
> 示例：
>
>
>
> * 本地路径 ： `Users/John.Smith/demo-project`
>
> * 部署路径 ： `/my-project`
>
> * Web path ： `/my-project`

现在已添加服务器配置，可以在 [远程主机工具窗口](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) [创建就地服务器配置](creating-in-place-server-configuration.html) [创建远程服务器配置](creating-a-remote-server-configuration.html) [PHP](php-specific-guidelines.html)

### 参考

[部署：映射选项卡](deployment-mappings-tab.html) [部署](settings-deployment.html)