Remote Terminal MCP

# 服务器连接验证方法论 ## 📖 文档概述 本文档记录了针对Remote Terminal MCP项目中服务器连接验证的结构化方法论，特别是针对通过Relay跳板机连接的服务器（如cpu_221）的验证流程。 ## 🎯 验证方法论框架 ### **4阶段分层验证模式** #### **阶段1：Relay跳板机登录验证** - **目标**：验证是否成功登录到Relay跳板机环境 - **检查方式**：寻找输出中的 `"-bash-baidu-ssl$"` 提示符 - **成功标准**： - 出现 `"[+] Relay: Login Giano succeeded by BEEP."` 消息 - 看到 `"-bash-baidu-ssl$"` 提示符 - **失败标准**：没有该提示符或出现认证失败信息 #### **阶段2：目标服务器登录验证** - **目标**：验证是否从跳板机成功SSH到目标服务器 - **检查方式**：寻找包含目标主机名的提示符 - **成功标准**： - 出现类似 `[用户名@主机名.域名 ~]$` 的提示符 - 例如：`[xuyehua@bjhw-sys-rpm0221.bjhw.baidu.com ~]$` - **失败标准**：仍然停留在 `"-bash-baidu-ssl$"` 跳板机提示符 #### **阶段3：基础环境验证** - **目标**：验证目标服务器的基础命令可用性 - **检查方式**：测试基本系统命令（hostname、whoami、pwd） - **成功标准**：基础命令正常执行并返回预期结果 - **失败标准**：基础命令不可用或返回错误 #### **阶段4：Docker容器登录验证** - **目标**：验证Docker容器环境的可访问性 - **检查方式**：寻找Docker容器内的特征提示符 - **成功标准**： - 出现容器特有的提示符 - 例如：`(python38_torch201_cuda) root@主机名:/目录#` - **失败标准**：无法进入容器或容器不存在 ## 🔧 正确的操作流程 ### **cpu_221服务器连接示例** #### **步骤1：执行relay-cli（重要：不带参数）** ```bash # 正确方式 relay-cli # ❌ 错误方式 - 不要带主机名参数 # relay-cli -h bjhw-sys-rpm0221.bjhw -u xuyehua ``` #### **步骤2：在relay环境中SSH到目标服务器** ```bash # 在看到 "-bash-baidu-ssl$" 提示符后执行 ssh xuyehua@bjhw-sys-rpm0221.bjhw ``` #### **步骤3：验证基础环境** ```bash # 在目标服务器上验证 hostname && whoami && pwd ``` #### **步骤4：进入Docker容器** ```bash # 查看可用容器 docker ps | grep xyh_pytorch # 进入容器 docker exec -it xyh_pytorch bash ``` ## 📋 验证工具和命令 ### **使用MCP工具验证** ```bash # 查看服务器列表 mcp_remote-terminal-mcp-local_list_servers # 连接服务器 mcp_remote-terminal-mcp-local_connect_server # 执行命令 mcp_remote-terminal-mcp-local_execute_command # 检查状态 mcp_remote-terminal-mcp-local_get_server_status ``` ### **使用run_local_command逐步验证** ```bash # 检查tmux会话 tmux list-sessions | grep cpu_221 # 向会话发送命令 tmux send-keys -t cpu_221_session 'relay-cli' Enter # 捕获会话输出 tmux capture-pane -t cpu_221_session -p ``` ## ⚠️ 常见问题和解决方案 ### **问题1：连接超时断开** - **症状**：出现 `"timed out waiting for input: auto-logout"` - **原因**：连接空闲时间过长 - **解决**：保持连接活跃或重新建立连接 ### **问题2：命令不可用** - **症状**：基础命令显示 `"command not found"` - **原因**：在受限的跳板机环境中执行命令 - **解决**：确保已正确登录到目标服务器 ### **问题3：重复登录提示** - **症状**：每次命令都重新显示登录界面 - **原因**：连接不稳定或未正确建立会话 - **解决**：检查连接状态，重新建立稳定连接 ## 🎯 关键学习要点 ### **1. 分层验证的重要性** - 不能跳过任何验证阶段 - 每个阶段都有明确的成功/失败标准 - 基于输出特征判断，而不是盲目执行命令 ### **2. relay-cli的正确用法** - ⚠️ **重要**：relay-cli命令不带主机名参数 - 先登录relay环境，再SSH到目标服务器 - 这是两个分离的步骤，不是一个命令完成 ### **3. 逐步验证的优势** - 每步都有明确反馈 - 问题定位更加准确 - 避免在错误状态下继续操作 ## 📊 验证结果记录 ### **cpu_221服务器验证记录（2025-01-16）** - ✅ **阶段1**：Relay登录成功 - ✅ **阶段2**：目标服务器登录成功（bjhw-sys-rpm0221.bjhw.baidu.com） - ✅ **阶段3**：基础环境验证通过 - ✅ **阶段4**：Docker容器登录成功（xyh_pytorch） **最终环境**： - 提示符：`(python38_torch201_cuda) root@bjhw-sys-rpm0221:/home#` - 环境：PyTorch + CUDA支持 - 状态：完全可用 ## 🔄 持续改进 ### **后续优化方向** 1. 自动化验证脚本开发 2. 连接稳定性改进 3. 验证结果的结构化记录 4. 异常情况的自动恢复机制 --- **更新日期**：2025-01-16 **验证人员**：AI助手 + 用户协作 **适用范围**：Remote Terminal MCP项目中的所有Relay连接服务器