CentOS 上 PhpStorm 网络连接问题排查与修复
一 常见症状与快速自检
- 症状速览与对应检查点：
- 无法连接远程 SFTP/SSH：先用命令行测试连通性：
ssh -v user@host -p 22 与 sftp -P 22 user@host，确认账号、端口、密钥或密码是否正确，再回到 PhpStorm 测试连接。
- 出现 Algorithm negotiation fail：服务器与客户端加密套件/ MAC 不兼容，需在服务器调整 /etc/ssh/sshd_config 的加密算法与 MAC 列表后重启 sshd。
- 提示 Could not read from remote repository（Git）：多为 SSH 公钥未部署或远端 known_hosts 校验问题，先在终端
ssh -T git@github.com 验证，再在 PhpStorm 的 Deployment/Options 调整 known_hosts 策略，并在 Settings → Appearance & Behavior → System Settings → Passwords 重新保存凭据。
- 出现 Cannot start internal HTTP server：常见于本机防火墙拦截回环或本地端口，放行 PhpStorm 相关进程或临时关闭防火墙验证。
二 本机防火墙放行 PhpStorm 必要通信
- 放行回环与常用本地端口（适用于内置 HTTP 服务、调试、插件通信）：
- 查看防火墙状态：
sudo firewall-cmd --state
- 放行回环接口：
sudo firewall-cmd --permanent --zone=trusted --add-interface=lo
- 放行常用本地端口区间（示例为 63342 与 9000-9100）：
sudo firewall-cmd --permanent --zone=trusted --add-port=63342/tcp 与 sudo firewall-cmd --permanent --zone=trusted --add-port=9000-9100/tcp
- 重新加载：
sudo firewall-cmd --reload
- 验证：
sudo firewall-cmd --list-ports 与 ss -lntp | grep -E '63342|9000'
- 若仍异常，可在排障阶段临时关闭防火墙验证：
sudo systemctl stop firewalld，确认是防火墙问题后再按上面规则精确放行。
三 SFTP 与 SSH 专项排查
- 服务器侧检查与优化（以 OpenSSH 为例）：
- 确认 sshd 正在监听 22 端口：
ss -lntp | grep :22
- 优化连接体验（可选）：编辑 /etc/ssh/sshd_config，设置
UseDNS no、GSSAPIAuthentication no，重启 sshd 后重试。
- 算法协商失败：在 /etc/ssh/sshd_config 中放宽加密套件与 MAC（示例为注释掉过时算法），保存后重启
sshd：sudo systemctl restart sshd。
- PhpStorm 侧设置要点：
- 在 Tools → Deployment → Configuration 新建 SFTP，填写 Host/IP、Port 22、Root path、Username，使用 Password 或 Private Key，点击 Test SFTP Connection 验证。
- 若出现 known_hosts 或凭据问题：在 Deployment → Options 将 Hash hosts in known_hosts file 取消勾选，并将 Add new host key to known_host 设为 Ask；在 Settings → Appearance & Behavior → System Settings → Passwords 重新保存密码或密钥。
四 虚拟机与容器场景的连通性
- 使用 VirtualBox 时，将网络适配器设为 桥接网卡，在虚拟机内用
ip addr 查看真实 IP（避免使用 10.0.2.15 这类 NAT 内部地址），再将该 IP 填入 PhpStorm 的 SFTP Host。
- 若仍不通，临时关闭 Windows/CentOS 防火墙验证是否为策略阻断，确认后改为精确放行对应 IP/端口。
五 Git 与内置服务的网络问题
- Git 报错 Could not read from remote repository：
- 先在终端验证 SSH：
ssh -T git@github.com（或你的 Git 服务域名），确保公钥已加入远端账户；必要时在 PhpStorm 的 Deployment/Options 调整 known_hosts 策略，并在 Passwords 中重新保存凭据。
- 出现 Cannot start internal HTTP server：
- 放行 PhpStorm 相关端口（如 63342）或临时关闭防火墙验证；Windows 上首次弹出防火墙放行提示时，勾选 公用与专用网络。