PyCharm 2025.3 Help

部署：连接选项卡

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

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

项

说明

仅对此项目可见

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

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

    服务器配置设置与项目一起存储在 .idea 目录中，从而可在团队成员之间 通过 VCS 共享它们。

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

  • 清除该复选框后，该配置或服务器组在所有 PyCharm 项目中可见。 其设置可在多个项目中重用。

有关设置运行时的更多信息，请参阅 通过 SSH 的 Node.js。

类型

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

  • FTP ：选择此选项可使 PyCharm 通过 FTP 文件传输协议访问服务器。

  • SFTP ：选择此选项可使 PyCharm 通过 SFTP 文件传输协议访问服务器。

  • FTPS ：选择此选项可使 PyCharm 通过基于 SSL 的 FTP 文件传输协议（FTPS 扩展）访问服务器。

  • WebDAV ：选择此选项可使 PyCharm 通过 WebDAV 文件传输协议（WebDAV 扩展）访问服务器。

Web 服务器 URL(W)

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

同时支持 HTTP 和 HTTPS。

FTP 和 FTPS 设置

项

说明

主机

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

端口

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

根路径(R)

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

执行下列任一操作：

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

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

  • 点击 自动检测。 PyCharm 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并据此设置根路径。 该按钮仅在您已指定凭据时才可用。

自动检测

点击此按钮，以使 PyCharm 检测服务器上的用户主文件夹设置，并相应地设置 根路径。

用户名

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

密码

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

匿名登录(N)

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

保存密码(V)

选中此复选框，让 PyCharm 记住指定的密码。

测试连接(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 功能，并使 PyCharm 回退为通过 TLS 1.2 进行连接。 如果您在与服务器建立连接或上传某些文件时遇到问题，请使用此选项。

FTPS

被动模式(P)

选中此复选框，可将您计算机上的客户端设置为 被动模式 。在此模式下，客户端连接到服务器以告知其处于被动模式，接收要监听的端口号，并通过接收到的端口建立数据连接。 当您的计算机位于防火墙之后时，此模式很有用。

FTP, FTPS

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

选中此复选框时：

  1. 隐藏文件和目录会显示在 远程主机工具窗口 中。

  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)

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

FTP, FTPS

保持活动命令(A)

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

FTP, FTPS

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

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

FTP, FTPS

SFTP 设置

项

说明

SSH 配置(S)

从此列表中，选择已创建的 SSH 配置之一，或点击 浏览按钮 ，并按照 创建 SSH 配置 中的说明创建新配置。

测试连接(C)

点击此按钮以检查指定设置是否可保证连接成功。 该按钮仅在您已指定用户凭据时才可用。

根路径(R)

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

执行下列任一操作：

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

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

  • 点击 自动检测。 PyCharm 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并据此设置根路径。 该按钮仅在您已指定凭据时才可用。

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

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

Rsync 设置

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

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

    • 在 macOS 和 Linux 上， rsync 和 ssh 工具已预安装，其路径会自动填充。

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

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

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

    有关可用选项的完整列表，请参阅 Rsync 文档。

SFTP 高级设置

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

项

说明

连接数(E)

在此字段中，指定要同时支持的最大连接数。

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

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

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

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

WebDAV 设置

项

说明

主机

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

端口

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

用户名

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

密码

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

匿名登录(N)

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

保存密码(V)

选中此复选框，让 PyCharm 记住指定的密码。

测试连接(C)

点击此按钮以检查指定设置是否可保证连接成功。

本地或已挂载的文件夹设置

项

说明

文件夹(F)

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

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

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