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 工具输出与协议流混杂。