RMinte
全部指南 网络配置

网络连接

RM-01 网络配置指南

说明 C1 与 C3 两条网络连接路径，以及用户设备接入、AI 辅助网络共享和整机接入上层网络的方法。

7 个章节 六种语言 TianshanOS

试试：OTA 更新、远程主机、HTTPS 证书、自动化规则

展开本页目录

1. 先了解两条网络连接路径

RM-01 提供两条基于 USB-C 的网络连接路径，本文分别称为 C1 接口和 C3 接口。两者都能承载网络连接，但连接对象和网络拓扑不同：

接口主要用途连接后的网络关系
C1将电脑、平板或手机等用户设备接入 RM-01用户设备加入 RM-01 内部交换机网络，成为内部网络中的一个节点
C3将 RM-01 接入用户现有的局域网通过 LPMU 为其他内部节点提供路由，使整机接入交换机或路由器所在的上层网络

2. 识别 C1 与 C3

C1 接口

C1 位于机身侧后方。面对上下排列的两个 USB-C 接口时，C1 是靠上的接口；接口下方刻有连接图样，可用于确认位置。

C3 接口

C3 位于机身顶部。掀开上方磁吸盖板后，可以看到该 USB-C 接口。C3 是顶部共享 USB 接口，可在 TianshanOS 中切换至 ESP、AGX 或 LPMU。

3. 通过 C1 将用户设备接入 RM-01

使用支持数据传输的 USB-C 线缆，将 iPad、电脑、手机或其他用户设备连接至 C1。连接后，RM-01 会自动完成 DHCP 地址分配，用户无需手动填写 IP 地址、网关或 DNS。

用户设备通常会识别出一个名为 AX88179 或 USB Ethernet 的有线网络接口。该设备随后会加入 RM-01 内部交换机网络，并可以与内部网络中的设备通信。

4. 保留互联网连接并向 RM-01 共享网络

用户设备的互联网连接可能发生什么

如果用户设备仍需通过 Wi-Fi、以太网或其他连接访问互联网，应确保原有互联网连接的优先级高于 AX88179：

系统系统中的名称设置原则
macOS网络服务顺序（Service Order）将提供互联网的 Wi-Fi 或以太网置于 AX88179 之上
Windows接口跃点数（Interface Metric）数值越小优先级越高；使互联网接口的跃点数小于 AX88179
Linux路由 metric（Route Metric）数值越小优先级越高；使互联网默认路由的 metric 小于 AX88179

使用 RM-01 网络连接工具

如果还需要把用户设备的互联网连接共享给 RM-01，请从网站的“下载”页面获取 RM-01 网络连接工具。该工具会配置用户设备与 C1 之间的 DHCP、路由和网络共享规则，使互联网流量能够从用户设备转发至 RM-01 内部网络。

当前支持：

  • macOS
  • Linux
  • Windows 专业版

Windows 家庭版当前不受支持。

5. 使用 AI 配置 C1 网络共享

具备本机命令执行能力的 Agent Harness（如 Codex、Hermes）可以根据自然语言检查网络拓扑，并帮助配置从用户电脑到 RM-01 内部网络的转发与共享。这里的 AI 必须能够在目标电脑上执行系统命令；普通对话式 AI 只能提供操作建议，不能直接完成配置。

在哪里运行 AI Agent

建议直接在连接 C1 的用户电脑上运行 Agent。因为互联网出口、默认路由和共享规则都由这台电脑管理，Agent 需要获得该电脑的管理员权限才能完成配置。

如果 Codex、Hermes 或其他 Agent 运行在 RM-01 内部，则必须事先获得对用户电脑的远程命令执行权限和管理员授权；否则它无法修改用户电脑上的网络共享、路由与防火墙设置。

执行前确认

  • 用户电脑已经通过 C1 接入 RM-01，并能看到名为 AX88179 或 USB Ethernet 的网络接口。
  • 用户电脑的 C1 地址为 10.10.99.100/24，RM-01 内部节点仍使用 10.10.99.99、10.10.99.98 和 10.10.99.97。
  • 用户电脑已经通过 Wi-Fi、以太网或其他接口正常访问互联网。
  • Agent Harness 可以在用户电脑上执行命令，并可在需要时请求管理员权限。
  • 已保存下载、远程会话及其他依赖网络的工作，并能够在本机恢复网络配置。

