
syncthing/relaysrvSyncthing是一个连续文件同步程序,用于在两台或多台计算机之间同步文件。该Docker镜像提供了Syncthing中继服务器的容器化部署方式,旨在通过安全、可靠的方式实现跨设备文件同步,核心目标是保护用户数据安全、简化操作流程并支持多平台运行。
Syncthing的核心功能围绕以下目标设计(按重要性排序):
防止数据丢失
保护用户数据是首要目标,通过多重机制避免用户文件损坏。
抵御*者**
确保用户数据不被未授权方窃听或篡改,采用加密传输和访问控制。
易于使用
设计注重可访问性和包容性,降低用户操作门槛。
自动化
最小化用户交互,仅在必要时需要手动干预。
普遍可用
支持主流操作系统(Windows、Mac、Linux等),兼容不同硬件环境。
面向个人用户
聚焦个人用户需求,提供安全、易用的文件同步能力。
其他优化
在不违背上述目标的前提下,优化性能、兼容性等其他特性。
bashdocker 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
yamlversion: '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
/var/syncthing:Syncthing的数据根目录,包含配置文件(config.xml)、同步文件夹及日志。建议挂载本地目录以持久化数据。| 端口 | 用途 | 协议 |
|---|---|---|
| 8384 | Web管理界面 | TCP |
| 22000 | 设备间同步通信 | TCP/UDP |
| 21027 | 本地网络设备发现 | UDP |
| 变量名 | 说明 | 默认值 |
|---|---|---|
PUID | 运行Syncthing的用户ID(避免权限问题) | 0 |
PGID | 运行Syncthing的用户组ID | 0 |
TZ | 时区设置(如Asia/Shanghai) | UTC |
STNOUPGRADE | 设置为1禁用自动升级 | 未设置 |
STTRACE | 启用调试日志(如all或特定模块) | 未设置 |






manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务