LeafSSH 图标

LeafSSH 使用说明

风与叶子 · 零收集 SSH 终端与文件管理器 · v1.2.1

一、快速上手

1. 添加主机

首页点右上角「+ 新主机」,填写地址、端口(默认 22)、用户名,选择认证方式:

2. 首次连接与指纹信任(TOFU)

第一次连接会弹出主机指纹确认:核对 SHA256 指纹与服务器上的指纹一致后点「信任」。 之后每次连接自动校验;若服务器指纹发生变化会弹出变更警告(可能是重装系统,也可能存在中间人风险),请谨慎确认。

3. 开始使用

连接成功即进入终端。返回首页不会断开——主机卡片亮绿点表示会话在线,点卡片即可接回同一 shell(工作目录、环境变量、正在跑的任务都还在)。

小技巧:可选填「分组」(如 家里 / 公司)让首页按组折叠;「网络唤醒」配置后主机卡片可一键 WOL 唤醒再连接。

二、终端

输入

选择与复制

其他

三、会话与后台保活

后台边界(重要):鸿蒙系统对后台应用有冻结机制——切后台或锁屏约 3 分钟后进程可能被冻结(应用会申请短时保活窗口,每日有配额)。冻结≠断开:回到前台会自动检测并恢复连接;需要长时间后台会话时,建议使用 tmux 现场保持,或让应用保持小窗可见。锁屏/熄屏状态下小窗同样会被冻结。

四、文件管理(SFTP)

终端页顶栏「文件」进入。左侧为缓存管理栏,右侧为远端文件。

浏览

上传与下载

文件操作

打开与编辑

缓存管理(左栏)

五、媒体播放

边界:边下边播需约 0.5MB/s 以上有效带宽;提示「编码/封装格式不支持」是设备解码器限制(如某些 mov/hevc),请下载后用系统播放器或转码 H.264。

六、主机管理

七、跳板机与端口转发

跳板机(ProxyJump,ssh -J 等价)

目标主机在内网、需经跳板机中转时:编辑主机 → 「跳板机(可选)」→ 从主机列表选择跳板机。要求:

端口转发

主机编辑页「端口转发」添加规则,随连接自动启用、断开自动停:

类型方向典型用途
本地转发本机端口 → 经 SSH → 固定目标访问服务器可达的内网 Web 面板 / 数据库
动态转发本机 SOCKS5 代理 → 经 SSH运维出口(域名由服务器解析)
远程转发服务器监听端口 → 回推 → 本机侧目标把本机服务暴露给服务器侧

连接后终端页顶部显示隧道摘要;启动失败(如端口被占)标 ⚠ 并提示。

八、密钥管理器

九、安全与隐私

十、网络与代理

十一、设置项速查

分区项说明
终端字体 / 字号三款内置等宽字体,9–28 号
终端主题奶油黄 / Termux / Dracula / Nord / Solarized Dark,全局生效
行为辅助按键行 / 物理键盘直连终端页快捷开关同源
行为tmux 现场保持默认开;服务器无 tmux 自动回退普通 shell
行为保活间隔SSH 心跳;间隔×4 次无响应判死
行为缓存上限媒体磁盘缓存容量(0=不限)
安全跳过本机认证(调试)开发设备专用;开启时密钥管理可另设仍需认证
工具网络唤醒WOL 主机独立管理页

十二、常见问题

切后台 / 锁屏一段时间后断了?

系统冻结机制所致(见「会话与后台保活」)。回到前台自动恢复;长会话建议 tmux;重连后 shell 现场由 tmux 找回。

下载的文件在哪里?

「下载到本机」弹系统保存面板,你选的位置(如「下载」目录)就是落点;文件夹整树下载落应用内目录(有 toast 明示),需系统位置请对单个文件下载。

某个视频放不出来?

先看错误提示:「编码/封装格式不支持」= 设备解码限制,下载后用系统播放器或转码;「流中断/超时」= 链路太慢,试试 ⚡高速通道或先下载。

SSH 连着但文件页报错?

重新进入文件页即自动恢复(SFTP 通道自动重建);若仍失败请重连 SSH。

物理键盘打不了中文?

终端顶栏「⋯」→「中文」切换到输入法模式;直连模式按键直发终端(英文命令场景更稳)。

安全模式下「查看」已存密码的按钮不见了?

不会不见——需要先通过一次本机身份核验(指纹/人脸/锁屏密码)才会显示内容;若设备未设锁屏密码请先在系统设置中配置。