>Debian系统下PHPStorm配置FTP/SFTP远程开发图文教程 (2026)

在Linux服务器上进行PHP开发时，很多开发者习惯先在本地写代码，再手动上传到服务器。但这种方式效率低下、容易出错。其实借助PHPStorm内置的远程开发功能，你可以直接在服务器上编辑文件，保存即同步，体验与本地开发完全一致。本文详细介绍在Debian系统下如何配置PHPStorm的FTP/SFTP连接。

>一、前置准备

>1.1 确认Debian服务器环境

首先登录你的Debian服务器，确认以下服务已就绪：

>

检查SSH服务是否运行
sudo systemctl status sshd
>检查FTP/SFTP服务状态
sudo systemctl status vsftpd
>查看服务器IP地址
hostname -I


如果SSH服务未启动，使用以下命令启用：

>sudo systemctl enable sshd

sudo systemctl start sshd


1.2 安装vsftpd（FTP服务器）
对于需要使用FTP协议的团队，推荐使用vsftpd：
>sudo apt update

sudo apt install vsftpd -y

>创建FTP用户
sudo useradd -m ftpuser

sudo passwd ftpuser
>配置vsftpd
sudo nano /etc/vsftpd.conf


关键配置项参考：

>listen=YES

local_enable=YES

write_enable=YES

chroot_local_user=YES

allow_writeable_chroot=YES



重启服务：

>sudo systemctl restart vsftpd


二、在PHPStorm中配置SFTP（推荐方式）
SFTP比FTP更安全，推荐优先使用。以下是配置步骤：
>2.1 打开部署配置
依次点击：File → Settings → Build, Execution, Deployment → Deployment
点击左侧的 "+" 号，选择 "SFTP" 连接类型。
>2.2 填写连接信息
在弹出窗口中填写以下信息：
| 配置项 | 示例值 | 说明 |

|--------|--------|------|

| Host | 192.168.1.100 | 服务器IP地址 |

| Port | 22 | SSH默认端口 |

| User name | root | 服务器用户名 |

| Auth type | Key pair / Password | 推荐使用密钥对 |

| Root path | /var/www/html | 网站根目录 |
> 提示：如果是普通用户而非root，请确保该用户对目标目录有读写权限。
>2.3 配置SSH密钥（更安全）
为了避免每次输入密码，推荐配置SSH密钥：
>

在本地生成密钥对（Windows/Linux通用）
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
>将公钥上传到服务器
ssh-copy-id user@your_server_ip


之后在PHPStorm的Auth type中选择 "Key pair"，并指定私钥路径（通常是 ~/.ssh/id_rsa）。

>2.4 配置映射路径
在 "Mappings" 标签页中配置本地与远程的路径映射：
>

Local path：本地项目文件夹路径
Deployment path：服务器上的对应路径（相对于Root path）
这样PHPStorm就能准确知道本地文件对应服务器上的哪个位置。
>三、配置FTP连接（备选方案）
如果必须使用FTP协议，按以下步骤配置：
>3.1 新建FTP连接
在Deployment页面点击 "+" → 选择 "FTP"，填写：
FTP Host：服务器IP
Port：21
Username：FTP用户名
Password：FTP密码
>3.2 被动模式配置
如果服务器启用了防火墙，可能需要启用被动模式：
在FTP连接的高级设置中勾选 "Passive mode"，这是大多数Debian服务器的默认配置。
>四、配置自动上传
>4.1 设置默认上传方式
在Deployment配置页面，点击顶部工具栏的 Options，设置：
Upload changed files automatically to the default server：选择 "On explicit save action (Ctrl+S)"
这样每次保存文件时，PHPStorm会自动同步到服务器。
>4.2 开启自动下载（可选）
如果多人协作开发，需要服务器上的更新能自动拉取到本地：
在 "Options" 中勾选 "Watch for external changes"。
>五、验证配置
完成以上配置后，按照以下步骤验证：
>5.1 测试连接
在Deployment配置页面，点击 "Test Connection" 按钮。如果显示 "Successfully connected"，说明配置正确。
>5.2 上传测试文件
在本地项目新建一个测试文件 test.php，内容如下：
>



保存后，在PHPStorm中右键点击该文件，选择 Deployment → Upload to 你的服务器。

登录服务器检查文件是否存在：
>cat /var/www/html/test.php



如果文件内容正确显示，说明配置成功。

>六、常见问题排查
>6.1 连接被拒绝（Connection refused）
确认服务器SSH服务已启动：sudo systemctl status sshd
确认防火墙已开放22端口：sudo ufw allow 22
>6.2 权限不足（Permission denied）
检查目标目录权限：ls -ld /var/www/html
将目录所有者改为FTP用户：sudo chown -R ftpuser:ftpuser /var/www/html
>6.3 密钥认证失败
确认公钥已正确添加到服务器：cat ~/.ssh/authorized_keys
检查本地私钥权限：chmod 600 ~/.ssh/id_rsa
>七、一句话总结
> 在Debian服务器上使用PHPStorm远程开发，只需配置一次SFTP/FTP连接，保存即同步，开发效率大幅提升，推荐所有PHP开发者都配置起来。
---
延伸阅读：
[PHPStorm官方文档：Deployment](https://www.jetbrains.com/help/phpstorm/deploying-sftp.html)
[Debian服务器安全配置指南](https://www.debian.org/doc/)