# 如何连接 SSH 服务器？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：远程连接。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/ssh_connect/

## 首次连接（Pro）

1. 打开 **设置 → 连接与高级 → 远程连接 → 添加服务器**。
2. 填写服务器地址、SSH 端口（通常为 22）和服务器上的用户名。名称可选，地址填写 IP 或域名，不带 ssh://。
3. 选择 **私钥** 或 **密码**。私钥从文件选择；有私钥口令时再填写口令。登录凭据自动加密保存在本机，无需另外开启保存；缺少或无法读取时，按提示补充后再连接。
4. 点击 **连接**。首次连接需将主机指纹与服务器控制台或管理员提供的信息比对，核验后选择 **信任并连接**。

## 终端与聊天工具

- **打开终端 / 继续终端**：直接输入命令，按 Enter 执行，不需要配置模型，也不逐条审批。终端输入和输出不会自动发给模型。
- **聊天中的远程连接工具**：在聊天工具列表勾选“远程连接”即可，无需先选服务器。“远程连接”入口与联网、工具、推理位于同一排；点击可管理服务器。模型先查询已配置的服务器，再按你的需求指定目标执行；目标不明确时应先询问。每次执行都会显示目标服务器，模型必须支持工具调用。

手动终端与聊天命令可以同时连接同一服务器，聊天使用独立连接，不继承终端中的当前目录和临时环境变量；同一服务器的聊天执行仍互斥。服务器页面不保存对话与主机的绑定。

## 编辑连接

在服务器列表点击 **编辑**。未填写新凭证时保留原凭证；切换认证方式时需确认该方式的凭据可用。**更多设置 → 默认目录**用于聊天命令，留空时使用远端登录目录。正在占用的连接需先结束再编辑。

服务器卡片可单独控制是否允许 AI 使用该主机。关闭后，助手不能通过远程工具发现或操作它，手动终端与文件浏览仍按原有权限使用；开启 AI 使用也不会跳过主机指纹和命令授权。

主机指纹变化时先通过其他渠道核验，再管理旧信任，不能直接沿用原授权。

## 网络存储

远程连接页底部的 **网络存储** 用于添加 NAS、坚果云等 WebDAV 存储，让 AI 在对话里直接读写文件，和 SSH 服务器互不影响。详见「怎么把 NAS 或网盘接进对话？」。