# 部署：连接选项卡 > For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt). 使用此选项卡选择 [访问 Web 服务器的方式](#accessType)并指定连接设置。 控件集取决于选择的服务器访问类型。 ## 所有服务器类型的常见设置 | 条目 | 描述 | | --- | --- | | 仅对该项目可见 | 选中此复选框以启用在其他项目中重用此服务器访问配置或服务器组。 * 选中复选框以将配置或服务器组的使用限制在当前项目。 此配置或服务器组无法在当前项目之外重复使用。 它不会出现在其他项目的可用配置列表中。 项目特定配置存储在 `.idea` 目录中。 在 [通过版本控制](version-control-integration.html)共享这些文件之前，请先查看它们。 可用于所有项目的服务器配置存储在 IDE 设置中。 在左侧面板的服务器访问配置列表中，当前项目中仅可见的配置标有 ![仅在当前项目中可见的图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.projectConfigurable.svg) 图标。 * 当复选框被清除时，配置或服务器组在所有 IntelliJ IDEA 项目中可见。 其设置可在多个项目之间复用。 有关设置解释器的更多信息，请参阅 [Node.js via SSH](node-via-ssh.html)和 [配置远程 PHP 解释器](https://www.jetbrains.com.cn/help/phpstorm/configuring-remote-interpreters.html)。 | | 类型 | 在此列表中选择访问服务器的方式。 可用选项包括： * 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) 扩展程序）访问服务器。 | | Web 服务器 URL | 在此字段中，指定与服务器配置文件中指定的服务器文档目录相对应的 URL 地址。 请在该字段中点击 ![在浏览器中打开 URL 图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolwindows.webToolWindow.svg) 以确保指定的服务器根 URL 地址可访问并指向正确的网页。 同时支持 HTTP 和 HTTPS 。 | ## FTP 和 FTPS 设置 | 条目 | 描述 | | --- | --- | | 主持人 | 在此字段中，指定要将文件上传到的服务器主机名称。 | | 端口 | 在此字段中，指定要使用的端口。 默认值是 21。 | | 根路径 | 在此字段中，指定用于浏览远程文件系统以及设置服务器路径映射和排除路径的远程目录根文件夹。 请执行以下操作之一： * 接受默认的 `/` 路径，该路径指向服务器上的 根 文件夹。 * 手动输入路径，或点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，并在打开的 选择根路径 对话框中选择所需文件夹。 * 点击 自动检测 。 IntelliJ IDEA 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 仅在指定凭据后，此按钮才会启用。 | | 自动检测 | 点击此按钮，令 IntelliJ IDEA 检测服务器上的用户主文件夹设置并相应地设置 根路径 。 | | 用户名 | 在此字段中，输入用于对服务器进行身份验证的用户名。 | | 密码 | 在此字段中，输入用于对服务器进行身份验证的密码。 | | 以匿名身份登录 | 选中此复选框以启用 [匿名访问](https://en.wikipedia.org/wiki/File_Transfer_Protocol#Anonymous_FTP)服务器，并使用您的电子邮件地址作为密码。 | | 保存密码 | 选中此复选框以使 IntelliJ IDEA 记住指定的密码。 | | 测试连接 | 点击此按钮以检查指定设置是否可确保连接成功。 仅在已指定用户凭据时，此按钮才会启用。 | ### 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 功能，并让 IntelliJ IDEA 回退到通过 TLS 1.2 进行连接。 如果在与服务器建立连接或上传某些文件时遇到问题，请使用此选项。 > **Note:** > IntelliJ IDEA 支持通过 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 ``` 选择此选项可能会减慢与服务器的同步速度。 * 而不是使用 MLSD ：选中此复选框以使用标准 `LIST` 命令列出内容，而不是 `MLSD` 命令。 这可以帮助您避免问题，例如，如果 FTP 服务器支持 `MLSD` 并返回 `cdir` ，在上传时因 无效的子文件名 异常而失败。 | FTP，FTPS | | 连接数 | 在此字段中，指定要同时支持的最大连接数。 | FTP，FTPS | | 每次发送保持活动消息 | 在此字段中，指定您希望 IntelliJ IDEA 多久向服务器发送命令以重置超时，从而保持连接。 | FTP，FTPS | | 保持活动命令 | 从此列表中，选择要发送到服务器以重置超时并保持连接的命令。 | FTP，FTPS | | 客户端与服务器通信的编码 | 在此字段中，指定与您的服务器使用的编码相匹配的编码。 如果不确定其是否支持 UTF-8 编码，请接受默认值。 | FTP，FTPS | ## SFTP 设置 | 条目 | 描述 | | --- | --- | | SSH 配置 | 从此列表中，选择已创建的 SSH 配置之一，或点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg)并按照 [创建 SSH 配置](create-ssh-configurations.html)中的描述创建新配置。 | | 测试连接 | 点击此按钮以检查指定设置是否可确保连接成功。 仅在已指定用户凭据时，此按钮才会启用。 | | 根路径 | 在此字段中，指定用于浏览远程文件系统以及设置服务器路径映射和排除路径的远程目录根文件夹。 请执行以下操作之一： * 接受默认的 `/` 路径，该路径指向服务器上的 根 文件夹。 * 手动输入路径，或点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，并在打开的 选择根路径 对话框中选择所需文件夹。 * 点击 自动检测 。 IntelliJ IDEA 会检测 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)，并同时安装 `rsync` 和 `openssh` 软件包。 这些工具的可执行文件通常位于 `\bin` 文件夹中。 * 如有必要，请覆盖 Rsync 选项 字段中的 Rsync 命令行参数。 默认情况下，使用 `-zar` 选项，因此 Rsync 将压缩传输的数据（ `z` ）、保留传输文件和文件夹的权限、所有权和时间戳（ `a` ），并递归到子目录（ `r` ）。 有关可用选项的完整列表，请参阅 [Rsync 文档](https://linux.die.net/man/1/rsync)。 | ### SFTP 高级设置 在 高级 区域，通过为 SFTP 服务器配置指定附加的协议特定选项来自定义上传/下载。 | 条目 | 描述 | | --- | --- | | 连接数 | 在此字段中，指定要同时支持的最大连接数。 | | 每次发送保持活动消息 | 在此字段中，指定您希望 IntelliJ IDEA 多久向服务器发送命令以重置超时，从而保持连接。 > **Note:** > 对于 SFTP，此选项已禁用。 您可以在 [SSH Configurations](settings-tools-ssh-configurations.html#connection-parameters) 设置中配置 SFTP 的 keep alive 间隔。 | | 客户端与服务器通信的编码 | 在此字段中，指定与您的服务器使用的编码相匹配的编码。 如果不确定其是否支持 UTF-8 编码，请接受默认值。 | ## WebDAV 设置 | 条目 | 描述 | | --- | --- | | 主持人 | 在此字段中，指定要将文件上传到的服务器主机名称。 | | 端口 | 在此字段中，指定要使用的端口。 默认值是 6180。 | | 用户名 | 在此字段中，输入用于对服务器进行身份验证的用户名。 | | 密码 | 在此字段中，输入用于对服务器进行身份验证的密码。 | | 以匿名身份登录 | 选中此复选框以启用匿名访问服务器。 | | 保存密码 | 选中此复选框以使 IntelliJ IDEA 记住指定的密码。 | | 测试连接 | 点击此按钮以检查指定设置是否可确保连接成功。 | ## 本地或挂载文件夹设置 | 条目 | 描述 | | --- | --- | | 文件夹 | 在此字段中，指定在您的服务器配置文件中定义的服务器文档根目录的绝对路径。 除了文档根目录本身之外，还可以指定文档根目录下的任何其他现有文件夹。 文档根目录是 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)