可直接发送给 Agent 的提示词

下面的提示词保留了 RM-01 的出厂网络拓扑，同时要求 Agent 先检查、再修改，并给出验证与回滚方法。可以直接复制到 Codex、Hermes 或其他具备命令执行能力的 Agent Harness：

你正在帮助我为 RM-01 配置 C1 网络共享。请先检查当前系统、网络接口、地址、默认路由和防火墙状态，确认实际情况与下述拓扑一致后再执行修改；不要仅凭接口名称猜测，也不要改动 RM-01 内部节点的固定地址。

当前拓扑如下：
- 用户电脑通过 USB-C 连接 RM-01 的 C1 接口；该连接在用户电脑上通常显示为 AX88179 或 USB Ethernet，地址为 10.10.99.100/24。
- RM-01 内部网络为 10.10.99.0/24。
- 应用计算机（LPMU）地址为 10.10.99.99。
- 推理计算机（AGX）地址为 10.10.99.98。
- 带外管理计算机地址为 10.10.99.97。
- 用户电脑还通过另一个网络接口连接互联网。

我的目标是：保留用户电脑现有的互联网连接，并把该连接通过 C1 对应的 AX88179 / USB Ethernet 接口共享给 RM-01 内部网络，使 10.10.99.99、10.10.99.98 和 10.10.99.97 能够访问互联网。

请按以下约束操作：
1. 先识别操作系统、实际互联网出口接口和 C1 对应接口，并向我说明准备修改的项目。
2. 使用当前操作系统原生且改动最小的网络共享方式，配置必要的 IP 转发、NAT、路由或 Internet Connection Sharing。
3. 不要改变用户电脑现有互联网接口的优先级和默认路由，不要改动上述 RM-01 节点地址，也不要清空或覆盖无关的防火墙规则。
4. 如需管理员权限，请明确说明用途后再请求；如果当前系统或权限无法安全完成配置，请停止并说明原因。
5. 完成后验证：用户电脑仍可访问互联网；10.10.99.99、10.10.99.98、10.10.99.97 可达；RM-01 内部节点可以访问公网 IP，并能正常解析域名。
6. 最后列出实际执行的命令或修改项、验证结果，以及恢复原配置的回滚步骤。

macOS 通常使用“互联网共享”及系统路由机制；Linux 通常使用 IP 转发与 nftables 或 iptables；Windows 专业版通常使用 Internet Connection Sharing（ICS）。具体命令和接口名称应以 Agent 在当前电脑上的检查结果为准。Windows 家庭版当前不受支持。

如何判断配置成功

配置完成后，应同时满足以下条件：

  1. 用户电脑原有的互联网连接保持可用。
  2. 用户电脑可以访问 10.10.99.99、10.10.99.98 和 10.10.99.97。
  3. RM-01 内部节点既能访问公网 IP，也能解析并访问域名。
  4. Agent 已给出实际修改项和可执行的回滚步骤，而不是只报告“配置成功”。

安全提示

6. 通过 C3 将 RM-01 接入上层网络

这里的“上层网络”是指用户已有的局域网，例如交换机或路由器所在的网络。

准备连接器

用户需自备以下连接设备：

  • 一个 USB-C ↔ RJ45 以太网适配器
  • 一根连接交换机或路由器的 RJ45 网线

将 USB-C 端连接至 C3，再将 RJ45 网线连接至用户的交换机或路由器。仅完成物理连接还不足以完成 DHCP 和路由配置，后续必须运行 RM-01 内置的网络配置程序。

将顶部 USB 切换至 LPMU

  1. 打开 TianshanOS 首页。
  2. 找到“USB 切换”区域。
  3. 点击“USB”按钮，将顶部 USB 接口的当前目标切换至 LPMU。
  4. 确认页面显示的当前目标为 LPMU 后，再继续网络配置。

7. 通过 LPMU 完成整机联网

