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版）中完成遠程連接配置，實現本地與遠程項目的無縫協作。