创建第一个连接
本文将引导你创建第一个 SSH 连接并成功登录到远程服务器。
准备工作
在开始之前，请确保你有以下信息：
- 服务器 IP 地址或域名
- SSH 端口号（默认为 22）
- 登录用户名
- 登录密码或 SSH 私钥
首次启动
首次启动 XTerminal 时，会显示新用户引导，帮助你完成初始设置。
步骤 1：选择账号方式
你可以选择：
- 使用本地账号：数据仅保存在本机，适合单设备使用
- 登录云端账号：绑定云端账号，实现多设备数据同步
如果暂时不想决定，可以点击右下角 跳过此步。
步骤 2：绑定微信（可选）
使用微信扫描二维码关注公众号即可完成绑定。绑定后可以：
- 使用微信快捷登录
- 接收重要通知
此步骤可跳过，后续可在设置中绑定。
步骤 3：设置仓库密码
仓库密码用于端到端加密你的敏感信息（如服务器密码、私钥）。
重要提示：
- 仓库密码仅保存在本地，XTerminal 不会上传到云端
- 请牢记此密码，忘记后将无法解密历史数据
- 建议将密码保存到安全的地方
输入密码后点击 确认并继续，系统会提示你保存密码。
步骤 4：完成设置
点击 开始使用 进入主界面。
打开连接中心
- 启动 XTerminal
- 应用启动后会自动显示连接中心
- 确保左上角选中了 SSH 标签
新建连接
步骤 1：点击新建
在连接中心，点击 + 新建SSH连接 按钮，或点击工具栏的 +SSH 按钮。
步骤 2：填写基本信息
在弹出的连接配置窗口中填写：
| 字段 | 说明 | 示例 |
|---|---|---|
| 分组 | 选择连接所属分组（可选） | 生产服务器 |
| 名称 | 连接的显示名称，便于识别 | 我的服务器 |
| 地址 | 服务器 IP 地址或域名 | 192.168.1.100 |
| 端口 | SSH 端口号 | 22 |
| 登录用户 | 登录用户名 | root |
| 主机备注 | 备注信息（可选） | 数据库服务器 |
步骤 3：配置验证方式
XTerminal 支持多种验证方式：
密码
- 验证方式选择 密码
- 输入登录密码
秘钥
- 验证方式选择 秘钥
- 点击浏览按钮选择私钥文件（通常位于
~/.ssh/id_rsa或~/.ssh/id_ed25519） - 如果私钥有密码保护，输入私钥密码（Passphrase）
登录凭证
如果你在凭证管理中预先配置了 SSH 密钥：
- 验证方式选择 登录凭证
- 从下拉列表中选择已配置的凭证
凭证管理功能可以集中管理多个 SSH 密钥，方便在多台服务器间复用。
交互认证
用于支持双因素认证（2FA）或其他交互式验证场景：
- 验证方式选择 交互认证
- 连接时会弹出对话框，按提示输入验证信息
每次询问
如果不想保存密码，可以选择每次连接时手动输入：
- 验证方式选择 每次询问
- 每次连接时会弹出密码输入框
步骤 4：保存连接
点击 创建 按钮保存连接配置。新创建的连接会出现在连接列表中。
建立连接
保存连接后，有多种方式发起连接：
- 双击：在连接列表中双击连接项
- 右键菜单：右键点击连接，选择 连接
- 工具栏：选中连接后，点击工具栏的 连接 按钮
终端操作
连接成功后，你会进入终端界面：
- 命令行提示符表示已成功登录
- 可以像使用普通终端一样输入命令
- 支持复制粘贴操作
尝试执行一些基本命令：
# 查看当前用户
whoami
# 查看系统信息
uname -a
# 查看当前目录
pwd
断开连接
完成工作后，可以通过以下方式断开连接：
- 输入
exit命令退出 - 关闭终端标签页
- 点击工具栏的断开按钮
常见问题
连接超时
可能原因：
- 服务器 IP 地址错误
- 端口号不正确
- 防火墙阻止连接
- 网络不通
解决方法：
- 确认服务器信息正确
- 检查网络连通性（ping 服务器地址）
- 确认服务器 SSH 服务正在运行
- 检查防火墙规则
认证失败
可能原因：
- 用户名或密码错误
- 私钥文件不匹配
- 私钥密码错误
解决方法：
- 确认用户名和密码正确
- 确认使用正确的私钥文件
- 检查服务器是否允许该认证方式
服务器拒绝连接
可能原因：
- SSH 服务未启动
- 端口号错误
- IP 被服务器禁止
解决方法：
- 确认 SSH 服务状态
- 检查
/etc/ssh/sshd_config配置 - 查看服务器安全日志