RM-01 出厂时已在 LPMU 中预制网络自动化配置项目。LPMU 取得上层网络连接后，会通过内部路由与 NAT 为 AGX 等内部节点转发流量，使整机接入用户的上层网络。

项目位置和用户需要做什么

项目位于 LPMU 当前用户的主目录，预制路径为 ~/network-setup/，其中面向 LPMU 的脚本位于 ~/network-setup/lpmu/。

出厂设备不需要重新下载项目，也不需要重复执行 README 中面向工程部署的 scp、chmod 或安装步骤。普通用户应从 TianshanOS 运行配置；只有在故障诊断或二次开发时，才需要进入项目目录检查脚本与日志。

自动化项目会完成什么

执行配置后，项目会在 LPMU 上依次完成以下工作：

  1. 检测具有网关的网络接口，并通过连通性测试选择可用的上层网络出口。
  2. 重新设置 LPMU 的默认路由，使流量通过选定的上层网络接口发送。
  3. 启用 IPv4 转发，并配置 iptables 的 NAT 与 FORWARD 规则。
  4. 使内部 AGX（默认地址 10.10.99.98）通过 LPMU（内部地址 10.10.99.99）访问上层网络。
  5. 配置用于访问 AGX 的端口转发规则。

项目还包含可选的智能路由监控服务。启用后，服务每 30 秒检查一次当前网络出口，在连接失效时尝试切换至其他可用接口，并在首选接口恢复后切换回来。

通过 TianshanOS 运行

  1. 确认 C3 已通过 USB-C ↔ RJ45 以太网适配器连接至交换机或路由器。
  2. 确认 TianshanOS 首页中的顶部 USB 目标已经切换至 LPMU。
  3. 在 TianshanOS 顶部导航中打开“网络”。
  4. 找到“接入上层网络”。
  5. 点击“通过LPMU接入”。
  6. 等待状态从“处理中”变为“成功”或“失败”。处理期间不要重复启动。

状态显示“成功”表示脚本已找到可用的上层网络出口、完成 LPMU 路由配置，并执行内部网络转发与 NAT 配置。此时仍建议验证 AGX 的 IP 连通性和 DNS 解析，而不是仅以按钮状态作为最终判断。

如何确认联网成功

首先确认 TianshanOS 显示“成功”。如果用户拥有 AGX 终端权限，可在 AGX 中依次执行：

ping -c 3 10.10.99.99  # 验证 AGX 到 LPMU
ping -c 3 8.8.8.8       # 验证互联网 IP 连通性
ping -c 3 google.com    # 验证 DNS 解析

三项测试分别验证内部链路、互联网转发和 DNS。第一项失败通常表示内部连接或地址配置异常；第一项成功而第二项失败，应检查 LPMU 的上层网络、默认路由和 NAT；前两项成功而第三项失败，则应检查 DNS 配置。

端口转发与安全边界

当前项目会在 LPMU 的上层网络接口配置以下转发：

LPMU 入口转发目标用途
TCP 58022AGX TCP 22通过 LPMU 访问 AGX 的 SSH 服务
TCP/UDP 58000–58999AGX 相同端口访问运行在 AGX 上的应用服务

例如，SSH 客户端连接的是 LPMU 的上层网络地址，但用户名和认证凭据属于 AGX：

ssh -p 58022 <AGX_USERNAME>@<LPMU_IP>

风险与故障排查

如果接入失败，请依次检查：

  1. C3 使用的 USB-C ↔ RJ45 适配器和网线是否连接牢固。
  2. 交换机或路由器端口是否已经启用。
  3. TianshanOS 首页显示的顶部 USB 目标是否为 LPMU。
  4. 上层网络是否能向 LPMU 提供有效地址、网关和 DNS。
  5. “接入上层网络”区域显示的错误和输出信息。
  6. AGX 是否仍可访问 LPMU 内部地址 10.10.99.99。
  7. LPMU 中是否存在与默认路由、NAT、FORWARD 链或端口转发冲突的自定义规则。
在 查看网络自动化项目
下一步 继续阅读 Admin 指南