Syncthing Windows Setup错误排查手册：10个常见问题与解决方案

Syncthing Windows Setup错误排查手册：10个常见问题与解决方案

【免费下载链接】SyncthingWindowsSetupSyncthing Windows Setup项目地址: https://gitcode.com/gh_mirrors/sy/SyncthingWindowsSetup

Syncthing Windows Setup是一款轻量级但功能全面的Windows安装程序，用于开源的Syncthing文件同步应用。本文将帮助您解决安装和使用过程中可能遇到的10个常见问题，让您的文件同步体验更加顺畅。

1. 安装初始化错误：无效的WSH脚本注册

当您尝试安装Syncthing Windows Setup时，可能会遇到初始化错误，提示无效的WSH脚本注册。这是因为系统中JScript（.js）文件的WSH脚本注册缺失或不正确。

解决方案：

1. 打开注册表编辑器，导航到HKEY_CLASSES_ROOT\.js
2. 确保默认值为JSFile
3. 如果不是，以管理员身份打开命令提示符或PowerShell窗口，运行以下命令：

   reg add "HKCR\.js" /ve /d "JSFile"

2. 管理员模式重新安装时缺少参数

在管理员模式（所有用户）下重新安装时，如果未指定/allusers参数，安装程序会中止并显示错误消息。

解决方案： 重新运行安装程序，并在命令行中包含/allusers参数：

SyncthingWindowsSetup.exe /allusers

3. 域控制器上不允许为所有用户安装

由于安全原因，Setup不允许在Active Directory域控制器服务器上为所有用户安装（即Windows服务）。

解决方案：

• 在域控制器上，建议使用组托管服务账户（gMSA）运行syncthing.exe
• 或者，改为为当前用户安装而非所有用户

4. 脚本运行时消息显示不正确

当脚本运行时，消息可能显示乱码或不正确，这通常是编码问题导致的。

解决方案： 尝试使用UTF-16 LE（小端）编码保存脚本文件。

5. Syncthing v2及更高版本启动错误

在Syncthing v2及更高版本中使用--no-default-folder命令行选项会导致启动错误，因为该选项已被废弃。

解决方案： 确保您使用的配置脚本在检测到Syncthing v2及更高版本时不会使用--no-default-folder选项。配置脚本应已包含此检查，如en-SetSyncthingConfig.js中所示：

// version >= 2 does not support --no-default-folder if (versionMajor < 2) { cmdLine += ' --no-default-folder'; }

6. 静默安装时没有错误对话框

在静默安装模式下，如果SetSyncthingConfig.js脚本遇到错误，不会显示错误对话框，可能导致安装失败而用户不知情。

解决方案：

• 非静默安装时留意错误消息
• 检查安装日志文件以排查问题
• 确保系统满足所有安装要求

7. 防火墙规则创建失败

在非管理员安装模式下，防火墙规则创建可能失败或需要管理员权限。

解决方案： 手动创建防火墙规则，以管理员身份打开PowerShell或命令提示符窗口，运行以下命令：

cscript "C:\Users\username\AppData\Local\Programs\Syncthing\SyncthingFirewallRule.js" /create

（将路径替换为您的实际安装路径）

8. 服务账户权限问题

在管理员安装模式下，Syncthing作为Windows服务运行，可能没有足够权限访问需要同步的文件夹。

解决方案： 授予服务账户（默认为SyncthingServiceAcct）对同步文件夹的"修改"权限。可以使用Windows文件资源管理器或命令行：

icacls "C:\需要同步的文件夹" /grant "SyncthingServiceAcct:(OI)(CI)M" /t

9. 旧版本升级后配置数据迁移问题

从1.19.1或更早版本升级到1.27.0及更高版本时，配置数据不会自动迁移。

解决方案：

1. 先升级到1.26.1版本以迁移配置数据
2. 然后再升级到1.27.0或更高版本

10. 无法连接到GitHub下载最新版本

如果计算机无法连接到GitHub，Setup将无法下载最新版本的Syncthing。

解决方案： 执行离线安装：

1. 从另一台可以连接到GitHub的计算机下载Syncthing Windows zip文件
2. 使用/zipfilepath参数指定下载的zip文件路径：

   SyncthingWindowsSetup.exe /zipfilepath="C:\path\to\syncthing-windows-amd64-vx.x.x.zip"

总结

Syncthing Windows Setup是一个功能强大的工具，可以帮助您轻松安装和配置Syncthing。遇到问题时，参考本文提供的解决方案，大多数常见问题都可以快速解决。如果您遇到其他问题，请查阅项目文档或提交issue获取帮助。

在排查问题时，建议先检查安装日志文件，其中通常包含详细的错误信息。同时，确保您使用的是最新版本的Syncthing Windows Setup，以获得最佳的兼容性和最新的错误修复。

【免费下载链接】SyncthingWindowsSetupSyncthing Windows Setup项目地址: https://gitcode.com/gh_mirrors/sy/SyncthingWindowsSetup