一、快速上手
1. 添加主机
首页点右上角「+ 新主机」,填写地址、端口(默认 22)、用户名,选择认证方式:
- 密码认证:可直接保存密码(加密存入系统关键资产),或留空在每次连接时输入
- 私钥认证:粘贴 OpenSSH 私钥,或从「密钥管理器」选择已有密钥(推荐)
2. 首次连接与指纹信任(TOFU)
第一次连接会弹出主机指纹确认:核对 SHA256 指纹与服务器上的指纹一致后点「信任」。
之后每次连接自动校验;若服务器指纹发生变化会弹出变更警告(可能是重装系统,也可能存在中间人风险),请谨慎确认。
3. 开始使用
连接成功即进入终端。返回首页不会断开——主机卡片亮绿点表示会话在线,点卡片即可接回同一 shell(工作目录、环境变量、正在跑的任务都还在)。
小技巧:可选填「分组」(如 家里 / 公司)让首页按组折叠;「网络唤醒」配置后主机卡片可一键 WOL 唤醒再连接。
二、终端
输入
- 辅助按键行:ESC / 粘滞 Ctrl / TAB / 方向键 / ⌫ / ↵ / HOME / END / PGUP / PGDN,钉在键盘上沿;⌫ 和方向键支持长按连发(中文输入法会吞掉这些编辑键,必须走按键行)
- FN 页:F1–F12;SYM 页:32 个常用符号
- 粘滞 Ctrl:点亮 Ctrl 后按字母即发 Ctrl+字母(如 Ctrl+C);方向键组合为词级跳转
- 物理键盘:默认「直连模式」按键不经输入法直发终端(低延迟稳定);要在终端打中文,到顶栏「⋯」切「中文模式」
选择与复制
- 双击选词、长按拖选,拖动有放大镜精准定位
- 选好后按键行「复制」进系统剪贴板;「粘贴」经系统安全控件授权读取
- 复制内容形如网址时,会提示「浏览器打开」
其他
- 搜索:顶栏放大镜,全文搜索终端缓冲区,高亮跳转
- 片段:常用命令保存为片段,一键发送(如
docker ps)
- 清屏 / 断开 / 重连:顶栏与「⋯」菜单
- 字体与主题:设置 → 终端字体(JetBrains Mono / Fira Code / 系统等宽)与字号;五套全局主题
- tmux 现场保持(默认开):连接后自动
tmux new -A -s leafssh,断线重连 shell 现场不丢(服务器需安装 tmux)
三、会话与后台保活
- 会话常驻:返回列表不断线;最多 5 台主机同时在线
- 自动重连:意外断线按 2 / 4 / 8 秒退避自动重连 3 次;网络错误显示时间与人话原因(如「连接超时」)
- 正常退出不重连:终端里
exit 或点「断开」视为主动结束
后台边界(重要):鸿蒙系统对后台应用有冻结机制——切后台或锁屏约 3 分钟后进程可能被冻结(应用会申请短时保活窗口,每日有配额)。冻结≠断开:回到前台会自动检测并恢复连接;需要长时间后台会话时,建议使用 tmux 现场保持,或让应用保持小窗可见。锁屏/熄屏状态下小窗同样会被冻结。
四、文件管理(SFTP)
终端页顶栏「文件」进入。左侧为缓存管理栏,右侧为远端文件。
浏览
- 单击进入目录;长按任意条目弹出操作菜单;面包屑可跳级,「路径」按钮直达任意目录
- 排序(名称/大小/时间 × 升降)与隐藏文件开关在顶栏;重进文件页会记住上次目录
- 边缘侧滑 = 返回上级目录
上传与下载
- 下载到本机:弹系统保存面板,自选位置(同名替换由系统询问)——文件在系统「下载」等目录可见
- 上传:顶栏「上传」从系统文件选择(支持多选)
- 文件夹整树上传/下载;多选批量操作;3 个传输并行,其余排队;传输历史跨启动保留(历史弹窗可清空)
- 支持断点续传:传输中断(含应用被杀)后重进文件页会提示继续
文件操作
- 长按菜单:重命名 / 删除 / 权限(预设 644/755 等 + 八进制输入)/ 复制路径 / 信息 / 打开为
- 复制 / 剪切 / 粘贴:选择模式选中后,导航到目标目录粘贴(远端零流量执行)
- 归档:zip 本地解压/压缩;远端 zip/tar/rar/7z 可「远端解压」(调用服务器工具,零流量)或「远端压缩」
打开与编辑
- 文本:单击快览(无扩展名文件也按文本尝试,二进制自动识别并引导下载);快览页「编辑」进入在线编辑——原子保存,打开期间被他人修改会提示冲突;上限 1MB
- 图片:内置查看器,同目录翻页、双指缩放、幻灯片放映、全屏
- 音视频:单击即边下边播(见下节)
- 「打开为」:调用系统应用打开;本机已有同名同大小文件时直接复用,省流量
缓存管理(左栏)
- 观看视频、预览图片的内容自动缓存到本机(✓ 完整 / ◐ 部分),重复观看零流量秒开
- 容量上限可调(默认 512MB,LRU 自动淘汰);条目可单删 / 批量删 / 清空 / 转存到系统任意位置
- 边下边播:mp4/mkv/mp3/flac 等常见格式单击即播;播放器自动处理缓冲与 seek
- 断点续看:记住上次看到的位置,重进提示续看;缓存内拖动零流量秒达
- ⚡高速通道(文件页缓存栏「⚡播放」):在服务器上启动 Range HTTP 服务 + 本地隧道直连——VPN 等慢链路上速度优先(此模式不写缓存,流量优先场景请关闭)
- 播放/看图期间屏幕保持常亮;播放器全屏不受系统锁屏影响
边界:边下边播需约 0.5MB/s 以上有效带宽;提示「编码/封装格式不支持」是设备解码器限制(如某些 mov/hevc),请下载后用系统播放器或转码 H.264。
六、主机管理
- 分组折叠 / 搜索 / 排序:首页按组折叠展示;搜索匹配名称/地址/用户名/分组;🕘 按最近连接排序,A↓ 按名称
- 网络唤醒(WOL):主机配置 MAC 后,卡片一键唤醒(连发 3 个魔术包 + 等待上线),连接失败横幅也有唤醒入口;需目标机 BIOS/网卡开启 WOL
- 主机体检:终端页「⋯ → 主机体检」——负载 / 内存 / 磁盘用量一览(阈值变色)
- 公钥部署:终端页「⋯ → 部署公钥」——从密钥管理器选一把公钥,一条命令幂等写入服务器 authorized_keys(ssh-copy-id 等价)
- 编辑 / 删除:卡片右侧编辑;长按卡片删除(同时清除本机保存的该主机全部凭据)
七、跳板机与端口转发
跳板机(ProxyJump,ssh -J 等价)
目标主机在内网、需经跳板机中转时:编辑主机 → 「跳板机(可选)」→ 从主机列表选择跳板机。要求:
- 跳板机先直连一次完成指纹信任(本应用内操作)
- 跳板机自己的凭据已保存(用跳板机主机配置的认证方式)
- 服务器无需安装任何工具;跳板机也可配置自己的出站代理(如身处 VPN 网)
端口转发
主机编辑页「端口转发」添加规则,随连接自动启用、断开自动停:
| 类型 | 方向 | 典型用途 |
| 本地转发 | 本机端口 → 经 SSH → 固定目标 | 访问服务器可达的内网 Web 面板 / 数据库 |
| 动态转发 | 本机 SOCKS5 代理 → 经 SSH | 运维出口(域名由服务器解析) |
| 远程转发 | 服务器监听端口 → 回推 → 本机侧目标 | 把本机服务暴露给服务器侧 |
连接后终端页顶部显示隧道摘要;启动失败(如端口被占)标 ⚠ 并提示。
八、密钥管理器
- 首页「密钥」进入(需本机身份核验);ed25519 密钥生成 / 导入 / 删除 / 复制公钥
- 私钥与口令存系统关键资产(硬件加密);主机配置直接引用,删除密钥自动解绑引用它的主机
- 公钥经「部署公钥」一键写入服务器
九、安全与隐私
- 零收集:不采集任何个人信息,无广告、无第三方 SDK、无服务器端——应用直连你的服务器
- 凭据硬件加密:密码 / 私钥 / 口令存入系统关键资产;查看或使用需指纹 / 人脸 / 锁屏密码本机核验
- TOFU 指纹校验:首次信任 + 变更告警;「清除已信任指纹」入口在主机编辑页
- 剪贴板:仅在点「粘贴」时经系统安全控件临时授权读取,不读历史
- 调试开关:设置 →「跳过本机认证」仅供无锁屏的开发设备使用(正式版默认关闭)
十、网络与代理
- 出站代理三选一:直连 / SOCKS5(支持账号密码)/ HTTP CONNECT
- 域名目标经代理远程解析——兼容 EasyTier 等组网工具的虚拟网主机名(配合 LeafVPN 全局组网更佳)
- 保活心跳间隔可调(设置 → 行为,5–120 秒,对新建连接生效)
十一、设置项速查
| 分区 | 项 | 说明 |
| 终端 | 字体 / 字号 | 三款内置等宽字体,9–28 号 |
| 终端 | 主题 | 奶油黄 / Termux / Dracula / Nord / Solarized Dark,全局生效 |
| 行为 | 辅助按键行 / 物理键盘直连 | 终端页快捷开关同源 |
| 行为 | tmux 现场保持 | 默认开;服务器无 tmux 自动回退普通 shell |
| 行为 | 保活间隔 | SSH 心跳;间隔×4 次无响应判死 |
| 行为 | 缓存上限 | 媒体磁盘缓存容量(0=不限) |
| 安全 | 跳过本机认证(调试) | 开发设备专用;开启时密钥管理可另设仍需认证 |
| 工具 | 网络唤醒 | WOL 主机独立管理页 |
十二、常见问题
切后台 / 锁屏一段时间后断了?
系统冻结机制所致(见「会话与后台保活」)。回到前台自动恢复;长会话建议 tmux;重连后 shell 现场由 tmux 找回。
下载的文件在哪里?
「下载到本机」弹系统保存面板,你选的位置(如「下载」目录)就是落点;文件夹整树下载落应用内目录(有 toast 明示),需系统位置请对单个文件下载。
某个视频放不出来?
先看错误提示:「编码/封装格式不支持」= 设备解码限制,下载后用系统播放器或转码;「流中断/超时」= 链路太慢,试试 ⚡高速通道或先下载。
SSH 连着但文件页报错?
重新进入文件页即自动恢复(SFTP 通道自动重建);若仍失败请重连 SSH。
物理键盘打不了中文?
终端顶栏「⋯」→「中文」切换到输入法模式;直连模式按键直发终端(英文命令场景更稳)。
安全模式下「查看」已存密码的按钮不见了?
不会不见——需要先通过一次本机身份核验(指纹/人脸/锁屏密码)才会显示内容;若设备未设锁屏密码请先在系统设置中配置。