🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文

---

SSH 連接埠轉發器支援文件

開始使用

SSH 連接埠轉發器（SSHPortForwarder）是一款 macOS 應用程式，用於建立 SSH 連接埠轉發和 SOCKS 代理。您可以配置遠端主機、連接埠和驗證方式（密碼或私鑰），然後啟動轉發，即可獲得本地連接埠或 SOCKS 代理，無需離開終端機或修改 SSH 設定。此應用程式可在選單列中執行，以便快速啟動/停止。您的配置、密碼（儲存在鑰匙圈中）和金鑰檔案存取權限均保留在您的 Mac 上；應用程式不會上傳您的資料。

開始使用 SSH 連接埠轉發器

1. 下載並安裝應用程式（從 App Store 或您的發佈管道）。
2. 啟動應用程式。您可以使用主視窗管理配置，或使用選單列圖示快速存取。
3. 新增或選擇轉發配置：
   • 輸入名稱、遠端主機、SSH 連接埠（預設為 22）和使用者名稱。
   • 選擇 密碼 或 私鑰 進行驗證。若使用私鑰，請使用金鑰路徑旁的 瀏覽 按鈕選擇您的金鑰檔案（應用程式在沙盒環境下存取檔案時需要此步驟）。
   • 選擇 SOCKS 代理（本地 SOCKS 代理）或 本地轉發（將特定遠端連接埠轉發到本地連接埠），並設定本地連接埠（以及本地轉發的遠端連接埠）。
4. 可選：在啟動前使用 測試 驗證 SSH 連線。
5. 點擊 開始 以啟動轉發。使用選單列圖示可快速啟動或停止轉發。
6. 儲存您的配置以保留設定；若使用密碼，它將儲存在系統鑰匙圈中。

重要事項：私鑰檔案與重新選擇

若您使用 私鑰 驗證並在應用程式中選擇金鑰檔案：

• 應用程式透過系統書籤（路徑 + 檔案識別）記住對該檔案的存取權限。
• 若您刪除該金鑰檔案，然後建立同名（或同路徑）的新檔案，應用程式仍指向舊檔案。 書籤可能失效或指向錯誤的檔案。
• 您必須在客戶端中重新選擇金鑰檔案： 開啟配置，點擊金鑰路徑旁的 瀏覽，選擇新的金鑰檔案，然後 儲存。否則應用程式可能連線失敗或顯示權限錯誤。

疑難排解

• 連線或驗證失敗

  • 檢查遠端主機、SSH 連接埠和使用者名稱。
  • 密碼驗證：確保密碼正確且已儲存（鑰匙圈）。
  • 私鑰驗證：確保您透過 瀏覽 選擇了金鑰，金鑰格式受支援（OpenSSH 或 PEM），且若金鑰有密碼，請在提示時輸入。若您更換了金鑰檔案（例如刪除並重新建立同名檔案），請在應用程式中重新選擇金鑰檔案並儲存。

• 「無權限讀取金鑰檔案」或金鑰相關錯誤

  • 使用 瀏覽 按鈕重新選擇您的私鑰檔案，然後儲存。更換金鑰檔案後（例如相同路徑/名稱的新金鑰）也需要此步驟。

• 本地連接埠被佔用

  • 在配置中選擇另一個本地連接埠，或停止佔用目前連接埠的應用程式。

• 轉發未啟動或持續「連線中」

  • 執行 測試 以驗證 SSH 連線能力。檢查防火牆和網路。確保遠端主機允許 SSH，且對於本地轉發，遠端連接埠正確。

• 選單列圖示或主視窗

  • 應用程式可僅在選單列圖示中執行。使用選單開啟完整視窗進行配置或啟動/停止轉發。

意見回饋與建議

我們重視您對改進 SSH 連接埠轉發器的意見回饋和建議。
如果您有任何想法或建議，請傳送至 [email protected]。

感謝您使用 SSH 連接埠轉發器！