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 所用的账号对该目录具备读写权限。
