WebStorm 2025.2 Help

创建远程服务器配置

远程服务器配置中,服务器运行于另一台计算机(远程主机)上。 要访问远程服务器上的文件,请使用 FTP/SFTP/FTPS/WebDAV 协议。

要在 WebStorm 中创建远程服务器配置,您需要:

  1. 在安装了 Web 服务器的远程主机与 WebStorm 之间 进行身份验证并设置连接

  2. 在 WebStorm 项目与主机上的项目文件夹及其对应的 URL 路径之间 配置映射

1. 指定服务器配置的名称、类型和可见性

  1. Ctrl+Alt+S 以打开设置,然后选择 构建、执行、部署 | 部署

    或者,在主菜单中转到 工具 | 部署 | 配置

  2. 在列出所有现有服务器配置的左侧窗格中,点击 添加条目 ,然后根据计划与服务器交换数据所使用的协议,选择服务器配置类型。

    • FTP :选择此选项可让 WebStorm 通过 FTP 文件传输协议 访问服务器。

    • SFTP :选择此选项可让 WebStorm 通过 SFTP 文件传输协议访问服务器。

    • FTPS :选择此选项可让 WebStorm 通过基于 SSL 的 FTP 文件传输协议(FTPS 扩展)访问服务器。

    • WebDAV :选择此选项可让 WebStorm 通过 WebDAV 文件传输协议(WebDAV 扩展)访问服务器。

    创建远程服务器配置(SFTP):选择服务器类型
  3. 在打开的 创建新服务器 对话框中,输入到服务器的连接名称,然后点击 确定创建新服务器 对话框关闭,您将返回到 连接 选项卡中的 部署 节点。

  4. 在服务器列表中选择要设为默认服务器的项,然后点击工具栏上方的 “设为默认”按钮设为默认将其标记为默认服务器

  5. 取消选中 仅对本项目可见 复选框,以便在其他项目中重用此服务器访问配置。

2. 设置与远程主机及其服务器的连接

连接 选项卡(Ctrl+Alt+S| 构建、执行、部署 | 部署 )中,指定远程主机访问、文件传输参数和 Web 服务器配置的设置:

  1. 指定主机地址、端口号以及用于访问的用户凭据。 所需字段因所使用的协议类型而异。

    创建远程服务器:SFTP 连接
    • SSH 配置: 从列表中选择一个之前创建的 SSH 配置,或点击 “浏览”按钮 并按照 创建 SSH 配置 中的说明创建新配置。

    • 使用rsync 下载/上传/同步: 选中复选框,让 WebStorm 使用 Rsync 来上传和下载文件,以提高文件传输速度。

      点击 Rsync 设置 打开 Rsync 设置页面 并配置 Rsync。

    创建远程服务器:FTP 连接
    • 主机: 指定用于交换数据的服务器主机名。

    • 端口: 指定该服务器监听的端口。 FTP/FTPS 的默认值为 21。 WebDAV 的默认值为 6180

    • 用户名(U)密码 :请提供在主机注册时使用的用户名和密码。

      选中 保存密码(V) 复选框,将密码永久存储在 WebStorm 中(否则,仅在 IDE 重启前保存)。

      或者,选中 匿名登录(N) 复选框,启用匿名身份验证,并使用电子邮件地址作为密码。

  2. 设置与远程主机 Web 服务器的连接:

    • 根路径(R) :指定用于浏览远程文件系统并设置服务器路径映射和排除路径的远程目录根文件夹。

      执行以下操作之一:

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

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

      • 单击 自动检测。 WebStorm 会在 FTP/SFTP 服务器上检测用户主文件夹设置,并根据这些设置配置根路径。 仅在指定凭据后,该按钮才可用。

    • Web 服务器 URL(W) :为 根路径 中指定的文件夹配置的 URL 地址。 支持 HTTPHTTPS

      单击字段右上角的 浏览 以打开并检查所提供的 Web 服务器 URL。

  3. (可选)展开 高级 部分,根据以下说明配置更多设置:

3. 将项目文件夹映射到服务器文件夹和 URL 路径

映射 选项卡中(Ctrl+Alt+S| 构建、执行、部署 | 部署 ),指定:

  1. 本地路径 :本地项目文件夹的绝对路径。 WebStorm 会自动使用当前打开项目的路径填充该字段。

  2. 部署路径 :服务器根目录下的某个文件夹,WebStorm 将把 本地路径 字段中指定的项目文件夹内容上传到该文件夹中。

    如果服务器中尚不存在指定名称的文件夹,则在触发 项目上传 时,WebStorm 会创建该文件夹。

  3. Web 路径 :为 部署路径 中指定的文件夹配置的 URL 路径。 您可以使用斜杠(/ )指向根文件夹,如果该目录无法通过 Web 访问,则可以将此字段留空。

    远程服务器:映射

现在已添加服务器配置,您可以在 Remote Host 工具窗口 中访问服务器的文件和文件夹。 转到主菜单中的 工具 | 部署 | 浏览远程主机 ,在打开的工具窗口中,从下拉列表中选择已配置的服务器。

打开“远程主机”工具窗口并选择服务器
最后修改日期: 2025年 9月 26日