WebStorm 2025.2 Help

部署：连接选项卡

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

所有服务器类型的通用设置

项目

描述

仅对此项目可见

选中此复选框以在其他项目中重复使用此服务器访问配置或服务器组。

  • 选中此复选框可将配置或服务器组的使用限制在当前项目中。 该配置或服务器组无法在当前项目之外重复使用。 它不会出现在其他项目的可用配置列表中。

    服务器配置设置会与项目一起存储在 .idea 目录中，从而可以通过 版本控制系统 在团队成员之间共享。

    在左侧窗格的服务器访问配置列表中，只有当前项目可见的配置将使用 仅在当前项目中可见的图标 图标标记。

  • 清除复选框后，该配置或服务器组在所有 WebStorm 项目中均可见。 其设置可以在多个项目之间共享使用。

有关设置解释器的更多信息，请参阅 Node.js via SSH。

类型

在此列表中，选择访问服务器的方式。 可用选项包括：

  • FTP ：选中此选项以通过 FTP 文件传输协议 让 WebStorm 访问服务器。

  • SFTP ：选中此选项以通过 SFTP 文件传输协议让 WebStorm 访问服务器。

  • FTPS ：选中此选项以通过加密的 FTP 文件传输协议（FTPS 扩展）让 WebStorm 访问服务器。

  • WebDAV ：选中此选项以通过 WebDAV 文件传输协议（WebDAV 扩展）让 WebStorm 访问服务器。

Web 服务器 URL(W)

在此字段中，指定服务器文档目录对应的 URL 地址，该地址应在服务器配置文件中指定。 单击此字段中的 在浏览器中打开 URL 图标 ，以确保指定的服务器根 URL 地址可用且指向正确的网页。

支持 HTTP 和 HTTPS 协议。

FTP 和 FTPS 设置

项目

描述

主机

在此字段中，指定作为文件上传目标的服务器主机名。

端口

在此字段中，指定要使用的端口。默认值为 21。 默认值为 21。

根路径(R)

在此字段中，指定用于浏览远程文件系统并设置服务器路径映射和排除路径的远程目录根文件夹。

执行以下操作之一：

  • 接受默认的 / 路径，该路径指向服务器上的 根 文件夹。

  • 手动输入路径，或单击 浏览按钮 ，在打开的 选择根路径 对话框中选择所需的文件夹。

  • 单击 自动检测。 WebStorm 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并据此设置根路径。 只有指定了凭据后，按钮才会启用。

自动检测

单击此按钮后，WebStorm 将检测服务器上的用户主文件夹设置并相应设置 根路径。

用户名

在此字段中输入用于连接服务器的用户名进行身份验证。

密码

在此字段中输入用于连接服务器的密码进行身份验证。

匿名登录(N)

选中此复选框以启用对服务器的 匿名访问 ，并使用您的电子邮件地址作为密码。

保存密码(V)

选中此复选框以让 WebStorm 记住所输入的密码。

测试连接(C)

单击此按钮以验证所指定设置是否能够成功连接。 只有指定了用户凭据后，按钮才会启用。

FTP 和 FTPS 高级设置

在 高级 区域中，可通过指定 FTP/FTPS 服务器配置的附加协议专属选项来自定义上传/下载。

项目

描述

可用于

TLS

选择用于调用客户端安全性的方式：

  • 显式(X) ：将应用 显式（主动）安全。 建立连接后，您计算机上的 FTP 客户端会立即向服务器发送命令，通过默认 FTP 端口建立安全的控制连接。

  • 隐式(I) ：将应用 隐式（被动）安全。 在此情况下，安全性会在连接服务器时自动启用，服务器会为安全连接指定单独的端口。

    请注意， 隐式 方法已弃用，不建议使用。

FTPS

数据通道保护级别(D)

从此列表中设置 PROT 命令的保护级别：

  • <默认> ：将应用服务器的默认策略。

  • 清除 ：原始数据将在未应用安全措施的情况下传输。

  • Private ：已应用传输层安全性（TLS）或安全套接字层（SSL）。

如需了解更多信息，请参阅关于 TLS、 SSL 2.0 和 SSL 3.0 的文章。

FTPS

重用SSL 会话

选中此复选框以连接到要求在控制连接与数据连接之间重用 SSL 会话的服务器。

FTPS

禁用TLS 1.3

选择此项可禁用 TLS 1.3 功能，使 WebStorm 回退为通过 TLS 1.2 进行连接。 如果在连接服务器或上传某些文件时遇到问题，请使用此选项。

FTPS

被动模式(P)

选中此复选框可将本机客户端设置为 被动模式 ，连接服务器时将通知其处于被动模式，并接收要侦听的端口号，然后通过该端口建立数据连接。 您的计算机位于防火墙之后时，此模式将非常有用。

FTP、FTPS

显示并处理隐藏文件(S)

