# SFTP

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Procedure: 安装 Remote File Systems 插件

此功能依赖于插件，您需要安装并启用它。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用远程文件系统插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  远程文件系统  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

Procedure: 连接到 SFTP 服务器

1. 在   大数据工具  窗口中，点击 ![添加连接](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)并选择   SFTP  。

2. 在打开的   大数据工具  对话框中，指定连接参数：

![Big Data Tools 对话框，其中包含一个已测试的 SFTP 连接，该连接使用 SSH 配置、根路径和 SFTP 服务器 sudo 选项。](https://resources.jetbrains.com/help/img/idea/2026.3/bdt_sftp_fs_connection.png)

* 名称 ：用于区分其他连接的连接名称。

* SSH 配置 ：选择一个 [SSH 配置](create-ssh-configurations.html)，其中包含所需的服务器地址和凭证。

* 根路径 ：根目录的路径。

此外，您可以设置：

* 按项目 ：选择仅对当前项目启用这些连接设置。 如果希望此连接在其他项目中可见，请取消选中复选框。

* 启用连接 ：如果希望禁用此连接，请取消选中复选框。 默认情况下，新建的连接是启用的。

* 使用 sudo 运行 SFTP 服务器 ：选择您的目标服务器是否需要 root 访问权限。 选择此选项后，您在连接 SFTP 服务器时将被提示输入 root 用户密码。

* 使用自定义命令启动 SFTP 服务器 ：选择是否要自定义服务器启动命令。 选择此选项后，以下参数将可用： * 用于启动 SFTP 服务器的命令 ：输入 SFTP 服务器的路径或提供 SFTP 连接选项。 如果选中 使用 sudo 运行 SFTP 服务器 选项，您可以将该字段留空，让 IntelliJ IDEA 自动检测 SFTP 服务器的路径。 请点击 测试连接 查看检测到的路径。 * 建议对权限受限的文件使用 sudo ：选中该选项后，IntelliJ IDEA 在每次您尝试读取或写入受限制访问的文件时会询问您是否要使用 sudo 密码。 如果未选中，访问这些文件将导致"权限被拒绝"错误。 只有未选择 使用 sudo 运行 SFTP 服务器 时，才可以使用此选项。 * 使用 SSH 配置中的密码 ：选择是否要使用所选 [SSH configuration](create-ssh-configurations.html) 提供的密码来访问文件。 如果密码为空，或者 SSH 配置的 身份验证类型 不是 密码 ，IntelliJ IDEA 将要求您在运行服务器和访问文件时输入密码。 如果选择了 使用 sudo 运行 SFTP 服务器 或 建议对权限受限的文件使用 sudo ，该选项可用。 * 用于运行 sudo 的命令 ：自定义 sudo 命令；例如，您可以输入 sudo 的完整路径或提供选项，例如 `sudo -k` 。

3. 填写设置后，点击   测试连接  以确保所有配置参数正确。 然后点击   OK  。