Windows下用MobaXterm连接宇树G1机器人的完整避坑指南（附网络配置技巧）

Windows下用MobaXterm连接宇树G1机器人的完整避坑指南（附网络配置技巧）

最近在折腾宇树G1机器人，发现不少朋友在Windows环境下用MobaXterm连接时总会遇到各种“坑”——网络不通、SSH连不上、权限问题频发。其实这些问题的根源大多不在工具本身，而在于对机器人网络特性和Windows系统配置的理解不够深入。今天我就把自己踩过的坑和解决方案整理出来，希望能帮你少走弯路。

宇树G1机器人本质上是一台运行Linux系统的嵌入式设备，通过SSH进行远程控制是最基础的操作。但和普通的Linux服务器不同，机器人通常没有显示器接口，完全依赖网络连接。这就意味着，如果你的网络配置稍有偏差，整个开发流程就会卡在第一步。我见过不少开发者花几个小时折腾软件安装，最后发现只是IP地址设错了，那种挫败感我深有体会。

这篇文章面向的是需要在Windows环境下对G1机器人进行开发、调试或维护的工程师和研究者。无论你是刚接触机器人开发的新手，还是需要快速排查连接问题的老手，下面的内容都会提供实用的操作步骤和排错思路。我们会从最基础的网络配置讲起，一直深入到高级的防火墙设置和权限管理，确保你能建立起稳定可靠的连接通道。

1. 环境准备与工具选择

在开始连接之前，我们需要先理清整个技术栈。宇树G1机器人默认运行的是基于Ubuntu的定制系统，提供了完整的SSH服务。这意味着从技术原理上讲，任何支持SSH协议的客户端都能连接它。但在Windows环境下，选择什么样的工具会直接影响你的开发体验。

MobaXterm之所以成为很多机器人开发者的首选，不是没有原因的。它集成了SSH客户端、SFTP文件传输、X11转发、串口连接等多种功能于一身，几乎是为嵌入式开发和远程管理量身定制的。更重要的是，它的免费版本功能已经足够强大，不需要像某些商业软件那样频繁破解或寻找替代品。

1.1 MobaXterm的安装与配置

直接从MobaXterm官网下载便携版（Portable edition）是最省事的选择。这个版本不需要安装，解压后直接运行即可，对系统环境的影响最小。我推荐这个版本还有一个原因：当你在多台电脑间切换时，可以直接把整个文件夹拷贝走，所有配置和会话信息都会保留。

下载后解压，你会看到类似这样的目录结构：

MobaXterm_Personal_25.2/
├── MobaXterm.exe
├── MobaXterm.ini
├── MobaXterm.log
└── readme.txt

双击MobaXterm.exe启动，第一次运行时会提示你选择配置模式。这里有个小技巧：选择**"Use MobaXterm personal settings in your home directory"**，这样你的所有配置（包括保存的密码、会话信息）都会存储在用户目录下，即使重装系统也不会丢失。

注意：如果你在受限制的企业环境中使用，可能会遇到权限问题。这时可以尝试右键选择“以管理员身份运行”，或者将整个MobaXterm目录放在非系统盘的用户目录下。

启动后，建议先进行几个关键设置：

1. 终端仿真器设置：点击Settings -> Configuration -> Terminal，将“Terminal font size”调整为12-14之间，这样在长时间编码时眼睛不会太累。同时勾选“Use Ctrl+Shift+C/V for copy/paste”，这能让你像在Windows中一样使用熟悉的快捷键。

2. SSH设置：在SSH配置页面，确保“SSH keepalive”被勾选，并设置为60秒。这个设置能防止连接因长时间空闲而被防火墙断开，对于需要长时间运行的机器人任务特别重要。

3. X11转发：如果你需要通过图形界面操作机器人（比如运行RViz等ROS工具），需要启用X11转发。在Settings -> Configuration -> X11中，确保“X11 remote access”设置为“full”，这样所有图形应用都能正确显示。

1.2 备选方案评估

虽然MobaXterm是我们的主力工具，但了解备选方案也很重要。不同的场景可能需要不同的工具组合：

PuTTY + WinSCP组合：这是最经典的SSH+SFTP组合。PuTTY的轻量级特性使其在资源受限的环境中表现优异，而WinSCP的文件管理界面比命令行更直观。但缺点也很明显：需要在两个工具间切换，配置无法同步。

Windows Terminal + OpenSSH：Windows 10/11自带的OpenSSH客户端现在已经相当成熟。配合Windows Terminal的多标签和分屏功能，能提供接近Linux原生终端的体验。但缺点是对X11转发的支持不够完善，需要额外配置Xming或VcXsrv。

Visual Studio Code Remote SSH：如果你主要进行代码开发，VSCode的Remote SSH扩展是绝佳选择。它能让你在本地编辑代码，在远程执行，还支持端口转发和终端集成。但对于系统管理和故障排查，纯终端工具可能更直接。

