PyCharm 2025.3 Help

创建远程服务器配置

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

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

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

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

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

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

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

  2. 在列出所有现有服务器配置的左侧窗格中,点击 添加项 ,并根据您将用于与服务器交换数据的协议选择服务器配置类型。

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

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

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

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

  3. 在打开的 创建新服务器 对话框中,输入到该服务器的连接名称,然后点击 确定创建新服务器 对话框关闭,您将返回到 部署 节点的 连接 选项卡。

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

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

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

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

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

    创建远程主机 SFTP 连接
    • SSH 配置: 中,从列表中选择先前创建的某个 SSH 配置,或点击 浏览按钮 并按照 创建 SSH 配置 中的说明创建一个新配置。

    • 使用rsync 下载/上传/同步: 中选择复选框,使 PyCharm 使用 Rsync 上传和下载文件,从而提高文件传输速度。

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

    创建远程主机 FTP、FTPS、WebDav 连接
    • 主机: 中指定要与之交换数据的服务器的主机名。

    • 端口: 中指定此服务器侦听的端口。 对于 FTP/FTPS,默认值为 21。 对于 WebDAV,默认值为 6180

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

      选择 保存密码(V) 复选框,将密码永久存储在 PyCharm 中(否则,只会存储到 IDE 重启为止)。

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

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

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

      执行以下任一操作:

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

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

      • 点击 自动检测。 PyCharm 会检测 FTP/SFTP 服务器上的用户主目录设置,并据此设置根路径。 仅当您已指定凭据时才会启用该按钮。

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

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

  3. (可选)展开 高级 部分以配置更多设置,如下所述:

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

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

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

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

    如果服务器上尚不存在具有指定名称的文件夹,则在您触发 项目上传 时,PyCharm 会创建它。

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

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

打开远程主机工具窗口并选择该服务器
最后修改日期: 2025年 12月 2日