phpstorm Ubuntu版如何远程连接

PHPStorm（Ubuntu版）远程连接配置指南
本文介绍通过SSH协议（推荐，安全性更高）和FTP/SFTP协议在PHPStorm（Ubuntu系统）中配置远程连接的方法，涵盖连接建立、文件同步及常见问题排查。

一、前置准备：确保远程服务器可访问

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

   sudo apt update
   sudo apt install openssh-server
   sudo systemctl start sshd
   sudo systemctl enable sshd  # 设置开机自启
   

2. 检查防火墙设置
   若服务器启用了ufw防火墙，需允许SSH端口（默认22）：

   sudo ufw allow 22/tcp
   sudo ufw reload
   

3. 验证SSH连接
   在Ubuntu本地终端输入以下命令，测试能否连接到远程服务器（替换<server_ip>为实际IP）：

   ssh username@<server_ip>
   

   若提示输入密码并能成功登录，说明SSH服务正常。

二、配置SSH密钥对（增强安全性，推荐）

SSH密钥对可实现无密码登录，避免重复输入密码。步骤如下：

1. 生成密钥对
   在Ubuntu本地终端执行以下命令（按回车键使用默认路径，可不设密码）：

   ssh-keygen -t rsa -b 4096
   

   生成的私钥（id_rsa）和公钥（id_rsa.pub）默认存放在~/.ssh/目录。
2. 将公钥上传至远程服务器
   使用以下命令将公钥内容追加到服务器的authorized_keys文件（替换<server_ip>和username）：

   ssh-copy-id username@<server_ip>
   

   或手动复制公钥内容（cat ~/.ssh/id_rsa.pub），登录服务器后粘贴到~/.ssh/authorized_keys文件中。
3. 设置密钥权限
   确保本地私钥和服务器authorized_keys文件权限正确（仅所有者可读）：

   chmod 600 ~/.ssh/id_rsa        # 本地私钥
   chmod 600 ~/.ssh/authorized_keys  # 服务器端
   

三、在PHPStorm中配置远程连接

1. 配置SSH连接（基础步骤）

1. 打开PHPStorm，进入File > Settings > Build, Execution, Deployment > Deployment。
2. 点击左上角**+号，选择SFTP**（基于SSH的文件传输协议）。
3. 在Connection标签页中填写以下信息：
   • Name：自定义连接名称（如“Remote Server”）；
   • Type：选择“SFTP”；
   • Host：远程服务器IP地址或域名；
   • Port：SSH端口（默认22）；
   • User name：服务器登录用户名；
   • Auth type：选择“Key pair (OpenSSH)”；
   • Private key file：选择本地私钥文件（~/.ssh/id_rsa）。
4. 点击Test Connection，若显示“Connection successful”，说明SSH连接配置正确。

2. 配置本地与远程路径映射

1. 切换至Mappings标签页，在Local path中选择本地项目目录（如~/projects/my_php_project）；
2. 在Deployment path on server中输入远程服务器上的项目目录（如/var/www/html/my_php_project）；
3. （可选）在Excluded Paths标签页中添加无需同步的目录（如node_modules、vendor）。

3. 配置PHP解释器（远程执行PHP代码）

若需在PHPStorm中运行或调试远程PHP代码，需配置远程PHP解释器：

1. 进入File > Settings > Languages & Frameworks > PHP；
2. 点击CLI Interpreter右侧的**…，选择Add**；
3. 选择Remote，然后选择SSH Credentials；
4. 输入远程服务器信息（与SSH连接一致），点击**…**选择远程PHP解释器路径（如/usr/bin/php）；
5. 点击OK保存配置。

四、测试与使用

1. 同步文件：右键点击本地项目根目录，选择Deployment > Upload to Remote Host，可将本地代码上传至服务器；或配置Automatic Upload（勾选Deployment标签页中的“Automatic Upload”），实现保存时自动同步。
2. 远程调试：若需远程调试，需配置PHP Debug插件（确保已安装），并在PHPStorm中设置断点，通过Tools > Debug选择对应的远程调试配置启动调试。

五、常见问题排查

1. 测试连接失败：
   • 检查服务器SSH服务是否运行（sudo systemctl status sshd）；
   • 确认防火墙允许SSH端口（sudo ufw allow 22/tcp）；
   • 验证公钥是否正确添加至服务器authorized_keys文件。
2. 无法读取私钥文件：
   确保本地私钥文件权限为600（chmod 600 ~/.ssh/id_rsa）。
3. Permission denied：
   检查服务器authorized_keys文件权限（chmod 600 ~/.ssh/authorized_keys），或确认用户名/密码是否正确。

通过以上步骤，即可在PHPStorm（Ubuntu版）中完成远程连接配置，实现本地与远程项目的无缝协作。