# 本地服务器配置

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

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

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

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

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `构建、执行、部署 | 部署` 。

或者，前往主菜单中的  `工具 | 部署 | 配置` 。

2. 在左侧窗格中，点击   Add   ![添加 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后在弹出菜单中选择   本地或已挂载的文件夹  。

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

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

4. 在服务器列表中，选择要设为默认的服务器，然后点击服务器列表上方工具栏中的 ![默认使用按钮](https://resources.jetbrains.com/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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (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 地址（主机名和（可选）端口）。 这是您的应用程序网址的基础 URL。 两者  HTTP  和  HTTPS  都支持。

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

请点击 ![](https://resources.jetbrains.com/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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))  `| 构建，执行，部署 | 部署` ）中，指定在 CLion 中打开的项目与服务器文档根目录下对应文件夹之间的映射：

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

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

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

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

如果服务器上尚不存在具有指定名称的文件夹，CLion 将在您触发 [project upload](uploading-and-downloading-files.html#manually)时创建它。

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

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

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

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

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

![打开 Remote Host 工具窗口并选择服务器](https://resources.jetbrains.com/help/img/idea/2026.3/select_server_in_remote_host_tool_window.png)

## See also

