远程 SSH 连接

#远程 SSH 连接概述

Codar 远程 SSH 连接功能允许你将 Agent 连接到远程服务器，在服务器上执行数据分析、环境配置和计算任务。这对于需要 GPU 算力、大数据存储或特定运行环境的研究场景特别有用。

#一、添加 SSH 连接

打开 设置 → 连接，切换到 SSH 标签页，然后点击 新增连接。

Codar 提供两种配置方式：

1. 从 ~/.ssh/config 导入：读取本机已有的 SSH 配置文件，可批量导入服务器信息，适合已经配置过 SSH 的用户。
2. 手动添加：手动填写服务器参数。下文以此方式为例进行说明。

选择从配置文件导入时，勾选一个或多个 Host，然后点击 导入并连接。

#二、选择登录方式

#方式 1：密钥登录（推荐）

密钥登录安全性更高，建议优先使用。

1. 选择 手动添加，点击 密钥登录。
2. 填写连接参数：

3. 确认信息无误后，点击右下角 添加并连接。

#方式 2：密码登录

1. 选择 手动添加，切换到 密码登录。
2. 填写连接名称、主机 / IP、端口和用户名。
3. 输入服务器登录密码。
4. 点击 添加并连接 建立连接。

连接信息会保存在本机 Codar 配置目录，方便后续重新连接。

请妥善保管登录密码和私钥，不要将其分享给他人。

#三、连接管理

#连接列表

返回 设置 → 连接 → SSH，即可查看所有已配置的连接：

• 显示连接名称、主机和在线状态。
• 绿色圆点表示连接正常，红色表示连接异常。
• 点击连接卡片可查看详情。

#编辑与删除

• 点击「编辑」修改服务器配置。
• 点击「移除」删除连接（不影响服务器上的数据）。

#自动重连

• 连接断开时自动尝试重连（最多 3 次）。
• 重连失败后会在界面显示断开状态。
• 可手动点击「重新连接」。

#四、在对话中使用远程连接

#使用远程文件夹

SSH 连接成功后，可以把服务器上的文件夹添加为 Codar 项目：

1. 在左侧 项目 区域点击 +。
2. 选择 使用远程文件夹。

3. 选择已经连接的 SSH 服务器，再选择需要使用的远程目录。
4. 添加完成后，从项目列表打开该目录并创建对话。

远程项目旁会显示 SSH 标识和连接状态。绿色圆点表示连接正常，此时 Codar 可以在所选目录中读取文件并执行任务。

#远程操作能力

关联远程连接后，Agent 可以：

#使用示例

请连接到实验室 GPU 服务器，检查 CUDA 版本和 GPU 状态，
然后运行 /home/researcher/analysis/train.py 脚本，
监控训练过程并在完成后下载结果文件。

Agent 会通过 SSH 连接依次执行：

1. 检查 CUDA 版本：nvcc --version
2. 检查 GPU 状态：nvidia-smi
3. 运行训练脚本：python train.py
4. 监控训练日志
5. 下载结果文件到本地项目目录

#五、安全机制

#权限控制

• 远程 SSH 操作受对话权限等级约束。
• 只读模式下，Agent 只能查看远程文件，不能修改或执行命令。
• 完全权限模式下，agent可完全使用读写功能操作设备中的文件。

#操作日志

• 日志中记录必要的agent运行信息。
• 包含执行的命令、执行时间、执行结果。
• 支持按时间和连接筛选查看。

#安全建议

• 使用密钥认证而非密码认证。
• 限制远程用户的权限范围（如仅允许访问特定目录）。
• 定期检查操作日志，确认无异常操作。
• 建议不同用户使用不同ssh账号和密码登录服务器，避免不同用户使用同一账号造成codar文件目录用户会话信息混杂。

#六、常见问题

#七、下一步

• 阅读 权限选择与领域选择，了解权限控制机制。
• 阅读 定时任务，了解如何在定时任务中使用远程连接。