跳至主要內容

Syncthing：你的私人同步盘

约 903 字大约 3 分钟...

Syncthing 是一款开源、免费的跨平台文件同步工具，基于 P2P 技术，可实现多设备之间的实时文件同步，支持 Windows、macOS、Linux、Android 等主流平台。

部署代码

推荐使用 Docker Compose 部署。完整步骤见 Docker Compose 部署教程，下面给出可直接使用的示例：

# https://github.com/linuxserver/docker-syncthing
services:
  syncthing:
    image: lscr.io/linuxserver/syncthing:latest
    container_name: syncthing
    hostname: syncthing
    environment:
      - PUID=1026
      - PGID=100
      - TZ=Asia/Shanghai
    volumes:
      - /volume1/docker/syncthing/config:/config
      #- /path/to/data1:/data1 # 同步路径映射
    network_mode: host # 避免本地同步速率变慢
    restart: unless-stopped

部署完成后，在浏览器访问 http://<你的服务器IP或域名>:8384 进入 Web 管理界面。点击右上角「操作」>「显示 ID」，复制本机 ID 到其他设备即可发起连接。

使用说明

添加设备与共享文件夹

  1. 在任一设备的 Web 管理界面添加远程设备，并选择要共享的文件夹。
  2. 在另一台设备接受连接请求。建议不要启用「自动接收」，以免系统自动设置不合适的本地路径。
  3. 连接建立后，双方分别确认要同步的文件夹。

同步类型配置

单向同步

  • 「仅发送（Send Only）」：该设备作为源头，只向外发送变更。
  • 「仅接收（Receive Only）」：该设备只接收变更，不向外回传。

删除操作也遵循单向规则，不会双向互删：

  • Send Only：源设备删除，目标设备会同步删除。
  • Receive Only：本设备只接收对方删除；你在本设备删除，不会让对方删除。

以上行为成立的前提是文件夹权限和同步设置正确。另在 Send Only 模式下，目标设备的本地修改不会回传到源设备。

文件版本控制

不需要保留历史版本时，可将版本控制设为「无」。如果担心误删或需要追溯修改，建议开启「简单版本控制」或其他版本策略。

客户端推荐

Syncthing 提供多平台客户端，可在 官网 下载。常见选择如下：

  • Android：建议使用社区维护的 Syncthing-Fork，功能更完整，也可通过 Google Play 安装。
  • Windows：运行时可能弹出命令行窗口，体验一般。

常见问题

报错：文件系统监视器错误

如果出现「文件系统监视器错误」，可在 NAS 终端执行 echo "fs.inotify.max_user_watches=204800" | sudo tee -a /etc/sysctl.conf 提高 inotify 限制。更多方案见 How do I increase the inotify limit to get my filesystem watcher to work?。

报错：folder marker missing

该错误表示未找到 Syncthing 用于标识同步目录的 .stfolder。常见原因是目录权限不足，或目录尚未正确初始化。

解决方法：

  • 确认 Syncthing 对该目录有写入权限；
  • 手动在目标目录中创建 .stfolder 文件夹，并重新扫描。

总结

Syncthing 不依赖第三方服务器，适用于各种场景，尤其适合对隐私和可控性要求较高的用户：

  • 多设备间的实时文档同步；
  • 手机照片自动备份到家庭 NAS；
  • 团队内部在局域网或 VPN 下进行文件共享协作；
  • 技术爱好者构建个人云盘替代方案。
最近更新: