必须完成客户端安装、web界面开放、设备id交换、双向信任建立和文件夹共享五步:下载dmg安装至applications,改监听地址为0.0.0.0:8384并设登录密码,获取mac设备id后在对方设备添加并填入mac局域网ip+端口,mac端接受请求,创建文件夹并勾选目标设备,对方接受共享后即双向同步。

要在Mac上设置Syncthing实现两台设备间无需云服务器的点对点文件同步,必须完成客户端安装、Web界面开放、设备ID交换、双向信任建立和文件夹共享这五个不可跳过的环节。只装软件不改监听地址,另一台设备根本发现不了你;只添加设备不接受共享请求,同步永远不会启动;任何一步遗漏或顺序错乱,都会导致界面显示“等待连接”却始终无响应。
安装并首次启动Syncthing
打开浏览器访问 https://syncthing.net/downloads/,下载 macOS 版本(.dmg 文件)。双击挂载镜像,将 Syncthing 图标拖入 Applications 文件夹。首次运行时若弹出“已损坏,无法打开”,需前往「系统设置」→「隐私与安全性」→ 滚动到底部点击「仍要打开」。
启动后,终端自动输出 GUI is available at http://127.0.0.1:8384,此时 Safari 或 Chrome 打开该地址即可进入管理界面。
开放远程访问并设置登录保护
点击右上角齿轮图标 → 切换到「GUI」选项卡。
将 【Listen address】 从默认的 127.0.0.1:8384 改为 0.0.0.0:8384 —— 这步不做,Windows 或 iPhone 就无法通过局域网 IP 访问你的 Mac 管理页。
勾选 【Authentication】,设置用户名和强密码(如包含大小写字母+数字的8位组合),点击 Save。重启 Syncthing 生效(可在菜单栏图标右键选择 Quit,再重新启动)。
获取本机Device ID并添加远程设备
刷新 Web 界面,在左上角找到形如 ABCDEF-GHIJKL-MNOPQR-STUVWX-YZ1234-567890-ABCDE1-FGHIJ2 的长字符串,这就是你的 Mac 设备唯一身份标识。
在另一台设备(如 Windows PC 或 iPhone)的 Syncthing 界面中,点击「操作」→「添加新设备」,粘贴此 ID,填写设备名称(例如“MacBook-Pro”),并在「地址」栏手动填入 Mac 的局域网 IP 加端口:tcp://192.168.1.20:22000(用 ifconfig | grep "inet " 命令查真实 IP)。
回到 Mac 界面,稍等几秒会出现「新设备请求添加」提示框,点击「接受」——【必须手动点击接受,否则信任链断裂,后续所有同步均失败】。
创建同步文件夹并指定目标设备
第一步:点击「添加文件夹」→ 填写「文件夹标签」(如“Design Assets”)→ 设置「本地路径」(推荐选 ~/Documents/Sync/,避免权限问题)。
第二步:在「共享到」列表中勾选已信任的远程设备(如“Windows-Desktop”)→ 下方「文件夹类型」保持默认「Send & Receive」(双向同步)。
第三步:点击保存后,远程设备会立刻收到「A 设备请求共享文件夹」通知 → 在对方界面点击「接受」,同步即刻开始扫描。
第四步:验证是否生效——在 Mac 的同步目录中新建一个 test.txt,10 秒内检查远程设备对应路径是否出现同名文件。若未出现,立即检查防火墙是否放行 TCP 22000 端口。











