Debian系统下PhpStorm配置FTP服务器教程

在 Debian 系统中为 PhpStorm 配置 FTP 服务器

一 准备工作

• 在 Debian 系统中通常无需额外安装软件，PhpStorm 内置了 Deployment（部署） 功能，可以直接连接 FTP/SFTP 服务器。
• 提前准备远程服务器登录信息：主机地址（IP 或域名）、端口（FTP 21、SFTP 22）、用户名、密码或私钥、网站根目录（如 /var/www/html），以及用于浏览器访问和预览的 Web path（如 /）。

二、在 PhpStorm 中新建并测试连接

• 打开项目后，依次进入：Tools → Deployment → Configuration，点击左上角 + 新建服务器，类型选择 FTP 或 SFTP。
• 在 Connection 页填写：
  • Host、Port（FTP 默认 21，SFTP 默认 22）
  • User name、Password（SFTP 也可选择 Key pair 密钥认证）
  • 可选：填写 Root path（如 /var/www/html）
  • 点击 Test Connection 测试服务器连接是否正常
• 在 Mappings 页配置本地与远程路径映射：
  • Local path：本地项目根目录
  • Deployment path on server ‘xxx’：远程项目相对路径（常见为 / 或 /var/www/html）
  • Web path on server ‘xxx’：网站访问根路径（如 /）
• 完成配置后点击 OK 保存即可。

三 常用操作与自动同步

• 查看远程文件：进入 Tools → Deployment → Browse Remote Host，在右侧远程目录中可以直观浏览、下载、上传和对比文件内容。
• 右键菜单常用功能：
  • Download from here（下载到本地）
  • Upload here（上传到远程服务器）
  • Compare With Local Version（与本地版本进行对比）
  • Sync With Local（与本地目录同步）
• 自动上传（保存后自动同步）：进入 Tools → Deployment → Options，勾选 Upload changed files automatically to the default server，保存后即可生效。

四 连接失败排查与建议

• 如果无法连接，可在 Advanced options 中勾选 Passive mode（被动模式） 后再次尝试，这类问题在 FTP 网络环境中较为常见。
• 协议与端口选择：如果 FTP 21 连接不稳定或端口受限，建议优先尝试 SFTP 22；在很多服务器环境中，SFTP 的兼容性和稳定性更好。
• 路径与权限检查：确认 Root Path / Mappings 指向的是正确目录，并确保运行 PhpStorm 所使用的账号对该目录拥有读写权限。