宇树G1机器人SSH连接实战：MobaXterm配置与网络调试指南
1. 为什么需要SSH连接宇树G1机器人？
当你拿到宇树G1机器人时，可能会遇到一个常见问题：机器人的显示器接口损坏或者根本没有配备显示器。这时候，SSH（Secure Shell）远程连接就成了救命稻草。通过SSH，你可以像操作本地电脑一样控制机器人，进行代码调试、系统配置等操作，完全不需要依赖物理显示器。
我去年在调试G1机器人时就遇到过这种情况。当时机器人刚到实验室，HDMI接口就莫名其妙失灵了。幸好通过SSH连接，不仅完成了所有开发调试，还发现这种方式比直接操作机器人更方便——毕竟谁愿意蹲在地上对着小屏幕敲代码呢？
2. 准备工作：硬件与软件清单
2.1 硬件准备
首先确认你手头有以下设备：
- 宇树G1机器人（废话）
- 一台Windows电脑（本文以联想Y7000P为例）
- 网线一根（建议带千兆网口，传输大文件时会快很多）
- 路由器或交换机（可选，用于无线连接场景）
这里有个小技巧：如果你手头的网线不够长，可以先用USB转网口适配器临时解决。我实验室就常备几个绿联的USB千兆网卡，兼容性很不错。
2.2 软件准备
软件方面主要需要：
- MobaXterm：全能终端工具，比Putty好用不止一个量级
- VSCode：可选，但强烈推荐用于代码开发
- 机器人系统镜像：确保是最新版本
MobaXterm我推荐下载便携版（Portable edition），解压就能用，不需要安装。最新版下载地址可以直接在官网找，这里提醒下要选Home Edition，个人使用是免费的。
3. 网络连接配置详解
3.1 有线连接方案
这是最稳定的连接方式，步骤如下：
- 用网线连接电脑和机器人的网口
- 打开Windows网络设置（Win+I → 网络和Internet）
- 进入"更改适配器选项"
- 右键点击对应的网络适配器 → 属性 → IPv4
- 手动设置IP地址为192.168.123.xxx（xxx建议在100-200之间）
- 子网掩码255.255.255.0
- 默认网关留空
这里有个坑我踩过：一定要确保IP地址和机器人在同一网段。宇树G1默认IP是192.168.123.161，所以你的电脑IP应该是192.168.123.xxx。
3.2 无线连接方案
如果想摆脱网线束缚，可以这样操作：
- 将电脑和机器人连接到同一个WiFi
- 在机器人端通过有线连接修改WiFi配置
- 使用
iwconfig命令查看无线网卡状态 - 用
nmtui命令配置无线连接
实测下来无线延迟会比有线高一些，适合不需要实时控制的场景。如果是做运动控制，强烈建议还是用有线。
4. MobaXterm安装与配置
4.1 安装步骤
虽然官网提供了安装版，但我更推荐便携版：
- 下载MobaXterm Portable压缩包
- 解压到任意目录（建议不要放在C盘）
- 直接运行MobaXterm.exe即可
安装版有个小问题：默认会装到Program Files，需要管理员权限才能保存session配置。便携版就没这个烦恼，所有配置都保存在本地目录。
4.2 基础配置
首次运行建议进行这些设置：
- 设置默认字体为Consolas 14pt（看着更舒服）
- 开启X11转发（方便运行GUI程序）
- 配置ZMODEM传输（传文件超方便）
- 修改配色方案（个人喜欢Ubuntu风格）
这些设置都在Settings菜单里，找不到的话可以直接搜索。记得点OK保存，配置会自动保存到本地。
5. 建立SSH连接实战
5.1 首次连接步骤
打开MobaXterm后：
- 点击左上角Session → SSH
- 输入机器人IP（默认192.168.123.161）
- 用户名填unitree
- 密码填123（建议首次登录后立即修改）
- 勾选"Specify username"
如果一切正常，你会看到机器人终端欢迎信息。第一次连接可能会弹出密钥确认，直接点Yes就行。
5.2 常见连接问题排查
如果连不上，可以按这个流程检查：
- 先用
ping 192.168.123.161测试网络连通性 - 检查防火墙设置（临时关闭试试）
- 确认SSH服务正在运行（
service ssh status） - 查看IP配置是否正确（
ifconfig命令）
我遇到过最奇葩的问题是网线接触不良，换了三根线才发现。所以第一步永远是确认物理连接正常！
6. 进阶网络调试技巧
6.1 网络状态监测
这几个命令非常实用：
ip a：查看所有网络接口详情nload：实时监控网络流量（需安装）mtr：网络质量诊断工具tcptrack：查看活跃TCP连接
安装方法很简单：
sudo apt update sudo apt install nload mtr tcptrack6.2 带宽测试
如果需要传输大文件，建议先测速：
# 在机器人端启动服务 iperf3 -s # 在电脑端测试 iperf3 -c 192.168.123.161 -t 20正常千兆有线应该能达到900Mbps以上，无线就看信号强度了。
7. VSCode远程开发环境搭建
7.1 安装Remote-SSH插件
在VSCode扩展商店搜索"Remote - SSH"，安装微软官方插件。这个插件允许你直接把VSCode变成SSH客户端，编辑远程文件就像本地一样流畅。
7.2 连接配置
按F1打开命令面板，输入"Remote-SSH: Connect to Host" → "Add New SSH Host"，然后输入：
ssh unitree@192.168.123.161保存后选择这个配置连接，输入密码即可。首次连接会有点慢，因为要安装服务端组件。
7.3 实用功能
连接成功后可以：
- 直接编辑机器人上的代码文件
- 使用终端执行命令
- 调试Python/C++程序
- 管理Docker容器（如果装了）
我最喜欢的是端口转发功能，可以把机器人的Jupyter Notebook端口转发到本地浏览器访问。
8. 安全加固建议
8.1 修改默认密码
首次登录后立即执行：
passwd然后输入新密码（建议包含大小写字母+数字+特殊字符）。
8.2 密钥认证配置
比密码更安全的登录方式：
- 在MobaXterm生成密钥对（Tools → MobaKeyGen）
- 将公钥上传到机器人：
mkdir -p ~/.ssh cat >> ~/.ssh/authorized_keys < your_pub_key chmod 600 ~/.ssh/authorized_keys- 在SSH配置中禁用密码登录（需谨慎）
8.3 防火墙设置
建议启用UFW防火墙：
sudo apt install ufw sudo ufw allow 22/tcp sudo ufw enable9. 实用命令速查表
| 命令 | 功能 | 示例 |
|---|---|---|
ssh-copy-id | 上传公钥 | ssh-copy-id unitree@192.168.123.161 |
rsync | 同步文件 | rsync -avz ./local_dir unitree@192.168.123.161:~/remote_dir |
htop | 进程监控 | sudo apt install htop && htop |
journalctl | 查看日志 | journalctl -u ssh -f |
scp | 安全传输 | scp file.txt unitree@192.168.123.161:~/ |
10. 疑难问题解决方案
问题1：连接后立即断开可能是网络不稳定，尝试：
ssh -o ServerAliveInterval=60 unitree@192.168.123.161问题2：X11转发失败检查MobaXterm设置：
- Settings → X11 → 勾选"X11 forwarding"
- 确保DISPLAY变量已设置
问题3：中文乱码在MobaXterm终端执行：
export LANG=zh_CN.UTF-8记得把这些配置加到~/.bashrc里永久生效。