# 部署：连接选项卡

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

使用此选项卡选择 [访问 Web 服务器的方式](#accessType)并指定连接设置。 控件集取决于选择的服务器访问类型。

## 所有服务器类型的常见设置

|  项  |  描述  |
| --- | --- |
|  仅对该项目可见  |     使用此复选框可启用在其他项目中重用此服务器访问配置或服务器组。        * 选中复选框以将配置或服务器组的使用限制在当前项目。 此配置或服务器组无法在当前项目之外重复使用。 它没有出现在其他项目的可用配置列表中。 项目特定配置存储在 `.idea` 目录中。 在 [通过版本控制](version-control-integration.html) 共享这些文件之前，请先检查这些文件。 可供所有项目使用的服务器配置存储在 IDE 设置中。 在左侧面板的服务器访问配置列表中，当前项目中仅可见的配置标有 ![仅在当前项目中可见的图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.projectConfigurable.svg) 图标。    * 当复选框被清除时，配置或服务器组在所有 CLion 项目中可见。 其设置可以在多个项目中重复使用。    |
|  Type  |     在此列表中选择访问服务器的方式。 可用选项包括：        * FTP ：选择此选项让 CLion 通过 FTP [文件传输协议](https://en.wikipedia.org/wiki/File_Transfer_Protocol) 访问服务器。    * SFTP ：选择此选项，使 CLion 通过 [SFTP](https://en.wikipedia.org/wiki/SFTP) 文件传输协议访问服务器。    * FTPS ：选择此选项可通过 SSL 的 FTP 文件传输协议（ [FTPS](https://en.wikipedia.org/wiki/FTPS) 扩展）让 CLion 访问服务器。    * WebDAV ：选择此选项以便 CLion 通过 WebDAV 文件传输协议（ [WebDAV](https://en.wikipedia.org/wiki/WebDAV) 扩展名）访问服务器。    |
|  Web 服务器 URL  |     在此字段中，指定与服务器配置文件中指定的服务器文档目录相对应的 URL 地址。 请在该字段中点击 ![在浏览器中打开 URL 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.webToolWindow.svg) 以确保指定的服务器根 URL 地址可访问并指向正确的网页。   同时支持  HTTP  和  HTTPS 。  |

## FTP 和 FTPS 设置

|  项  |  描述  |
| --- | --- |
|  主机  |  在此字段中，指定要将文件上传到的服务器主机名称。  |
|  端口  |     在此字段中，指定要使用的端口。 默认值是 21。     |
|  根路径  |     在此字段中，指定用作远程目录根目录的文件夹，以便浏览远程文件系统并设置服务器路径映射和排除的路径。    请执行以下操作之一：        * 接受默认的 `/` 路径，它指向服务器上的 root 文件夹。    * 手动输入路径或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)并在打开的 选择根路径 对话框中选择所需文件夹。    * 点击 自动检测 。 CLion 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 只有在指定了您的凭证时，按钮才会启用。       |
|  自动检测  |  点击此按钮，令 CLion 检测服务器上的用户主文件夹设置并相应地设置   根路径  。  |
|  用户名  |  在此字段中，输入用于对服务器进行身份验证的用户名。  |
|  密码  |  在此字段中，输入用于对服务器进行身份验证的密码。  |
|  以匿名身份登录  |  选中此复选框以启用 [匿名访问](https://en.wikipedia.org/wiki/File_Transfer_Protocol#Anonymous_FTP)服务器，并使用您的电子邮件地址作为密码。  |
|  保存密码  |  选中此复选框以使 CLion 记住指定的密码。  |
|  测试连接  |  点击此按钮以检查指定的设置是否可确保连接成功。 仅在指定了用户凭据后，此按钮才会启用。  |

### FTP 和 FTPS 高级设置

在   高级   区域，您可以通过为 FTP/FTPS 服务器配置指定额外的协议特定选项来自定义上传/下载。

|  项  |  描述  |  适用于  |
| --- | --- | --- |
|  TLS  |     选择调用客户端安全性的方法：        * 显式 ：应用了 [显式（主动）安全性](https://www.smartftp.com/support/kb/what-is-the-difference-between-implicit-ssl-and-explicit-ssl-f189.html)。 在连接建立后，您机器上的 FTP 客户端会向服务器发送命令，通过默认的 FTP 端口建立安全控制连接。    * 隐式 ：应用了 [隐式（被动）安全性](https://www.smartftp.com/support/kb/what-is-the-difference-between-implicit-ssl-and-explicit-ssl-f189.html)。 在这种情况下，安全性在与服务器建立连接时自动提供，该服务器设置了一个用于安全连接的独立端口。 请注意， Implicit 方法已被视为弃用，不建议使用。    |  FTPS  |
|  数据通道保护级别  |     从此列表中，为 PROT 命令设置保护级别：        * <默认> ：已应用默认服务器策略。    * 清除 ：原始数据在没有应用安全措施的情况下被传输。    * 私有 ：已应用传输层安全 (TLS) 或安全套接字层 (SSL)。      如需更多信息，请参阅有关 [TLS](https://en.wikipedia.org/wiki/Transport_Layer_Security#TLS)、 [SSL 2.0](https://en.wikipedia.org/wiki/Transport_Layer_Security#SSL_2.0)和 [SSL 3.0](https://en.wikipedia.org/wiki/Transport_Layer_Security#SSL_3.0)的文章。     |  FTPS  |
|  重用 SSL 会话  |  选中此复选框以连接到需要在控制和数据连接之间重复使用 SSL 会话的服务器。  |  FTPS  |
|  禁用 TLS 1.3  |     选择禁用 TLS 1.3 功能，并让 CLion 回退到通过 TLS 1.2 进行连接。 如果您在连接服务器或上传某些文件时遇到问题，请使用此选项。      > **Note:** > CLion 支持通过 TLS 1.2 及更高版本连接到服务器。 TLS 1.0 和 TLS 1.1 已不再受支持，因为这些协议 [已被弃用](https://datatracker.ietf.org/doc/rfc8996/)且被认为不安全。    |  FTPS  |
|  被动模式  |     选中此复选框可将计算机上的客户端设置为 [被动模式](https://slacksite.com/other/ftp.html)，这样在连接到服务器时，它会通知服务器自己处于被动模式，接收要侦听的端口号，并通过收到编号的端口建立数据连接。 此模式在您的机器处于防火墙后面时非常有用。     |  FTP、FTPS  |
|  显示并处理隐藏文件  |     选中此复选框时：        1.  隐藏文件和目录显示在 [Remote Host Tool Window](remote-host-tool-window.html)中。     2.  隐藏文件和目录会参与 [diff](https://en.wikipedia.org/wiki/Diff) 和 [同步](https://en.wikipedia.org/wiki/File_synchronization) 操作。       隐藏文件或目录的名称以点开头  `.` 。     |  FTP、FTPS  |
|  使用 LIST 命令  |     使用此区域中的选项配置 LIST 命令使用。        * 兼容旧版本子项列表方式 ：选中此复选框可确保与 FTP 服务器的 [子文件命名兼容性](https://issues.apache.org/jira/browse/VFS-310)。 此选项在远程 FTP 服务器报告以下错误时很有帮助： ```SHELL Invalid descendant file name <file name> ``` 选择此选项可能会减慢与服务器的同步速度。    * 替代 MLSD ：选中此复选框可使用标准 `LIST` 命令进行列表显示，而不是使用 `MLSD` 命令。 这样可以避免出现问题，例如，上传期间因 无效的后代文件名称 异常而失败（如果 FTP 服务器支持 `MLSD` 并返回 `cdir` ）。    |  FTP、FTPS  |
|  连接数  |     在此字段中，指定要同时支持的最大连接数。     |  FTP、FTPS  |
|  每隔...发送保持活动消息  |  在此字段中，指定希望 CLion 向服务器发送命令以重置超时并因此保持连接的频率。  |  FTP、FTPS  |
|  保持活动命令  |     从此列表中，选择要发送到服务器以重置超时并因此保持连接的命令。     |  FTP、FTPS  |
|  客户端-服务器通信编码  |     在此字段中，指定与服务器所用编码相匹配的编码。 如果不确定其是否支持  UTF-8  编码，请接受默认值。     |  FTP、FTPS  |

## SFTP 设置

|  项  |  描述  |
| --- | --- |
|  SSH 配置  |     从此列表中，选择一个已创建的 SSH 配置，或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并按照 [创建 SSH 配置](create-ssh-configurations.html) 中的说明创建新配置。     |
|  测试连接  |  点击此按钮以检查指定的设置是否可确保连接成功。 仅在指定了用户凭据后，此按钮才会启用。  |
|  根路径  |     在此字段中，指定用作远程目录根目录的文件夹，以便浏览远程文件系统并设置服务器路径映射和排除的路径。    请执行以下操作之一：        * 接受默认的 `/` 路径，它指向服务器上的 root 文件夹。    * 手动输入路径或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)并在打开的 选择根路径 对话框中选择所需文件夹。    * 点击 自动检测 。 CLion 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 只有在指定了您的凭证时，按钮才会启用。       |
|  使用 Rsync 进行下载/上传/同步  |     选中此复选框以使用 [Rsync](https://rsync.samba.org) 来同步您的部署配置。      > **Note:** > Rsync 用于 [下载和上传（包括自动上传）文件](uploading-and-downloading-files.html) 以及部署文件和文件夹与其本地版本之间的 [同步](comparing-deployed-files-and-folders-with-their-local-versions.html)。 通过 SFTP 仍然可以在远程主机上删除和导航文件。    |
|  Rsync 设置  |     点击此链接以在打开的对话框中配置 Rsync 设置：        * 提供 `rsync` 和 `ssh` 可执行文件的路径。 * 在 macOS 和 Linux 上， `rsync` 和 `ssh` 工具是预装的，路径会自动填充。 * 在 Windows 上，您需要手动安装 [Cygwin](https://www.cygwin.com)或 [Msys2](https://www.msys2.org)，并首先安装 `rsync` 和 `openssh` 软件包。 工具的可执行文件通常位于 `<Cygwin/Msys2 installation>\bin` 文件夹中。 > **Note:** > 在 Windows 上通过 WSL 使用 Rsync 尚不支持（ [CPP-24327](https://youtrack.jetbrains.com/issue/CPP-24327)）。    * 如有必要，请覆盖 Rsync 选项 字段中的 Rsync 命令行参数。 默认情况下，将使用 `-zar` 选项，以便 Rsync 将压缩传输的数据( `z` )，保留传输文件和文件夹的权限、所有权和时间戳( `a` )，并递归进入子目录( `r` )。 要获取可用选项的完整列表，请参考 [Rsync 文档](https://linux.die.net/man/1/rsync)。    |

### SFTP 高级设置

在   高级  区域，通过为 SFTP 服务器配置指定附加的协议特定选项来自定义上传/下载。

|  项  |  描述  |
| --- | --- |
|  连接数  |     在此字段中，指定要同时支持的最大连接数。     |
|  每隔...发送保持活动消息  |     在此字段中，指定希望 CLion 向服务器发送命令以重置超时并因此保持连接的频率。      > **Note:** > 对于 SFTP，此选项已禁用。 您可以在 [SSH Configurations](settings-tools-ssh-configurations.html#connection-parameters) 设置中配置 SFTP 的 keep alive 间隔。    |
|  客户端-服务器通信编码  |     在此字段中，指定与服务器所用编码相匹配的编码。 如果不确定其是否支持  UTF-8  编码，请接受默认值。     |

## WebDAV 设置

|  项  |  描述  |
| --- | --- |
|  主机  |  在此字段中，指定要将文件上传到的服务器主机名称。  |
|  端口  |  在此字段中，指定要使用的端口。 默认值是 6180。  |
|  用户名  |  在此字段中，输入用于对服务器进行身份验证的用户名。  |
|  密码  |  在此字段中，输入用于对服务器进行身份验证的密码。  |
|  以匿名身份登录  |  选中此复选框以启用匿名访问服务器。  |
|  保存密码  |  选中此复选框以使 CLion 记住指定的密码。  |
|  测试连接  |  点击此按钮以检查指定的设置是否可确保连接成功。  |

## 本地或挂载文件夹设置

|  项  |  描述  |
| --- | --- |
|  文件夹  |     在此字段中，指定服务器配置文件中定义的服务器文档根目录的绝对路径。 除了文档根目录本身之外，您还可以指定文档根目录下的任何其他现有文件夹。    文档根目录是 Web 服务器将文件提供给 Web 服务器 URL 的文件夹。      > **Note:** > 示例： > > > > * > > * `/var/www/html` 或 `/usr/local/apache/htdocs` 可用于独立安装的本地 Apache 服务器。       |

## See also

### 语言和框架特定指南

[与 Web 服务器同步](configuring-synchronization-with-a-remote-host.html) [自定义上传和下载](customizing-upload.html)

### 参考

[部署](settings-deployment.html) [远程主机工具窗口](remote-host-tool-window.html)

