部署步骤
1. 安装启动
1.1 下载安装包
https://syncthing.net/downloads/
1.2 临时启动
tar -zxvf syncthing-linux-amd64-v2.0.14.tar.gz cd syncthing-linux-amd64-v2.0.14./syncthing --no-browser --gui-address=0.0.0.0:8384 &
--no-browser：不自动开浏览器
--gui-address=0.0.0.0:8384：允许外网访问 Web 界面（生产后续一定加密码/公网加白）
1.3 浏览器访问
http://IP:8384
1.4 关闭报告发送
2.基础配置（必做）
2.1 设置 GUI 密码（安全）
- 右上角操作 → 设置 → GUI
- 勾选启用 GUI 认证
- 填用户名 + 密码 → 保存
- 刷新页面，用新账号登录
2.2关闭公网功能,设置内网交互
- 右上角操作 → 设置 → 连接
- 只勾选【本地发现】
3.两台设备互相添加（双向核心）
3.1 获取设备 ID（两台都做）
- 右上角操作 → 显示 ID
- 复制一长串 ID（如ABC123-...）
3.2 添加远程设备（A 加 B，B 加 A）
以 A 加 B 为例：
- 右下角添加远程设备
- 设备 ID：粘贴B 的ID
- 设备名称：填 B（自定义，可填主机名）
- 共享：先不勾选，后面再配
- 高级：地址填写tcp://B_ip:22000（通过该地址内网交互同步）
- 保存 → B 端会收到新设备请求
- B 端：点击添加设备 → 高级: 地址填写tcp://A_ip:22000
- 等待几秒 → 状态变为已连接
4.添加多目录双向同步（重点）
4.1 在A上添加同步目录
- 主页添加文件夹
- 文件夹标签：自定义（如 docs、data、backup）
- 文件夹路径：本地目录（如/data/docs/）
- 共享：勾选ServerB（要同步的设备）
- 高级：文件夹类型：发送与接收（双向）
- 忽略模式：添加.git/、*.tmp等（可选）
- 保存 → B 端收到文件夹共享请求
4.2 B 端接受并指定路径
- B 端弹出请求 → 接受
- 输入 B 上的本地路径（如/data/remote_docs/）
- 保存 → 立即开始双向同步
4.3 多目录重复上面步骤
- 每个目录独立配置，路径可不同
- 都选发送与接收就是双向
5.配置开机自启
5.1 创建systemd 服务
mv syncthing-linux-amd64-v2.0.14/syncthing /usr/bin/#也可以使用syncthing-linux-amd64-v2.0.14/etc/linux-systemd/system/syncthing@.service模版 vi /etc/systemd/system/syncthing.service
[Unit] Description=Syncthing - Open Source Continuous File Synchronization After=network.target[Service] User=root Group=root ExecStart=/usr/bin/syncthing --no-browser --gui-address=0.0.0.0:8384 Restart=on-failure RestartSec=5[Install] WantedBy=multi-user.target
5.2 重启服务
systemctl daemon-reload systemctl enable --now syncthing kill掉原有进程systemctl start syncthing systemctl status syncthing # 查看状态
常用设置与排错
数据/配置文件位置
当前使用v2版本，配置文件路径在$HOME/.local/state/syncthing v1版本配置文件路径在$HOME/.config/syncthing
数据同步默认机制
① 文件系统监听（实时，推荐）
- 基于 inotify（Linux）
- 文件一变化立即触发
- 几乎实时（测试约10秒内）
时间由~/.local/state/syncthing/config.xml中fsWatcherDelayS决定
② 定时全量扫描（兜底机制）
默认：3600秒（1小时）
作用：
- 防止漏掉 inotify 事件
- 防止程序异常
- 校验一致性
速度与带宽
- 设置 → 连接：限制上传/下载速度
- 设置 → 高级：调整并发、块大小
冲突处理
- 两边同时改同一文件 → 以最后保存的为标准新文件，旧文件另存为filename.sync-conflict-2026...
- 手动合并后删除冲突文件
端口与防火墙
- 默认端口：8384（Web）、22000（同步）
- 放行
# firewalld firewall-cmd --add-port=8384/tcp --permanent firewall-cmd --add-port=22000/tcp --permanent firewall-cmd --reload# ufw ufw allow 8384/tcp ufw allow 22000/tcp
忘记账号密码
vim ~/.local/state/syncthing<gui enabled="true" tls="false" sendBasicAuthPrompt="false"><address>0.0.0.0:8384</address><user>wzprod</user><password>$2a$10$fk.ZhNISGVRi7tPYS8sXr.FgnFOI/NKTt8ZMPrF8hEaE.l7Zi0Oze</password><metricsWithoutAuth>false</metricsWithoutAuth><apikey>j3tzCyQY5YH6uJPzRZyuaKz2CMNMmeTF</apikey><theme>default</theme></gui>###<password> → 删除这一行,重启生效后，Syncthing会免密登录。重新设置密码（b.1步骤）