利用PhpStorm实现远程服务器同步_SFTP自动上传与部署配置-phpstorm-PHP中文网

sftp连接失败主因是服务器未启用sftp子系统或用户shell被禁用；需确认sshd_config中subsystem配置为internal-sftp、用户shell非/bin/false、root path为绝对路径、mappings路径映射正确、远程目录有写权限、时间戳同步或关闭比对。

利用phpstorm实现远程服务器同步_sftp自动上传与部署配置

Connection refused 或卡在 Testing connection…，八成是服务器没开 SFTP 子系统，或用户 shell 被禁用。SSH 登录成功 ≠ SFTP 可用。

先在终端执行 ssh -v user@host，看到最后一行有 debug1: Sending subsystem: sftp 才算真正支持 SFTP
检查服务器 /etc/ssh/sshd_config 是否启用 SftpSubsystem（不是 Subsystem sftp /usr/lib/openssh/sftp-server 就得改）
确认该用户 shell 不是 /bin/false 或 /usr/sbin/nologin——哪怕只传文件，PhpStorm 也需要合法 shell 初始化会话
Root path 必须填绝对路径，比如 /var/www/html，填 ~/public_html 或留空会导致连接通但后续映射全错

手动 Upload to 能传，Ctrl+S 却没反应？说明 PhpStorm 根本没把当前文件纳入监听范围——它只认 Deployment > Mappings 里明确配了 Local path 的目录。

打开 Settings → Build, Execution, Deployment → Deployment → Mappings，确认你正在编辑的文件路径（如 src/Controller/）在表格中有一行匹配项
Local path 填相对项目根的路径（如 . 或 public），Deployment path on server 填相对于 Root path 的路径（如 / 或 /static），两者拼起来必须等于完整远程路径
Default server 必须设为你想传的目标服务器，否则勾了 Upload changed files automatically to the default server 也白搭
别依赖通配符（如 **/vendor/**），优先写死常用目录，避免漏配 dist/ 或 build/

状态栏弹出 “Uploaded 1 file”，但 ls -l 看时间戳没更新、浏览器 404、内容还是旧的——这不是网络问题，是路径或权限错位。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Web path for this project 必须和 Nginx/Apache 的 root 或 DocumentRoot 完全一致，少一个 / 或多一个 ./ 都会导致文件传对位置，服务却找不到
远程目标目录权限必须允许你配置的 SSH 用户写入：ls -ld /var/www/html 输出中要有 drwxr-xr-x 里的 w，且属主/属组是你用的用户名
如果服务器是 Docker 容器或 NFS 挂载盘，文件系统可能不更新 mtime，PhpStorm 默认靠时间戳判断是否上传，结果误判“未改动”而跳过——此时要关掉 Compare files by time stamp

Authentication failed 弹窗反复出现？大概率是私钥格式不对，或者带了密码。

PhpStorm（基于 Java）只认 OpenSSH 格式私钥，-----BEGIN OPENSSH PRIVATE KEY----- 开头；PuTTY 的 .ppk 文件必须用 PuTTYgen → Conversions → Export OpenSSH key 导出为无后缀文件（如 id_rsa）
导出 OpenSSH 私钥时，passphrase 务必留空——PhpStorm 对带密码的 OpenSSH 私钥支持不稳定，容易卡住或报 Invalid private key
如果服务器强制要求密钥密码，别硬塞进 PhpStorm，改用 ssh-agent 托管密钥，再让 PhpStorm 复用系统 ssh agent
别选错文件：填的是私钥（id_rsa），不是公钥（id_rsa.pub）