在 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 所使用的账号对该目录拥有读写权限。