选中此复选框后：

  1. 在 Remote Host Tool Window 中显示隐藏文件和目录。

  2. 隐藏文件和目录将参与 diff 和 同步 操作。

隐藏文件或目录的名称以点号 . 开头。

FTP、FTPS

使用LIST 命令

使用此区域中的选项配置 LIST 命令的使用方式。

  • 与旧版本的列示子项兼容(C) ：选中此复选框以确保与 FTP 服务器的 子文件命名兼容性。

    如果远程 FTP 服务器报告以下错误，则此选项会很有帮助：

    Invalid descendant file name <file name>

    选择此选项可能会降低与服务器的同步速度。

  • 代替MLSD ：选中此复选框以使用标准的 LIST 命令替代 MLSD 命令进行列出操作。 此操作可避免出现问题，例如，如果 FTP 服务器支持 MLSD 并返回 cdir ，则上传时会因 Invalid descendent file name 异常而失败。

FTP、FTPS

连接数(E)

在此字段中，指定支持的最大并发连接数。

FTP、FTPS

发送保持活动消息的间隔(K)

在此字段中，指定希望 WebStorm 向服务器发送命令以重置超时并保持连接的频率。

FTP、FTPS

保持活动命令(A)

在此列表中，选择要发送到服务器以重置超时并保持连接的命令。

FTP、FTPS

客户端-服务器通信编码 (E)

在此字段中，指定编码，该编码必须与您的服务器所使用的编码相匹配。 如果不确定是否支持 UTF-8 编码，请接受默认值。

FTP、FTPS

SFTP 设置

项目

说明

SSH 配置(S)

在此列表中，从中选择一个已创建的 SSH 配置，或点击 “浏览”按钮 并根据 创建 SSH 配置 中的说明创建新配置。

测试连接(C)

点击此按钮以检查指定设置是否可以确保成功连接。 仅在已指定用户凭据后，此按钮才会启用。

根路径(R)

在此字段中，指定作为远程目录根目录的文件夹，用于浏览远程文件系统并设置服务器路径映射与排除路径。

执行以下任一操作：

  • 接受默认的 / 路径，该路径指向服务器上的 根 文件夹。

  • 手动输入路径或点击 浏览按钮 并在打开的 选择根路径 对话框中选择所需文件夹。

  • 点击 自动检测。 WebStorm 将检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 仅在您已指定凭据后，此按钮才启用。

使用 Rsync 进行下载／上传／同步

选中此复选框以使用 Rsync 同步部署配置。

Rsync 设置

点击此链接，在打开的对话框中配置 Rsync 设置：

  • 提供 rsync 和 ssh 可执行文件的路径。

    • 在 macOS 和 Linux 上， rsync 与 ssh 工具是预安装的，其路径将自动填写。

    • 在 Windows 上，您需要先手动安装带有 rsync 和 openssh 软件包的 Cygwin。 这些工具的可执行文件通常位于 <Cygwin 安装目录>\bin 文件夹中。

  • 如有需要，请在 Rsync 选项 字段中覆盖 Rsync 命令行参数。

    默认使用 -zar 选项，使得 Rsync 会压缩传输数据（z ）、保留传输文件与文件夹的权限、所有权和时间戳（a ），并递归进入子目录（r）。

    完整可用选项列表请参阅 Rsync 文档。

SFTP 高级设置

在 高级 区域中，修改上传／下载设置并为 SFTP 服务器配置指定额外的协议相关选项。

项目

说明

连接数(E)

在此字段中，指定支持的最大并发连接数。

发送保持活动消息的间隔(K)

在此字段中，指定希望 WebStorm 向服务器发送命令以重置超时并保持连接的频率。

客户端-服务器通信编码 (E)

在此字段中，指定与服务器使用的编码相匹配的编码方式。 如果不确定服务器是否支持 UTF-8编码，请接受默认值。

WebDAV 设置

项目

说明

主机

在此字段中，指定要将文件上传到的服务器主机名。

端口

在此字段中，指定要使用的端口。默认值为 6180。 默认值为 6180。

用户名

在此字段中，输入用于服务器身份验证的用户名。

密码

在此字段中，输入用于服务器身份验证的密码。

匿名登录(N)

选中此复选框以启用对服务器的匿名访问。

保存密码(V)

选中此复选框以便 WebStorm 记住指定的密码。

测试连接(C)

单击此按钮以检查指定设置是否能确保连接成功。

本地或挂载文件夹设置

项目

说明

文件夹(F)

在此字段中，指定服务器配置文件中定义的服务器文档根目录的绝对路径。除了文档根目录本身，还可以指定文档根目录下的任何其他现有文件夹。 除了文档根目录本身，还可以指定文档根目录下的任何其他现有文件夹。

文档根目录是 Web 服务器用于向 Web 服务器 URL 提供文件的文件夹。

最后修改日期： 2025年 9月 26日
部署部署：映射选项卡