工业远程同步调试踩坑实录
- 内容介绍
- 文章标签
- 相关推荐
工业级远程调试方案：基于 Tailscale + Mutagen 的跨网段代码同步实践
最近接到了新项目，需要对一个工业小车的HMI进行开发，顺手碎碎念记录一下本菜鸡最近遇到的一些坑以及解决办法 。
沟槽的小车只能放在测试场地 ，而我的开发电脑在办公室。没有配单独的笔记本，只有共享笔记本使用。我不想在共享笔记本上重新配一整套环境，而且我的开发电脑还是台式机，所以我决定摸索一下怎么远程调试。这时候发现小车不在公司内外网，超脱于三界之外（不是），所以借助哈基米之力开始摸索方案，然后哈基米推荐我用Tailscale去组虚拟组网。
稍微查了一下资料，贴在下面。
Tailscale 是什么？
GitHub - tailscale/tailscale: The easiest, most secure way to use WireGuard and...
The easiest, most secure way to use WireGuard and 2FA.
Tailscale 是一种基于 WireGuard® 协议的虚拟组网工具。它通过 P2P（点对点）网格网络（Mesh Network），将分散在不同物理地点、不同网络环境中的设备，连接成一个虚拟的局域网。
它的核心原理是什么？
-
NAT 穿透（NAT Traversal）：它能自动“打洞”，让处于深层内网（没有公网 IP、跨多层防火墙）的设备直接建立加密连接；如果打洞失败，会回退到 DERP 中继转发（延迟会比直连高一些）。
-
零配置控制平面：它在后台处理所有的密钥交换和路由表更新，用户只需要像登录普通 App 一样登录账号，设备就会自动分配到一个固定的私有 IP（100.x.x.x）。
它能做什么？
-
异地组网（SD-WAN）：让你的办公电脑（北京）和现场工控机（上海）像连在同一个 Wi-Fi 下一样，实现无缝通讯。
-
固定身份标识：为每一台设备分配一个相对稳定的内部 IP。日常网络切换（比如 5G/Wi-Fi）通常不会变，但在设备重装或身份重置后可能变化。
-
安全隧道：所有流量在离开设备前都会进行端到端加密。即便在不安全的公共网络环境下调试工业设备，数据也不会泄露。
-
智能路由：它会自动选择最优的传输路径。如果两台机器在同一个内网，它会走局域网速度；如果在异地，它会建立加密隧道直连。
踩坑点1：Tailscale登陆不上
有一台设备的Tailscale死活登陆不上，服务始终处于 Starting，我搁那儿翻红迪，鬼佬说用旧版本，卸载缓存重装，反正杂七杂八折腾了半天没用 。后来哈基米让我去看是不是虚拟机网卡占用导致的登录死锁问题，我先看了状态和连通性，表现是服务卡着不前、100.x 地址也不通；然后我手动把VM虚拟机的虚拟网卡全禁了，服务就起来了，ping也恢复，基本就能确认是网卡冲突。
踩坑点2：Tailscale多网卡环境下掉线
开发机器使用的是公司外网wifi访问互联网，然后公司代码库在内网。当我把内网网线一插Tailscale秒掉线。排查了一下发现是因为windows默认用有线网卡，而内网没法上网Tailscale直接就掉了。手动把无线网卡和有线网卡的自动跃点取消，然后把访问互联网的wifi越点调小提高优先级，此时就不会掉线了。
下一步是用ssh远程去连，这一步的坑都是老生常谈了，我就略过不讲了，反正完事之后我开始跑前端，端口转发8080也没问题，前端页面也是正常载入。然后尝试去连小车，发现怎么都连不上，我远程到工控机上连又是正常的。然后发现自己端口转发没配，吭哧吭哧折腾一阵子总算搞定开始远程开发了。但是我习惯在自己本地窗口work，而且天才程序员codex好像不是太方便直接修改ssh远程窗的代码（主要原因 ），所以每次都是在本地窗vibe完然后改改，感觉没问题手动拷到远程再跑，劳累了啊。
于是又开始折腾，依旧求助哈基米。哈基米让我弄Mutagen来同步，于是照着开始搞。
Mutagen 是什么？
GitHub - mutagen-io/mutagen: Fast file synchronization and network forwarding...
Fast file synchronization and network forwarding for remote development
Mutagen 是一个高性能、低延迟的实时文件同步工具。它在两端运行轻量级 Agent，通过维护文件快照，实现秒级的增量同步。
它能做什么？
-
实时镜像：本地保存，远程立刻更新，支持热重载（Hot Reload）。
-
多端解耦：允许本地保持 Windows 环境开发，远程在嵌入式 Linux 或工控机 Windows 上运行。
踩坑点3
按照哈基米的教程执行mutagen sync create指令后，发现状态始终卡在Connecting。排查了一下原因发现是ssh没免密登录导致的，Mutagen 是非交互式运行的没法手动输密码直接无限卡住了。然后配密匙佬友们都熟就带过了。
踩坑点4
配完密匙之后开始执行同步，发现失败并返回报错remote did not return UTF-8 output,哈基米说是因为Mutagen 内部强制使用 UTF-8 编码进行通信，然而cmd默认用的是GBK格式导致没法解析，把区域设置中的’Beta: 使用 Unicode UTF-8 提供全球语言支持’勾上之后重启解决了。这里补一句，这个选项是系统级开关，可能会影响部分老软件的编码行为，所以如果勾选后出现兼容性问题就撤回这个选项，别的方法我没去试反正it works。
踩坑点5
同步上了,好激动啊,然后又踩坑了 。哈基米给我推荐用--mode=two-way-resolved（双向同步模式）,并且ignore了node_modules,然后一同步直接给工控机上的node_modules目录直接杀干净了。这个坑的本质是双向模式会尝试把两端状态“收敛”到同一份快照，一旦ignore规则没按预期生效，远端目录就可能被当成差异直接处理掉。然后我pnpminstall重装的时候，Mutagen后台仍在尝试扫描并同步，导致直接报错 UNKNOWN error，整个 node_modules 都寄了。没办法，只能重装，然后再把模式改成--mode=one-way-safe单向同步。
终于可以实现本地改动一保存直接同步工控机调试了，前前后后折腾了快两天，突然就索然无味了。碎碎念了不少，第一次写技术分享型的文章，希望对佬友们有点帮助 。
网友解答：--【壹】--：
只能说哈基米还是太好用了
--【贰】--：
嚯，好多干货，佬解决问题的能力有点强呀
--【叁】--：
新补一个坑，区域设置中的’Beta: 使用 Unicode UTF-8 提供全球语言支持’勾上之后会导致.bat批处理娱乐中文全部乱码
工业级远程调试方案：基于 Tailscale + Mutagen 的跨网段代码同步实践
最近接到了新项目，需要对一个工业小车的HMI进行开发，顺手碎碎念记录一下本菜鸡最近遇到的一些坑以及解决办法 。
沟槽的小车只能放在测试场地 ，而我的开发电脑在办公室。没有配单独的笔记本，只有共享笔记本使用。我不想在共享笔记本上重新配一整套环境，而且我的开发电脑还是台式机，所以我决定摸索一下怎么远程调试。这时候发现小车不在公司内外网，超脱于三界之外（不是），所以借助哈基米之力开始摸索方案，然后哈基米推荐我用Tailscale去组虚拟组网。
稍微查了一下资料，贴在下面。
Tailscale 是什么？
GitHub - tailscale/tailscale: The easiest, most secure way to use WireGuard and...
The easiest, most secure way to use WireGuard and 2FA.
Tailscale 是一种基于 WireGuard® 协议的虚拟组网工具。它通过 P2P（点对点）网格网络（Mesh Network），将分散在不同物理地点、不同网络环境中的设备，连接成一个虚拟的局域网。
它的核心原理是什么？
-
NAT 穿透（NAT Traversal）：它能自动“打洞”，让处于深层内网（没有公网 IP、跨多层防火墙）的设备直接建立加密连接；如果打洞失败，会回退到 DERP 中继转发（延迟会比直连高一些）。
-
零配置控制平面：它在后台处理所有的密钥交换和路由表更新，用户只需要像登录普通 App 一样登录账号，设备就会自动分配到一个固定的私有 IP（100.x.x.x）。
它能做什么？
-
异地组网（SD-WAN）：让你的办公电脑（北京）和现场工控机（上海）像连在同一个 Wi-Fi 下一样，实现无缝通讯。
-
固定身份标识：为每一台设备分配一个相对稳定的内部 IP。日常网络切换（比如 5G/Wi-Fi）通常不会变，但在设备重装或身份重置后可能变化。
-
安全隧道：所有流量在离开设备前都会进行端到端加密。即便在不安全的公共网络环境下调试工业设备，数据也不会泄露。
-
智能路由：它会自动选择最优的传输路径。如果两台机器在同一个内网，它会走局域网速度；如果在异地，它会建立加密隧道直连。
踩坑点1：Tailscale登陆不上
有一台设备的Tailscale死活登陆不上，服务始终处于 Starting，我搁那儿翻红迪，鬼佬说用旧版本，卸载缓存重装，反正杂七杂八折腾了半天没用 。后来哈基米让我去看是不是虚拟机网卡占用导致的登录死锁问题，我先看了状态和连通性，表现是服务卡着不前、100.x 地址也不通；然后我手动把VM虚拟机的虚拟网卡全禁了，服务就起来了，ping也恢复，基本就能确认是网卡冲突。
踩坑点2：Tailscale多网卡环境下掉线
开发机器使用的是公司外网wifi访问互联网，然后公司代码库在内网。当我把内网网线一插Tailscale秒掉线。排查了一下发现是因为windows默认用有线网卡，而内网没法上网Tailscale直接就掉了。手动把无线网卡和有线网卡的自动跃点取消，然后把访问互联网的wifi越点调小提高优先级，此时就不会掉线了。
下一步是用ssh远程去连，这一步的坑都是老生常谈了，我就略过不讲了，反正完事之后我开始跑前端，端口转发8080也没问题，前端页面也是正常载入。然后尝试去连小车，发现怎么都连不上，我远程到工控机上连又是正常的。然后发现自己端口转发没配，吭哧吭哧折腾一阵子总算搞定开始远程开发了。但是我习惯在自己本地窗口work，而且天才程序员codex好像不是太方便直接修改ssh远程窗的代码（主要原因 ），所以每次都是在本地窗vibe完然后改改，感觉没问题手动拷到远程再跑，劳累了啊。
于是又开始折腾，依旧求助哈基米。哈基米让我弄Mutagen来同步，于是照着开始搞。
Mutagen 是什么？
GitHub - mutagen-io/mutagen: Fast file synchronization and network forwarding...
Fast file synchronization and network forwarding for remote development
Mutagen 是一个高性能、低延迟的实时文件同步工具。它在两端运行轻量级 Agent，通过维护文件快照，实现秒级的增量同步。
它能做什么？
-
实时镜像：本地保存，远程立刻更新，支持热重载（Hot Reload）。
-
多端解耦：允许本地保持 Windows 环境开发，远程在嵌入式 Linux 或工控机 Windows 上运行。
踩坑点3
按照哈基米的教程执行mutagen sync create指令后，发现状态始终卡在Connecting。排查了一下原因发现是ssh没免密登录导致的，Mutagen 是非交互式运行的没法手动输密码直接无限卡住了。然后配密匙佬友们都熟就带过了。
踩坑点4
配完密匙之后开始执行同步，发现失败并返回报错remote did not return UTF-8 output,哈基米说是因为Mutagen 内部强制使用 UTF-8 编码进行通信，然而cmd默认用的是GBK格式导致没法解析，把区域设置中的’Beta: 使用 Unicode UTF-8 提供全球语言支持’勾上之后重启解决了。这里补一句，这个选项是系统级开关，可能会影响部分老软件的编码行为，所以如果勾选后出现兼容性问题就撤回这个选项，别的方法我没去试反正it works。
踩坑点5
同步上了,好激动啊,然后又踩坑了 。哈基米给我推荐用--mode=two-way-resolved（双向同步模式）,并且ignore了node_modules,然后一同步直接给工控机上的node_modules目录直接杀干净了。这个坑的本质是双向模式会尝试把两端状态“收敛”到同一份快照，一旦ignore规则没按预期生效，远端目录就可能被当成差异直接处理掉。然后我pnpminstall重装的时候，Mutagen后台仍在尝试扫描并同步，导致直接报错 UNKNOWN error，整个 node_modules 都寄了。没办法，只能重装，然后再把模式改成--mode=one-way-safe单向同步。
终于可以实现本地改动一保存直接同步工控机调试了，前前后后折腾了快两天，突然就索然无味了。碎碎念了不少，第一次写技术分享型的文章，希望对佬友们有点帮助 。
网友解答：--【壹】--：
只能说哈基米还是太好用了
--【贰】--：
嚯，好多干货，佬解决问题的能力有点强呀
--【叁】--：
新补一个坑，区域设置中的’Beta: 使用 Unicode UTF-8 提供全球语言支持’勾上之后会导致.bat批处理娱乐中文全部乱码