phpstorm的ssh连接配置不跨设备自动同步,需手动迁移:项目级配置存于.idea/deployment.xml,全局级存于config/options/sshconfigs.xml,须复制文件并修正私钥路径、权限等参数。

SSH连接配置不跨设备自动同步
PhpStorm 的 SSH 连接配置(即 Deployment 中的 SFTP/SSH 配置)不会随 Settings Sync 插件自动迁移,也不会被 JetBrains 账号云端备份。它属于项目级或 IDE 本地配置,存放在 .idea/deployment.xml(项目内)或 config/options/sshConfigs.xml(全局 IDE 配置目录)中,必须手动导出/复制。
迁移方式分两种:项目绑定 vs 全局复用
取决于你当初怎么建的连接:
- 如果 SSH 配置是在 Settings > Build, Execution, Deployment > Deployment 里添加的,并且勾选了 Visible on IDE level(默认不勾),那它存在全局配置路径:
config/options/sshConfigs.xml - 如果没勾这个选项,或者你在某个具体项目里点右键 → Deployment > Configuration 添加的,那它只写在该项目的
.idea/deployment.xml里,迁移只需复制整个.idea目录 - 注意:
deployment.xml里含明文密码(若用了 Password 认证),密钥路径是绝对路径(如/home/user/.ssh/id_rsa),迁移到新机器前必须重写路径、或改用 Key pair + PEM 密钥并确保权限为600
手动提取和复用 sshConfigs.xml 最可靠
这是唯一能迁移“IDE 级” SSH 配置的方法,适用于想在新电脑上一键复用所有远程服务器连接的场景:
- 找到旧机器上的 PhpStorm 全局配置目录(路径因系统而异):
– macOS:~/Library/Caches/JetBrains/PhpStorm2025.3/options/
– Windows:%LOCALAPPDATA%\JetBrains\PhpStorm2025.3\options\
– Linux:~/.cache/JetBrains/PhpStorm2025.3/options/ - 复制其中的
sshConfigs.xml文件,粘贴到新机器对应版本目录的options/下(注意版本号要一致,否则可能被忽略) - 重启 PhpStorm,进入 Settings > Deployment,应能看到原有配置;但需逐个点击 Test Connection —— 因私钥路径、用户名、主机 IP 可能已变更,失败时直接编辑修正即可
- 若新机器用的是不同用户家目录,
Private key file字段里的路径大概率失效,必须手动重新指定,且确保文件可读:chmod 600 ~/.ssh/id_rsa
别指望 Settings Sync 插件能带过去
第三方 Settings Sync 插件(作者 Shengbin Chen)明确不包含 SSH 配置项。它的同步清单里没有 sshConfigs.xml 或 deployment.xml,即使你勾选了 “All settings”,也只会同步 Keymap、Editor、Inspections 等 IDE 行为类配置。试图靠它迁移连接,结果一定是空白的 Deployment 列表。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










