疑難排解

呢一頁介紹 Mobile SSH 嘅常見問題，以及喺更改伺服器端 SSH 設定之前應該先做嘅檢查。

無法連線

請檢查：

• Android 裝置有網絡存取。
• 伺服器嘅主機名稱或 IP 位址正確。
• SSH 連接埠正確，通常係 22。
• 防火牆、VPN、電訊商網絡或 Wi-Fi 網絡冇封鎖個連接埠。
• SSH 伺服器執行緊，並接受由你所用網絡嚟嘅連線。

如果同一部主機喺另一部裝置可用，請逐項比較主機、連接埠、用戶名、金鑰同網絡路徑。

驗證失敗

請檢查：

• 用戶名串法。
• 密碼或金鑰口令。
• 伺服器係咪允許密碼登入、金鑰登入或兩者。
• 私鑰係咪同伺服器用戶 authorized_keys 入面嘅公鑰相符。
• 金鑰檔案係咪完整匯入，包括開頭同結尾行。

對於已加密嘅私鑰，喺密碼/口令欄位輸入口令。

私鑰匯入失敗

私鑰匯入用 Android 檔案選擇器。如果匯入失敗：

• 確認所選檔案係私鑰，而唔係公鑰 .pub 檔案。
• 喺可信嘅文字編輯器開啟檔案，確認佢包含完整嘅金鑰區塊。
• 試吓將金鑰手動貼入私鑰欄位。
• 確認金鑰類型係應用程式實作支援嘅其中一種：Ed25519、RSA、ECDSA 或 DSA。

鍵盤輸入延遲或被更改

如果你嘅 Android 鍵盤喺文字到達 shell 之前更改咗佢，請喺 Mobile SSH 設定關閉鍵盤建議。呢個對 Vim、tmux、htop、less、用特殊組合鍵嘅 shell 同遠端密碼提示好有用。

用額外按鍵列輸入 ESC、TAB、CTRL、方向鍵、HOME、END、PGUP 同 PGDN 等終端機按鍵。

tmux 捲動同預期唔同

Mobile SSH 會根據終端機狀態更改捲動行為。喺 tmux 或其他備用畫面程式，捲動手勢可能傳送 tmux 複製模式指令，而唔係捲動本機歷史。如果啟用咗 tmux 滑鼠模式，應用程式會傳送滑鼠滾輪逸出序列。

如果捲動感覺唔啱：

• 試吓喺遠端伺服器啟用或關閉 tmux 滑鼠模式。
• 用額外按鍵列嘅 PGUP 同 PGDN。
• 喺捲動密集輸出之前，雙撳窗格進入全螢幕。
• 如果遠端終端機大細睇落過時，請卸離並重新附加 tmux。

鎖螢幕後工作階段中斷

Mobile SSH 用保活、前景服務、喚醒鎖、Wi-Fi 鎖同重新連線嘗試嚟減少中斷。Android 嘅電池政策仍然可能停止背景工作。

請檢查：

• 如果你部裝置會積極停止背景應用程式，請為 Mobile SSH 關閉電池最佳化。
• 喺長工作階段期間保持 Wi-Fi 或流動數據穩定。
• 解鎖之後重新開啟 Mobile SSH 並撳 Active Sessions。
• 如果伺服器中斷咗 SSH 工作階段，請由最近工作階段重新連線。

檔案傳輸無法瀏覽手機檔案

喺較新嘅 Android 版本，本機檔案瀏覽可能需要儲存權限。喺 Android 設定為 Mobile SSH 授予儲存權限，然後重新開啟檔案傳輸畫面。

如果遠端檔案載入到但本機檔案載入唔到，咁 SSH 連線好可能冇問題，問題係出喺本機 Android 儲存權限。

上載或下載失敗

請檢查：

• SSH 工作階段仍然連線緊。
• 遠端目錄存在。
• 遠端用戶有讀取或寫入該路徑嘅權限。
• 本機目標可寫入。
• Android 裝置有足夠嘅可用空間。
• 網絡對大型傳輸足夠穩定。

連接埠轉發失敗

請檢查：

• 本機連接埠喺 1 同 65535 之間。
• 本機連接埠未被佔用。
• 通道字串係 PORT 或 LOCAL:REMOTEHOST:REMOTE。
• 遠端主機同遠端連接埠可以由 SSH 伺服器到達。
• SSH 伺服器允許 TCP 轉發。

偵錯日誌

起始畫面包含 Debug 按鈕。啟用之後，Mobile SSH 會記錄終端機事件、SSH 資料大細、觸控輸入、調整大細行為同通道生命週期嘅診斷資訊。停止記錄就可以將偵錯封存檔儲存喺本機。

喺分享偵錯封存檔之前請先查看。佢哋係用嚟疑難排解，可能會揭露伺服器名稱、時間、終端機行為或其他環境細節。