# Syncthing

原生 Mac 菜单栏封装应用，附带 Syncthing 进程，可在已授权设备间加密同步文件。

> 这是 OpenNavo 上 Syncthing 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/syncthing-app>

- **最新版本**: `2.1.6-1`
- **开发者**: Syncthing community
- **主页**: <https://syncthing.net/>
- **分类**: [文件与存储](https://opennavo.com/zh/categories/files-storage)
- **安装**: `brew install --cask syncthing-app`
- **近 30 天安装**: 1,608
- **Homebrew**: 可以安装，应用会自行更新
- **曾用 token**: syncthing
- **下载地址**: <https://github.com/syncthing/syncthing-macos/releases/download/v2.1.6-1/Syncthing-2.1.6-1.dmg>
- **SHA-256**: `f81d091bb19c42b3bb7a2fda9e80f1794cdb27fadb18b094b0c99b53ef571e2d`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.github.xor-gate.syncthing-macosx"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Syncthing.app"
      ],
      "target": "/Applications/Syncthing.app"
    },
    "phase": "install",
    "sources": [
      "Syncthing.app"
    ],
    "target": "/Applications/Syncthing.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/Syncthing-macOS",
            "~/Library/Caches/com.github.xor-gate.syncthing-macosx",
            "~/Library/Cookies/com.github.xor-gate.syncthing-macosx.binarycookies",
            "~/Library/Preferences/com.github.xor-gate.syncthing-macosx.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Syncthing for macOS 是用于 Syncthing 文件同步的官方原生 Mac 菜单栏应用程序包。此 syncthing-app Cask 会安装 Syncthing.app，并附带独立捆绑的同步进程。它不同于 syncthing 命令行版 Formula，也不同于核心程序基于浏览器的 Web GUI。

### Mac 控制与同步
菜单栏封装应用会显示同步状态、在 Finder 中打开共享文件夹、暂停设备，并在首选浏览器中打开 Syncthing Web GUI。它可以选择在登录时启动，无需另行配置服务。捆绑的本地实例会自动配置。封装应用使用 Sparkle 更新应用，并停用核心程序自己的独立更新器，使捆绑组件由同一更新机制管理。

使用 Web GUI 添加设备、选择文件夹并查看同步状态。Syncthing 可在已授权设备之间交换文件，无需中央云存储账户。随着对等设备变为可连接状态，它会同步文件的创建、编辑和删除。文件夹模式、忽略规则、版本控制和带宽设置可用于调整工作流程。设备必须有重叠的在线时段，可直接连接或通过中继连接；公共基础设施并不是一个云邮箱，不会一直存储所有文件，直到每台设备重新上线。

### 同步与备份
Syncthing 不是独立的备份系统。删除或损坏同步文件可能会传播到其他设备，已获授权设备遭入侵也可能影响共享数据。请保留单独且可恢复的备份。可选的文件版本控制会根据其配置保留选定的已替换或删除版本，但不能替代离线备份或受到独立保护的备份。

并发编辑可能产生冲突文件，需要进行检查。文件系统和平台差异会影响权限、符号链接和元数据；通常不会保留资源分支和 Windows ACL。不要假设同步的 Mac 目录就是完整的系统备份。

### 安装与兼容性
安装 syncthing-app Homebrew Cask，或挂载官方 DMG 并将 Syncthing.app 拖入“应用程序”。Syncthing v2 的 Mac 应用包要求 macOS 12 Monterey 或更高版本；旧版安装段落中要求 macOS 11 的说法，已被项目的 v2 公告及兼容性章节取代。该应用包包含适用于 Intel 和 Apple Silicon 的 Syncthing 通用二进制文件。其他操作系统应使用相应的核心版本或集成方案，而非此 Mac 应用包。

官方 Syncthing-2.1.6-1.dmg 通过 HTTP HEAD 和已发布的发行资源大小测得为 28,069,114 字节。应用文件、索引、保留的版本和同步数据还需要额外空间。未声明需要单独的提供程序、运行时或额外的 Cask 依赖项。避免在相同配置或端口上运行另一个本地 Syncthing 实例或封装应用；项目明确警告，多个实例相互竞争会导致此封装应用无法正常工作。

