Syncthing跨平台部署教程安装自启与排障【免费下载链接】syncthingOpen Source Continuous File Synchronization项目地址: https://gitcode.com/GitHub_Trending/sy/syncthing假设你有一台 Windows 办公本、一台 MacBook 和一台 Linux 小服务器想让文档和照片在它们之间自动同步又不想经过任何网盘。Syncthing 是一款开源的持续文件同步工具通过 P2P对等网络让设备之间直接互传文件全程用 TLS传输层安全协议加密。这篇文章我们按任务阶段走一遍安装 → 自启 → 网络打通 → 排障。先看决策表什么系统装什么别追新先选自己系统的原路平台推荐安装方式自启机制Windows官方 ZIP 包sc 服务系统自带macOSHomebrewlaunchd LaunchAgentLinux发行版包管理器systemd 用户服务这张表就是全文主线先解决怎么装再解决怎么开机就跑最后解决网络怎么通。阶段一 · 环境与选型版本、端口、安装方式一次看清版本门槛很低Windows 7 及以上、macOS 10.15 及以上、主流 Linux 发行版都能跑。真正的变量在网络先记牢四个端口端口协议用途22000TCP文件同步BEP块交换协议与中继22000UDPQUIC快速 UDP 互联网连接加速直连21027UDP局域网本地发现让同网段设备互相找到8384TCPWeb 管理界面默认只监听本机安装方式对比每个平台挑一种即可平台方式做法Windows官方 ZIP解压到C:\Program Files\Syncthing双击运行macOSbrewbrew install syncthingmacOS官方 .app拖入应用程序双击运行Linux包管理器apt/dnf安装 syncthingLinux官方二进制包下载 tar 包把可执行文件放进/usr/local/bin阶段二 · 最简落地 每平台一条最短路径目标只有一个浏览器能打开http://localhost:8384。Windows解压后双击syncthing.exe首次运行会直接弹出浏览器窗口完成。macOSbrew install syncthing syncthing serve首次运行会生成一个随机的 Web UI 密码打印在终端里记下来。Linuxsudo apt install syncthing # Debian / Ubuntu syncthing --versionFedora 把apt换成dnf即可。跑起来之后进管理页面做两件事给 GUI 设置固定用户名和密码然后添加对端设备并共享一个文件夹。阶段三 · 开机自启动三平台对照表平台机制文件 / 命令位置验证Windowssc 服务sc create见下sc query SyncthingmacOSlaunchd~/Library/LaunchAgents/syncthing.plistlaunchctl list \| grep syncthingLinuxsystemd 用户服务~/.config/systemd/user/syncthing.servicesystemctl --user status syncthingWindows管理员 PowerShellsc create Syncthing binPath \C:\Program Files\Syncthing\syncthing.exe\ serve --no-browser start auto sc start Syncthingsc create一行同时完成安装 自启服务独立于登录用户配置落在%PROGRAMDATA%\Syncthing。macOS项目里自带现成模板 etc/macos-launchd/syncthing.plist复制到~/Library/LaunchAgents/把USERNAME换成你的 macOS 用户名然后launchctl load ~/Library/LaunchAgents/syncthing.plist这个文件里KeepAlive为 true进程挂了会自动拉起日志会重定向到~/Library/Logs/Syncthing.log。Linux把模板 etc/linux-systemd/user/syncthing.service 原样放到~/.config/systemd/user/systemctl --user daemon-reload systemctl --user enable --now syncthing用户级服务比系统服务更适合 Syncthing配置本来就在用户目录权限天然匹配。多用户服务器则用系统模板 etc/linux-systemd/system/syncthing.servicesudo systemctl start syncthingalice这样按用户实例化。阶段四 · 网络与防火墙四个端口 直连/中继决策树 两台设备怎么连上逻辑就一句话先试直连不行再走中继。中继只是一根透传管道内容依然是端到端加密的不用紧张。在 GUI 的设备详情里能看到当前是直连还是中继——看到中继且速度差说明直连没建起来。防火墙放行Windows管理员 CMD比图形界面更省事netsh advfirewall firewall add rule nameSyncthing dirin actionallow protocolTCP localport22000,8384 netsh advfirewall firewall add rule nameSyncthing-UDP dirin actionallow protocolUDP localport22000,21027Linux UFW项目的 etc/firewall-ufw/syncthing 就是现成的 UFW 应用规则复制到/etc/ufw/applications.d/然后sudo ufw allow syncthing。macOS首次联网时系统会弹窗询问点允许即可。只在局域网内同步的话开 UDP 21027 和 TCP/UDP 22000 就够了8384 不必暴露给外网。阶段五 · 验证与排障速查表 日志位置现象最可能原因排查方法两台设备互找不到21027 未放行或不在同网段看 GUI 里的发现地址手动添加地址:端口连上了但文件不动文件夹没共享给该设备或被忽略规则挡掉GUI 里检查文件夹共享查看.stignore外网打不开管理页8384 默认只监听本机别暴露用隧道ssh -L 8384:localhost:8384 userhost速度慢、延迟高直连不可用走了中继确认 UDP 22000QUIC放行重启后没自启服务没 enablesystemctl --user is-enabled syncthing、sc query Syncthing出现冲突副本两端同时改过同一文件属正常保护需要的话开启版本控制日志位置一览平台默认日志Windows%LOCALAPPDATA%\Syncthing\log\macOS~/.local/state/syncthing/log/launchd 可重定向到~/Library/Logs/Linux~/.local/state/syncthing/log/用户服务可看journalctl --user-unit syncthing -f一个实战习惯先看 GUI 设备详情里的发现地址和连接类型再回头读日志——八成不同步问题在这一步就有答案。完成度自查清单逐项打勾全部完成即部署到位管理页可访问且设置了固定用户名密码已添加对端设备并双向共享了文件夹测试文件在两端都出现了自启已启用重启一次机器验证过防火墙已放行 22000TCP/UDP与 21027UDP知道日志在哪并跑通一次tail -f打通之后以后加新设备只是复制设备 ID → 添加 → 共享文件夹的重复动作部署的难点都在这六项里了。【免费下载链接】syncthingOpen Source Continuous File Synchronization项目地址: https://gitcode.com/GitHub_Trending/sy/syncthing创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
