Syncthing Docker镜像文档

镜像概述和主要用途

Syncthing是一个连续文件同步程序，用于在两台或多台计算机之间同步文件。该Docker镜像提供了Syncthing中继服务器的容器化部署方式，旨在通过安全、可靠的方式实现跨设备文件同步，核心目标是保护用户数据安全、简化操作流程并支持多平台运行。

核心功能和特性

Syncthing的核心功能围绕以下目标设计（按重要性排序）：

1. 防止数据丢失
   保护用户数据是首要目标，通过多重机制避免用户文件损坏。

2. 抵御攻击者
   确保用户数据不被未授权方窃听或篡改，采用加密传输和访问控制。

3. 易于使用
   设计注重可访问性和包容性，降低用户操作门槛。

4. 自动化
   最小化用户交互，仅在必要时需要手动干预。

5. 普遍可用
   支持主流操作系统（Windows、Mac、Linux等），兼容不同硬件环境。

6. 面向个人用户
   聚焦个人用户需求，提供安全、易用的文件同步能力。

7. 其他优化
   在不违背上述目标的前提下，优化性能、兼容性等其他特性。

使用场景和适用范围

适用场景

• 个人文件跨设备同步：如电脑、笔记本、移动设备间的文档、照片等文件实时同步。
• 家庭/小型团队数据共享：在信任的设备间共享文件夹，无需依赖第三方云服务。
• 跨平台文件协作：Windows、Mac、Linux设备间无缝同步，支持不同系统文件格式兼容。
• 安全数据备份：通过加密同步实现多设备备份，降低单点故障风险。

适用范围

• 个人用户及小型团队
• 需要本地控制数据隐私的场景
• 跨设备、跨网络环境的文件同步需求

使用方法和配置说明

基本使用流程

1. 拉取Syncthing Docker镜像；
2. 运行容器并配置数据卷、端口映射；
3. 通过Web界面配置同步文件夹和设备连接。

Docker部署方案示例

1. Docker Run命令

docker run -d \
  --name=syncthing \
  --hostname=my-syncthing \  # 可选，自定义主机名
  -p 8384:8384 \             # Web管理界面端口
  -p 22000:22000/tcp \       # 同步协议TCP端口
  -p 22000:22000/udp \       # 同步协议UDP端口
  -p 21027:21027/udp \       # 本地发现端口
  -v /path/to/syncthing/data:/var/syncthing \  # 数据目录（包含配置和同步文件）
  -e PUID=1000 \             # 运行用户ID（避免权限问题）
  -e PGID=1000 \             # 运行用户组ID
  -e TZ=Asia/Shanghai \      # 时区设置
  --restart unless-stopped \ # 自动重启策略
  syncthing/syncthing

2. Docker Compose配置

version: '3'
services:
  syncthing:
    image: syncthing/syncthing
    container_name: syncthing
    hostname: my-syncthing
    ports:
      - "8384:8384"       # Web界面
      - "22000:22000/tcp" # 同步TCP
      - "22000:22000/udp" # 同步UDP
      - "21027:21027/udp" # 本地发现
    volumes:
      - /path/to/local/data:/var/syncthing
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    restart: unless-stopped

配置参数与环境变量

数据卷（Volumes）

• /var/syncthing：Syncthing的数据根目录，包含配置文件（config.xml）、同步文件夹及日志。建议挂载本地目录以持久化数据。

端口映射（Ports）

环境变量（Environment Variables）

相关资源

• 官方文档
• Docker部署详情
• GitHub代码库
• 社区论坛
• 问题跟踪