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’：Web 访问根（如 /）
• 完成后点击 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 所用的账号对该目录具备读写权限。