Ubuntu PHPStorm如何连接到远程服务器

Ubuntu下PHPStorm连接远程服务器的完整步骤

一、前置准备：配置远程服务器

1. 安装SSH服务（若未安装）
   在远程Ubuntu服务器上执行以下命令，安装并启动SSH服务：

   sudo apt update
   sudo apt install openssh-server
   sudo systemctl restart sshd
   

2. 配置SSH访问权限
   编辑SSH配置文件（/etc/ssh/sshd_config），确保以下关键配置未被注释且正确：

   Port 22                  # 默认SSH端口（可自定义，需与后续配置一致）
   PermitRootLogin prohibit-password  # 禁止root密码登录（推荐）
   PasswordAuthentication yes  # 允许密码认证（或使用密钥认证，更安全）
   

   保存后重启SSH服务：

   sudo systemctl restart sshd
   

3. 创建项目目录并设置权限
   在服务器上创建用于存放项目的目录，并赋予当前用户读写权限：

   mkdir -p /var/www/html/your_project_name
   sudo chown -R $USER:$USER /var/www/html/your_project_name
   sudo chmod -R 755 /var/www/html/your_project_name
   

二、PHPStorm配置远程连接

方式1：通过SFTP连接（推荐，安全且支持文件同步）

1. 添加SFTP部署配置
   打开PHPStorm，进入 File > Settings > Build, Execution, Deployment > Deployment，点击左上角“+”号，选择SFTP。

   • General标签页：
     • 输入连接名称（如“Remote Ubuntu Server”）；
     • 主机（Host）：填写远程服务器IP或域名；
     • 端口（Port）：默认22（与服务器SSH端口一致）；
     • 用户名（User name）：服务器登录用户名（如ubuntu、your_username）；
     • 认证类型（Auth type）：选择“Password”（输入密码）或“Key pair”（推荐，需提前生成SSH密钥对并将公钥上传至服务器~/.ssh/authorized_keys）。
   • Mappings标签页：
     • 本地路径（Local path）：选择本地项目目录（如~/projects/your_project）；
     • 部署路径（Deployment path on server）：填写服务器项目目录相对于用户主目录的路径（如/var/www/html/your_project_name，即绝对路径为/home/your_username/var/www/html/your_project_name）。
   • 点击Test Connection验证连接，成功后点击Apply > OK保存。

2. 启用自动同步（可选）
   在Deployment设置页，勾选Automatic Upload（保存本地文件时自动上传至服务器），或通过右键项目根目录选择Upload to Remote Host手动同步。

方式2：通过SSH解释器配置（用于远程PHP执行）

若需让PHPStorm使用远程服务器的PHP环境（如运行脚本、安装Composer依赖），需配置远程解释器：

1. 进入 File > Settings > Languages & Frameworks > PHP，点击CLI Interpreter右侧的“…”号，选择Add。
2. 选择SSH Interpreter，输入远程服务器信息（主机、端口、用户名），认证方式选择密码或密钥。
3. PHPStorm会自动检测远程PHP路径（通常为/usr/bin/php），确认后可设置远程Composer路径（如/usr/local/bin/composer）。
4. 点击OK保存，此后PHPStorm将使用远程PHP环境执行命令。

三、验证连接与使用

1. 测试文件同步：在本地项目中修改文件并保存，检查远程服务器对应目录是否同步更新（若启用了自动上传，应自动同步）。
2. 测试远程解释器：在PHPStorm中创建一个简单的PHP文件（如test.php），内容为<?php phpinfo(); ?>，右键选择Run 'test.php'，查看输出是否来自远程服务器的PHP环境。

四、常见问题排查

• 连接失败：检查服务器IP、端口是否正确，防火墙是否放行SSH端口（sudo ufw allow 22）；若使用密钥认证，确保公钥已添加至服务器~/.ssh/authorized_keys。
• 权限问题：确保远程项目目录的用户权限正确（如chown -R $USER:$USER），避免因权限不足导致文件无法写入。
• 路径映射错误：在Mappings标签页中确认本地与远程路径对应关系，避免调试时文件路径不匹配。

通过以上步骤，PHPStorm即可成功连接远程Ubuntu服务器，实现文件同步、远程解释器调用等功能，为远程开发提供便捷环境。