为了帮你快速选择，我整理了一个工具对比表：

从我的经验来看，对于宇树G1机器人开发，MobaXterm在大多数情况下都是最优解。它不仅功能全面，而且很多针对嵌入式开发的细节都考虑得很周到，比如串口终端、网络扫描等工具都是内置的。

2. 网络配置的核心原理与实战

网络配置是连接机器人的第一道关卡，也是最容易出问题的地方。很多人在这里卡住，根本原因是对网络连接模式的理解不够清晰。宇树G1机器人支持两种主要的连接方式：有线直连和无线网络。每种方式都有其适用场景和配置要点。

2.1 有线直连：最稳定可靠的选择

有线直连指的是用网线直接将你的Windows电脑与G1机器人的网络接口连接起来。这种方式的最大优点是稳定性和低延迟，特别适合进行固件烧录、系统恢复或实时控制等对网络质量要求高的场景。

物理连接步骤：

1. 准备一根标准的以太网线（Cat5e或以上）
2. 一端插入电脑的网口，另一端插入G1机器人的网络接口
3. 如果电脑没有有线网口，需要准备USB转以太网适配器

连接完成后，Windows通常会自动识别并分配一个“未识别的网络”。这时候不要急着去改设置，先理解背后的网络原理。

IP地址分配机制： 当两台设备通过网线直连时，它们形成了一个最小的局域网。在这个网络中，需要手动为双方分配IP地址，而且这些地址必须在同一个网段内。宇树G1机器人的默认IP地址通常是192.168.123.xxx这个范围，但具体值需要查看官方文档或机器人上的标签。

更常见的情况是，机器人系统已经预设了静态IP，我们需要将电脑的IP配置到同一个网段。这里有个关键点：子网掩码决定了哪些IP地址在同一个局域网内。对于大多数小型网络，使用255.255.255.0（/24）的掩码意味着前三个数字相同的IP都在同一网段。

Windows网络配置实操：

1. 打开“控制面板” -> “网络和共享中心” -> “更改适配器设置”
2. 右键点击你的以太网适配器，选择“属性”
3. 双击“Internet协议版本4 (TCP/IPv4)”
4. 选择“使用下面的IP地址”，然后填入：

   IP地址：192.168.123.100（举例，最后一个数字2-254均可）
   子网掩码：255.255.255.0
   默认网关：192.168.123.1（可选，直连时通常不需要）
   

5. DNS服务器可以留空，或者填8.8.8.8和8.8.4.4

配置完成后，打开命令提示符，用ipconfig命令验证配置是否生效：

C:\> ipconfig

以太网适配器 以太网:
   连接特定的 DNS 后缀 . . . . . . . :
   本地链接 IPv6 地址. . . . . . . . : fe80::xxxx:xxxx:xxxx:xxxx%xx
   IPv4 地址 . . . . . . . . . . . . : 192.168.123.100
   子网掩码 . . . . . . . . . . . . : 255.255.255.0
   默认网关. . . . . . . . . . . . . :

常见问题排查：

• “网络电缆被拔出”：检查网线两端是否插紧，尝试更换网线
• 无法保存IP设置：可能是权限问题，尝试以管理员身份运行网络配置
• IP冲突：如果提示IP地址冲突，换一个最后段的数字，比如从.100换成.101

2.2 无线连接：灵活但需要更多配置

无线连接让机器人摆脱了线缆束缚，适合演示、测试和移动场景。但无线网络的配置比有线复杂，稳定性也相对较差。

连接同一WiFi网络： 这是最简单的无线连接方式，前提是你的电脑和机器人都能连接到同一个WiFi路由器。

1. 在机器人端，你需要通过有线连接先登录系统，然后配置WiFi：

# 查看可用的WiFi网络
unitree@G1:~$ nmcli device wifi list

# 连接到一个WiFi网络（需要sudo权限）
unitree@G1:~$ sudo nmcli device wifi connect "你的WiFi名称" password "你的WiFi密码"

2. 连接成功后，查看机器人获取到的IP地址：

unitree@G1:~$ ip addr show wlan0
2: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether xx:xx:xx:xx:xx:xx brd ff:ff:ff:ff:ff:ff
    inet 192.168.1.105/24 brd 192.168.1.255 scope global dynamic wlan0
       valid_lft 86395sec preferred_lft 75595sec
    inet6 xxxx::xxxx:xxxx:xxxx:xxxx/64 scope link 
       valid_lft forever preferred_lft forever

3. 在你的Windows电脑上，确保连接的是同一个WiFi，然后用这个IP地址进行SSH连接。

创建机器人热点： 有些情况下，你可能无法让机器人和电脑连接同一个WiFi（比如在演示现场没有可用网络）。这时可以让机器人创建