SSH / SFTP / Mosh / rz/sz
SSH 資源可以作為終端打開，也可以打開 SFTP 檔案管理或 Mosh 會話。
基本配置
| 欄位 | 說明 |
|---|---|
| 名稱 | 資源顯示名稱 |
| Host | SSH 服務位址 |
| TCP Port | SSH 連接埠，預設 22 |
| UDP Port | Mosh 資料連接埠，留空或 0 為自動分配（推薦），亦可指定固定連接埠（僅 Mosh） |
| Username | SSH 使用者名稱 |
| 認證方式 | 每次輸入、儲存密碼或私鑰 |
認證方式
每次輸入
打開資源時彈出密碼輸入框。適合不想儲存密碼的場景。
儲存密碼
資源配置中儲存密碼。適合低風險內網服務。
私鑰
先到 設定 > 資源 > SSH 新增私鑰，然後在 SSH 資源中選擇該金鑰。
私鑰可以透過兩種方式新增：
- 貼上已有私鑰。
- 新建 Ed25519 私鑰。
如果私鑰有密碼但設定裡沒有儲存密碼，連線時會彈框要求輸入私鑰密碼。
SSH 終端
終端支援：
- 主題配置。
- 字型大小配置。
- 雙指縮放字號。
- 快捷輸入列。
- Ctrl / Alt 粘滯鍵。
- 方向鍵、PageUp、PageDown、Home、End。
- F1 到 F12。
在 macOS 上執行時通常不顯示行動端快捷鍵列，因為實體鍵盤更適合終端輸入。
選取與複製
iOS / iPadOS
- 長按終端文字打開選單，選擇「選取」選取一個詞，或「全選」選取整個緩衝區。
- 選取後拖動可延伸選取範圍。
- 透過選單中的「拷貝」「貼上」操作剪貼簿內容。
- 輕點其他位置取消選取。
macOS
- 按住滑鼠或觸控板直接拖動選取文字。
- 雙擊選取一個詞。
- 單擊其他位置取消選取。
⌘C複製選取內容，⌘V貼上。
Ctrl 和 Alt 粘滯鍵
點擊 Ctrl 或 Alt 後會進入保持狀態。再按一個鍵會發送組合鍵，例如：
Ctrl後按C等價於Ctrl+C。Alt後按方向鍵可觸發終端程式中的組合操作。
發送一次組合鍵後，粘滯狀態會自動取消。
SFTP 模式
在 SSH 資源編輯頁的 SSH / SFTP / Mosh 選擇器中選擇 SFTP。該資源會在資源列表顯示為 SFTP，並進入檔案管理介面。
Mosh 模式
在 SSH / SFTP / Mosh 選擇器中選擇 Mosh，可使用原版 Mosh 1.4 終端協定。
連線流程：
- OmniGate 先透過配置的 TCP SSH 連接埠連線目標主機。
- SSH 認證成功後，在遠端啟動
mosh-server。 - 終端切換到分配或指定的 UDP 連接埠進行 Mosh 會話。
UDP 連接埠配置：
- 自動分配（推薦）：留空或設為
0。伺服器將自動在可用範圍（通常為 60000~61000）內分配閒置連接埠。可避免連接埠衝突，並允許同時開啟多個獨立 Mosh 會話。 - 固定連接埠：填寫特定連接埠（如
60000）。適用於穿透映射或受限防火牆環境（需確保遠端防火牆放行該 UDP 連接埠）。
連接埠衝突與舊工作階段清理：
- 當使用固定連接埠連線時，若該連接埠已被未結束的舊
mosh-server佔用（報錯Address already in use），App 會彈出提示詢問是否「擠掉舊工作階段並重連」。 - 亦可在資源設定中開啟「連接埠佔用時自動擠掉舊工作階段」開關，固定連接埠衝突時將自動終止佔用連接埠的舊處理程序並重新連線。
使用需求：
- 遠端主機已安裝
mosh-server。 - 允許 OmniGate 到目標主機的 UDP 封包。
- Mosh 支援除 FRP 以外的所有網域類型。
Mosh 沿用 SSH 的使用者名稱、密碼和私鑰配置。它適合不穩定或漫遊網路，可以在短暫中斷或位址變化後重新同步。
Mosh 資源不同時提供 SFTP 和 rz/sz 傳輸。如果需要終端和檔案傳輸，請另外建立 SSH 或 SFTP 資源。
SFTP 預設目錄策略：
- 使用者名稱是
root：預設/ - 其他使用者名稱：預設
/home/<使用者名稱> - 如果手動填寫預設目錄，使用手動值。
rz/sz 檔案傳輸
選擇 SSH 模式時，可以開啟 rz/sz 檔案傳輸。適合 SSH 跳板機場景，因為它透過終端會話透傳，不依賴單獨的 SFTP 通道。
使用方式：
- 遠端執行
rz後，App 彈出檔案選擇，用於上傳。 - 遠端執行
sz <file>後，App 接收並儲存檔案。
注意事項：
- rz/sz 依賴遠端安裝
lrzsz或相容工具。 - 傳輸期間不要關閉 SSH 頁面。
- 如果終端列印異常控制字元，可能是遠端 shell、終端程式或 zmodem 工具輸出與協議流混雜。