疑難排解

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

無法連線

請檢查：

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

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

驗證失敗

請檢查：

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

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

私鑰匯入失敗

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

• 確認所選檔案係私鑰，而唔係公鑰 .pub 檔案。
• 喺可信嘅文字編輯器開啟檔案，確認佢包含完整嘅金鑰區塊。
• 試吓將金鑰手動貼入私鑰欄位。
• 確認金鑰類型受支援：喺 Android 係 Ed25519、ECDSA（P-256/384/521）或 RSA；喺 iOS 係 Ed25519 或 ECDSA。DSA（ssh-dss）兩邊都唔支援，而 iOS 亦唔支援 RSA —— 請改為產生一條 Ed25519 金鑰。

鍵盤輸入延遲或被更改

Mobile SSH 會將按鍵直接送去 shell，自動更正同預測建議都關咗，所以鍵盤唔應該喺文字到達遠端之前改寫佢。如果你嘅鍵盤仍然更改輸入，請確認冇任何系統層級嘅替換或者剪貼簿工具攔截緊佢，並用額外按鍵列輸入 ESC、TAB、CTRL、方向鍵、HOME、END、PGUP 同 PGDN 等終端機按鍵。

tmux 捲動同預期唔同

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

如果捲動感覺唔啱：

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

鎖螢幕後工作階段中斷

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

請檢查：

• 如果你部裝置會積極停止背景應用程式，請為 Mobile SSH 關閉電池最佳化。
• 喺長工作階段期間保持 Wi-Fi 或流動數據穩定。
• 解鎖之後重新開啟 Mobile SSH 並撳 Active Sessions。
• 如果你想 shell 喺你撥走個 App 之後都繼續生存，請確認 Settings 入面嘅 Keep sessions running in background 係開嘅。
• 如果伺服器中斷咗 SSH 工作階段，請由主畫面重新連線 —— Continue 列出仲連緊嘅嘢，Tmux sessions 就列出喺伺服器上面等緊你嘅嘢。

喺 iOS，系統會暫停背景應用程式，所以你一切換走或者鎖咗螢幕，原始嘅 SSH 連線就冇辦法無限期保持開啟。短暫嘅寬限期可以應付快速嘅應用程式切換；需要更長時間嘅話，請喺伺服器設定檔啟用 Auto-attach tmux session（或者用 Eternal Terminal 傳輸），噉樣重新連線之後就會返到你離開嗰陣嘅同一個 shell。

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

Mobile SSH 喺 Android 唔會攞任何儲存權限。取而代之，本機窗格顯示嘅係你用系統資料夾選擇器授權嗰一個資料夾 —— 如果佢係空嘅，就用 Pick folder 揀一個。呢個授權會一直保留，所以只需要做一次。

如果遠端檔案載入到但本機檔案載入唔到，咁 SSH 連線係冇問題嘅，你純粹係仲未授權過任何資料夾。

喺 iOS，本機窗格顯示應用程式嘅文件區域，你係透過系統嘅文件同相片選擇器嚟加入檔案。喺嗰度下載嘅嘢，喺「檔案」App 嘅 On My iPhone 底下都睇得到。

上載或下載失敗

請檢查：

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

連接埠轉發失敗

請檢查：

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

偵錯日誌

兩個平台記嘅嘢唔同，所以揀返啱你個問題嗰個。

Android —— 終端機同繪製。 開啟 Settings → Debugging → Show Debug and Logs buttons，然後用起始畫面出現嗰粒 Debug 掣。佢會記錄終端機事件、SSH 資料大細、觸控輸入、調整大細行為同通道生命週期。開始記錄之前，佢會先警告你，話明佢會擷取你打嘅每一個字，連密碼都計埋。停止記錄就會將封存檔寫入你嘅「下載」資料夾。

iOS —— 連線同重連。 開啟 Settings → Diagnostics → Record debug log。佢會記錄每個撥過嘅位址同失敗原因、重連嘗試同佢哋嘅退避、斷咗嘅連線、「peer stopped answering keepalives」、網絡轉變，以及 tmux 指令同佢哋嘅錯誤。Settings 會顯示即時行數，等你確認佢真係記緊嘢，而 Export Debug Log 可以將佢以文字檔案分享出去。佢係存喺記憶體，淨係涵蓋目前呢次應用程式工作階段。

喺分享任何偵錯日誌或封存檔之前請先查看。佢哋係用嚟疑難排解，可能會揭露伺服器名稱、位址、時間或其他環境細節 —— 喺 Android 仲會包括你打過嘅嘢。