SSH
SSH 文档
Unfour 将保存的 SSH 连接、交互式终端会话、远程文件、命令历史和可复用任务统一放在当前工作区中。
创建 SSH 连接
- 打开 SSH 并创建连接。
- 输入显示名称、主机、端口和用户名。
- 选择密码、私钥或无认证。私钥认证需填写本地密钥路径，并可填写口令。
- 先 Test connection，再 Save。密码和口令以本地凭据引用保存，重新打开表单不会显示秘密。
打开终端
- 选择保存的连接并连接，打开基于 PTY 的终端会话。
- 正常使用终端；会话会转发键盘输入，并随面板尺寸调整远程 PTY。
- 可使用分屏、输出搜索、日志复制/导出，以及 Copy、Paste、Paste Selected Text、Select All 右键操作。
- 结束后关闭会话。关闭仍处于连接状态的会话会先要求确认。
主机密钥与重连
首次连接时，请先复核主机密钥指纹再信任。之后出现指纹不匹配时，Unfour 会拒绝连接，不会静默替换已信任密钥。
- 只信任通过独立渠道核验过的指纹。
- 服务器密钥确实发生变更时，从连接界面重置保存的指纹，再重连并复核新值。
- 失败和重连状态会保留，失败会话标签不会立即消失，便于查看错误。
- 重连恢复终端传输；继续被中断的命令前应先确认远程状态。
命令历史
远程 Shell 回显命令后，Unfour 会记录结构化命令历史。历史按工作区和连接隔离、在本地限制数量，并进行保守脱敏。
- 在识别出的 Shell 提示符后输入至少两个字符，可看到最多六条匹配建议。
- 使用上下键选择、Tab 或点击插入、Escape 关闭；Enter 始终提交当前输入行。
- 密码提示符后的输入不会保存；无法安全分类的命令可能被排除或显示为已脱敏。
- MCP 可按当前工作区、连接、文本、时间范围和数量查询历史，但不会返回终端缓冲或原始会话日志。
SFTP 远程文件
从已连接终端会话中打开 Remote Files。SFTP 面板会使用该会话和连接浏览远程文件系统。
- 打开目录、输入远程路径、返回上级目录并刷新列表。
- 上传本地文件或拖放上传，并下载选中的远程文件。
- 创建文件夹、重命名条目、删除可丢弃路径，并复制远程路径。
- 查看并取消传输；每个 SSH 连接同一时间只流式执行一个上传或下载。
SSH Tasks
SSH Task 是按顺序执行的已保存步骤，可由 command、upload 和 download 组成。任务属于工作区，并可设置默认连接。
- 打开 Tasks，创建任务，并按需要的顺序添加步骤。
- 在支持的命令和路径字段中使用 {{name}} 占位符。运行输入可从工作区全局变量和所选环境预填，敏感输入应标记为 secret。
- 在 Run 对话框中复核目标连接、解析后的输入和启用步骤，再开始运行。
- 查看实时输出和步骤状态，之后可检查持久化的运行摘要与日志；必要时可取消运行。