从下载到连上第一台服务器，通常不超过五分钟。

## 1. 安装（macOS）

从[官网下载区](/#download)下载 `.dmg`，打开后把 OpsXShell 拖到「应用程序」。

当前版本未做开发者签名与公证，首次打开若被 Gatekeeper 拦截：右键点击 `.app` →「打开」→ 再点「打开」；或在「系统设置 → 隐私与安全性」中点「仍要打开」。

首次启动会：

- 按系统语言选择界面语言（之后可在设置中切换七语种）；
- 自动开始 **30 天专业版全功能试用**——无需注册、无需信用卡；
- 生成 `~/.opsxshell/master.key` 本地加密主密钥，用于加密保存的凭据。

## 2. 快速连接一台主机

按 `Cmd/Ctrl + K` 打开快速连接，输入：

```text
user@host
user@host:2222
```

默认端口 `22`。首次连接会要求确认主机指纹（写入 `~/.ssh/known_hosts`），之后指纹变更会告警。快速连接适合临时使用，不会自动保存会话。

也可以直接点击系统中的深链，唤起已填好目标的快速连接窗口：

```text
ssh://root@opsbase.cn:55555
```

链接中禁止携带密码、远程路径等参数，且连接前需要你手动确认——网页无法静默连上陌生服务器。

## 3. 保存会话，长期使用

在会话侧栏「新建会话」：

- 认证方式选密码或私钥；留空时会自动尝试本机 SSH Agent 与常见默认密钥（`~/.ssh/id_ed25519` 等）。
- 按需设置分组、标签和启动命令。
- 密码与私钥口令保存前经 AES-256-GCM 加密，也可完全不保存密码。

已有大量主机？用「文件 → 导入会话」直接读 `~/.ssh/config`，支持 `Host` / `HostName` / `User` / `Port` / `IdentityFile` / 单个 `ProxyJump`。详见[会话与主机管理](/docs/sessions)。

## 4. 界面速览

- **左侧会话侧栏**：分组、搜索、批量多选；`Cmd/Ctrl + B` 折叠。
- **中央工作区**：多标签终端，`Cmd/Ctrl + D` 分屏，SFTP 双栏与远程桌面也是标签页。
- **状态栏「转发」**：SSH 连上后在这里管理本地 / 远程 / SOCKS5 转发（专业版）。
- **终端工具栏「AI 助手」**：当前连接上的自然语言排障入口（专业版）。

## 5. 常用快捷键

| 快捷键         | 作用                |
| -------------- | ------------------- |
| `Cmd/Ctrl + K` | 快速连接            |
| `Cmd/Ctrl + B` | 折叠 / 展开会话侧栏 |
| `Cmd/Ctrl + D` | 分屏当前终端        |
| `Cmd/Ctrl + W` | 关闭当前标签        |

## 下一步

- 管理几十台主机：[会话与主机管理](/docs/sessions)
- 多机批量操作与广播输入：[终端与批量执行](/docs/terminal)
- 传文件：[SFTP 文件传输](/docs/sftp)