Syncthing Windows Setup 安装与配置完整指南

项目概述

Syncthing Windows Setup 是一个基于 Inno Setup 构建的轻量级 Windows 安装程序，专门为开源文件同步工具 Syncthing 提供完整的安装解决方案。该项目简化了在 Windows 系统上部署和配置 Syncthing 的流程，支持在线和离线安装模式。

系统要求

• Windows 10 或 Windows Server 2016 及以上版本
• 支持 32 位和 64 位系统架构
• 需要网络连接（在线安装模式）

安装前准备

获取安装文件

从项目仓库下载最新的安装包文件。项目采用模块化设计，包含完整的安装脚本和辅助工具。

环境检查

在开始安装前，请确保系统满足以下条件：

• 拥有足够的磁盘空间
• 关闭可能冲突的应用程序
• 确保网络连接稳定（在线安装）

安装模式详解

非管理员安装模式（当前用户）

这是默认推荐的安装方式，适合大多数用户：

• 仅安装到当前用户账户
• 默认安装目录：用户本地应用数据文件夹
• 通过计划任务实现开机自启动
• 无需管理员权限即可管理配置

管理员安装模式（所有用户）

适合高级用户和企业环境：

• 安装为 Windows 服务
• 所有用户均可访问
• 系统启动时自动运行
• 需要手动配置文件夹权限

详细安装步骤

标准图形界面安装

1. 双击安装程序启动向导
2. 阅读并接受许可协议
3. 选择安装目录和开始菜单文件夹
4. 配置同步设置参数
5. 选择附加任务选项
6. 确认安装信息并执行安装

静默安装模式

通过命令行参数实现无人值守安装：

• 非管理员静默安装：/silent /currentuser
• 管理员静默安装：/silent /allusers

核心配置参数

自动升级设置

配置 Syncthing 自动检查更新的时间间隔：

• 默认值：12 小时
• 设置为 0 可禁用自动升级功能

监听地址与端口

• 默认监听地址：127.0.0.1
• 默认端口号：8384
• 支持自定义网络配置

中继服务配置

控制是否启用中继功能：

• 默认启用中继服务
• 可配置为禁用状态

防火墙规则管理

自动创建规则

在管理员安装模式下，Setup 会自动创建 Windows 防火墙规则，允许 Syncthing 进行网络通信。

手动管理规则

对于非管理员安装模式，可以通过脚本手动创建或移除防火墙规则。

辅助工具说明

Setup 安装包包含多个辅助工具，用于增强使用体验：

• SetSyncthingConfig.js - 配置管理脚本
• SyncthingFirewallRule.js - 防火墙规则脚本
• stctl.exe - 服务控制工具
• asmt.exe - 服务账户管理工具
• ServMan.exe - 服务管理器
• shawl.exe - 服务包装工具

服务账户配置

默认服务账户

管理员安装模式使用本地服务账户：

• 默认用户名：SyncthingServiceAcct
• 自动设置长随机密码
• 授予"作为服务登录"权限

故障排除指南

常见安装问题

初始化错误处理

• 域控制器不允许所有用户安装
• WSH 脚本注册验证失败
• 检测到管理员安装模式

服务状态检查

提供多种方式检查 Syncthing 运行状态：

• 使用任务管理器查看进程
• 通过命令行工具检测服务状态

升级与降级操作

版本升级流程

支持从旧版本平滑升级到新版本，注意配置数据的迁移策略。

降级注意事项

如需降级到旧版本，需要手动替换执行文件并调整配置。

本地化支持

项目支持多语言本地化，可通过以下步骤添加新语言支持：

1. 复制并翻译消息文件
2. 提供本地化的许可协议文档
3. 更新脚本文件中的文本内容
4. 配置安装脚本支持新语言

最佳实践建议

性能优化

• 合理设置同步检查间隔
• 根据网络环境调整带宽限制
• 监控系统资源使用情况

安全配置

• 启用加密传输协议
• 定期更新软件版本
• 备份重要配置文件

网络环境适配

根据不同的网络环境调整配置参数：

• 企业网络可能需要禁用中继功能
• 家庭网络可保持默认配置

通过本指南，您将能够全面掌握 Syncthing Windows Setup 的安装配置方法，实现在 Windows 平台上高效安全的文件同步体验。