启动应用并配置本地设备和文件夹，然后仅在需要时启用“登录时启动”。同步需要进程持续运行且文件夹可访问；处于睡眠、离线或注销状态的计算机可能无法交换更新。必要时，授予 macOS 访问所选文件夹或外部宗卷的权限。访问受保护的位置可能需要“完全磁盘访问权限”，但若只是同步普通且可访问的文件夹，则不应仅为此授予该权限。防火墙和本地网络设置可能影响发现与连接。

### 设备授权与隐私
两台设备都必须识别对方的设备 ID，并且每个共享文件夹都必须获准共享给指定设备。TLS 可保护设备间传输。设备 ID 不是密码，但全局发现可能将其与外部 IP 地址关联起来。请保护设备私钥和配置：持有这些信息的人可能冒充该设备。设备丢失后，请从其他对等设备中撤销其授权。

本地发现会在本地网络上广播或多播设备 ID 和监听端口。全局发现会向发现服务器发送设备地址信息。直接连接失败时，中继可转发流量；文件内容仍采用端到端加密，但中继运营方能够看到 IP 和设备标识符以及流量大小。这些机制可以停用或配置，但可能会影响连接能力。这并不意味着所有网络元数据都不可见。

Web GUI 默认仅监听 localhost。若要远程公开管理界面，请使用文档说明的身份验证和 HTTPS 保护措施，不要把设备 ID 当作 GUI 授权凭据。使用情况报告为可选功能，并提供所报告字段的预览。

### 账户、费用与许可证
Mac 封装应用和核心程序均可免费使用，无强制订阅或中央账户。公共基础设施和下载不出售供你自己的同步文件夹使用的存储配额。第三方设备、托管、连接服务或商业集成可能产生各自的费用。

syncthing-macos 封装应用采用 MIT 许可，而捆绑的 Syncthing 核心程序采用 MPL 2.0 许可。重新分发或修改应用时，应区分这些组件的许可证。Syncthing v1 的 Mac 应用包已弃用，不再接收更新；v2 应用包是受支持的版本系列。

官方来源：[Mac 封装应用](https://github.com/syncthing/syncthing-macos)、[核心文档与常见问题](https://docs.syncthing.net/users/faq.html)、[安全](https://docs.syncthing.net/users/security.html)、[中继](https://docs.syncthing.net/users/relaying.html)、[封装应用 MIT 许可证](https://github.com/syncthing/syncthing-macos/blob/v2/LICENSE)、[核心程序 MPL 许可证](https://github.com/syncthing/syncthing/blob/v2.1.6/LICENSE)。

## 系统要求

- macOS 12 起 · 应用版本: 2.1.6-1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 核查于 2026-11-22
  - <https://github.com/syncthing/syncthing-macos/releases/download/v2.1.6-1/Syncthing-2.1.6-1.dmg>
  - SHA-256: `f81d091bb19c42b3bb7a2fda9e80f1794cdb27fadb18b094b0c99b53ef571e2d`
- macOS 12 起 · 应用版本: 2.1.6-1 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 核查于 2026-11-22
  - <https://github.com/syncthing/syncthing-macos/releases/download/v2.1.6-1/Syncthing-2.1.6-1.dmg>
  - SHA-256: `f81d091bb19c42b3bb7a2fda9e80f1794cdb27fadb18b094b0c99b53ef571e2d`

## Syncthing 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/syncthing/syncthing-macos> · 是否开源: 是 — <https://github.com/syncthing/syncthing-macos> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask syncthing-app`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask syncthing-app`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/Syncthing-macOS` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/com.github.xor-gate.syncthing-macosx` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Cookies/com.github.xor-gate.syncthing-macosx.binarycookies` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.github.xor-gate.syncthing-macosx.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 2.1.6-1 (2026-10-07)

将捆绑核心更新至 Syncthing 2.1.6，修复设备、临时文件和 Web GUI 问题。

**捆绑**

- 捆绑 Syncthing 核心 2.1.6。

**核心修复**

- 阻止介绍者将自己添加到文件夹。
- 无法创建临时文件时报告错误。
- 为 Edit Device 对话框添加无障碍标签。
- 提高标题和按钮的颜色对比度。
- 移除索引传输中的不必要延迟。
- 修复 watcher aggregator 中的浮点时长转换。

## 资料与来源

- <https://opennavo.com/zh/apps/syncthing-app>
- <https://opennavo.com/zh/apps/syncthing-app/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/syncthing-app.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/syncthing-app>
- <https://github.com/syncthing/syncthing-macos> · 核查于 2026-11-13
