Mutagen使用技巧

Mutagen 是一个高性能文件同步 + 网络转发工具。和 rsync、scp 不同，它的同步是持久的、双向的、实时的，网络断开会自动重连，不需要人工干预。本文面向开发者和 Docker 用户，覆盖三种传输层的实际使用技巧。整理 By claude

核心概念：两个能力，三种传输

Mutagen 做两件事：

文件同步（mutagen sync）：在两个端点之间实时同步目录，支持双向、单向多种模式，算法基于 rsync 的差异传输，只传变化的部分。

网络转发（mutagen forward）：在两个端点之间建立持久的网络隧道，支持 TCP、Unix socket、Windows Named Pipe。

这两件事都支持三种传输层，可以任意搭配：

两端可以是不同传输层的任意组合——比如左边是本地路径，右边是远程容器。

安装与启动

# macOS
brew install mutagen-io/mutagen/mutagen

# Linux / Windows
# 下载二进制：https://github.com/mutagen-io/mutagen/releases
# aur 使用 pacman -S mutagen.io-bin

# 启动守护进程（后台常驻，重启后自动恢复会话）
mutagen daemon start

一、Local 传输

Local 是最简单的传输层，直接用本地文件路径和网络地址。虽然看起来平淡，但有几个实用场景不容忽视。

URL 格式

同步用本地路径（绝对或相对都行），转发用网络端点：