用户手册 · Program Options 与高级主题

本部分合并 4 个原章节：Program Options（程序级选项）+ 特定应用同步指引 + 高级主题（时间偏移、环境变量、大小写、便携路径）+ GoodSync GUI 命令行与批量部署。配置入口：Windows Tools → Program Options；Mac GoodSync → Preferences。

Program Options（程序选项）

General（常规）

本标签提供 GoodSync 的常规选项。

Language（重启生效）: 从右侧下拉菜单选择首选语言。
Tree Display Density（重启生效，仅 Windows）: 选择 Sync Tree 的行间距 — 设置越高每页可见的项目越多。
Sort job names by alphabet（重启生效，默认勾选）: 勾选时 — GoodSync 按字母顺序列出 Job 与 Group；未勾选时 — 允许在 Job 列表中通过拖放重排 Job 与 Group。
Show Backup / Sync Jobs groups（重启生效，默认未勾选）: 勾选时 — Job 树中显示备份与同步 Job 的分组；未勾选时 — 不显示。
Show GoodSync icon in system tray（Windows，默认勾选）/ Start GoodSync in Menu Bar（Mac，默认勾选）: 勾选时 — GoodSync 运行时在系统托盘（Mac 菜单栏）显示；未勾选时 — 不显示。
Hide to System Tray when Main Window is closed（默认未勾选，仅 Windows）: 勾选时 — 关闭后 GoodSync 在后台运行；未勾选时 — 关闭后从内存卸载。
Start GoodSync when Windows starts / Start GoodSync when Mac starts（默认未勾选）: 启用时 — 登录系统账户时自动启动 GoodSync；禁用时 — 不自动启动。
Add GoodSync shortcut to desktop（默认勾选，仅 Windows）: 勾选时 — 在桌面添加 GoodSync 快捷方式。
Use New SMB implementation in Gs-Server smb:/ virtual folder（默认勾选，仅 Windows）: 勾选时 — 使用新的 Sib-SMB 客户端实现；未勾选时 — 使用 Windows SMB 客户端。
Prevent System idle sleep（默认勾选，仅 Mac）: 勾选时 — Job 运行或调度运行时 GoodSync 阻止 Mac 进入睡眠。
NOTE：从苹果菜单选「Sleep」或合上笔记本盖仍会强制睡眠 — 无法阻止。
Warn about Time Out Of Range（默认未勾选）: 勾选时 — 文件修改时间超出 1980-2037 范围时 GoodSync 发出警告。
Compare Program: 「Compare Program」字段中可指定用于比较文件的程序与命令行参数。
Mirror Folder: Mirror Folder（_mirrors_）是 _gsdata_ 文件夹的本地等价物 — 建立在 GoodSync Profile 文件夹内。它包含与 Job 各侧对应的子文件夹，存放 GoodSync 运行所需的关键数据：Job State Files、Job Logs、被删除/覆盖文件的前一版本，以及同步过程中使用与生成的其他技术文件。
初始时 Job 日志会本地写入 Mirror Folder。仅 Analyze 类 Job 的日志只在本地 Mirror Folder 可见。Job → Logs on Left/Right Side 菜单项会同时显示同步文件夹与本地 Mirror Folder 中的日志文件。

Account（账户）

本标签提供 GoodSync 应用中已登录 GoodSync Account 的简要信息。

Manage Account（管理账户）按钮: 在默认浏览器中打开 GoodSync Account Web UI — 自动登录账户以管理设备、license、GoodSync Storage、账户设置等。
Change Account（更换账户）按钮: 运行 GoodSync Account Setup 对话框以登录另一个 GoodSync Account。

License（授权）

本标签提供本机激活的 GoodSync license 信息。

Activate License（激活 License）按钮: 运行 GoodSync 激活对话框，在本机激活未使用的 GoodSync license。
Request Account Password when GoodSync starts（默认未勾选）: 勾选时 — GoodSync 应用启动时要求输入 GoodSync Account 密码（但 Runner Service 启动时不要求）。
Use Private Default Browser for OAuth（默认未勾选，仅 Windows）: 勾选时 — 需要 OAuth 认证时以隐私模式打开默认浏览器；未勾选时 — 以常规模式打开。

Auto（自动化）

本标签设置全局自动化。

Auto Jobs to run in parallel max（默认 1）: 指定可同时自动运行的 Job 数量。
Auto Jobs quant, sec（默认 3）: GoodSync 自动检查 Job 是否到点 — 此选项指定检查间隔。
Auto-hide Mini Window when there is no active jobs（默认勾选，仅 Windows）: 勾选时 — 没有活跃 Job 时自动隐藏 Mini Mode 窗口；未勾选时 — Mini Mode 始终显示。
Keep Auto Options when doing Account Sync（默认未勾选）: 勾选时 — Account Sync 期间保留本地 Job 的 Auto Options；未勾选时 — 本地 Job 的 Auto Options 会被 GoodSync Account 同步过来的 Auto Options 替换。
Keep file generation history for months（默认 12）: 设置 GoodSync 保留 file generation 历史的时长 — 超过此期限的历史会被丢弃。
Check for a new version daily（默认勾选）: 勾选时 — GoodSync 每天检查新版本。
Auto Install new version when found（默认勾选）: 勾选时 — 发现新版本时自动安装。

Filters（全局过滤器）

本标签配置全局 Filter 设置 — 这些过滤器会应用到所有 Job。详见过滤器章节。

SMTP（邮件服务器）

本标签配置发送邮件所用的 SMTP 服务器。

Use SMTP server to send emails（默认勾选）: 勾选时 — GoodSync 使用下方 SMTP 服务器发送 post-Analyze 与 post-Sync 邮件；未勾选时 — 使用本机默认 MAPI 客户端。
SMTP Server and Port: SMTP 服务器的 IP 名称或地址 + 端口。
默认端口：SMTP over TLS = 587；SMTP over SSL = 465；未加密 SMTP = 25。
SMTP UserID and Password: 若 SMTP 服务器要求认证 — 在此指定凭据。
Senders Email: GoodSync 发送邮件时使用的发件人邮箱地址。
Secure SMTP always over TLS/SSL (port 465)（默认未勾选）: 勾选时 — 在 465 端口用 TLS/SSL 加密 SMTP 通信；未勾选时 — 使用明文通信。
Secure SMTP switch to TLS using STARTTLS (port 587)（默认未勾选）: 勾选时 — 在 587 明文端口启动后用 STARTTLS 命令请求 TLS/SSL；未勾选时 — 使用明文通信。

配置完成后 — 点击「Test」按钮测试发送。

Shared by me / Shared with me（共享）

Shared by me：本标签便于把本机或本地网络上的文件夹共享给其他 GoodSync 用户。

共享文件夹的流程：

点击「Add」按钮创建新共享文件夹。
在弹出对话框中定位要共享的文件夹，并提供目标接收者的邮箱地址。可切换「Read-Only」选项管理写入权限。
点击「OK」 — 提供邮箱的接收者会收到关于该共享的通知邮件。
若接收者已有 GoodSync Account — 可立即在 GoodSync 应用 Browse 对话框中选择「GoodSync Connect」文件系统查看并访问该共享。

若接收者尚无账户 — 会提示邀请其加入 GoodSync。他们需创建 GoodSync Account 并在受支持设备上安装 GoodSync 应用以访问该共享。

所有创建的共享显示在表格中，包括以下属性：

From Computer — 共享所在计算机名。
From Folder — 共享文件夹路径。
To User — 共享对方的 GoodSync Account UserID。
To Computer — 在 GoodSync Connect 中显示的计算机名。
Read-Only — 该共享的只读设置。

Shared with me：本标签显示其他 GoodSync 用户通过「Shared by me」与当前用户共享的文件夹。

Storage（云存储管理）

本标签管理与所关联 GoodSync Account 关联的 GoodSync Online Storage。

若尚未申请 GoodSync Storage 或需要更多空间 — 用「Add」按钮申请或购买。

表格显示账户可用存储 — 包括存储计划与分配配额（GB）。也可通过 GoodSync Account Web UI 在线管理。

Proxy（代理）

本标签管理 GoodSync 应用的代理设置。

Do not use Proxy: 使用直连，不经代理。
Use Proxy server used by Internet Explorer for remote connections（默认）: 选中时 — GoodSync 使用与 Internet Explorer 和 WinInet 相同的代理服务器。
Use this Proxy server for remote connections: 选中时 — 使用下方字段指定的代理服务器。勾选后可输入代理服务器与端口。
Proxy UserID and Password: 非空时 — 用作所指定代理的 UserID 与 Password。空且使用指定代理服务器时 — 提供代理的 UserID 与 Password。点「Test」按钮确保代理设置正确。
FTP Proxy: 在此指定用于 FTP 连接的代理服务器与端口。
Trust System Root Certification Authorities（默认勾选）: 勾选时 — 允许第三方程序在向系统存储添加证书后侦听 GoodSync 的 TLS 通信。

Logs（日志）

Level of log detail（默认 Actions）: 设置日志窗口中所显示日志的详细级别 — 保存到文件的日志始终是最高详细级别。可能级别：0 = Critical、1 = Errors、2 = Actions、3 = Details。
Retain logs for this many days（默认 15）: 保留 Job 与全局日志的天数 — 删除更早的全局日志文件。
Store logs in folder: 指定存储 GoodSync 日志的自定义文件夹 — 空时 — 存储在用户应用 Profile 文件夹下的 GoodSync 文件夹。

Server（本地 GoodSync Server）

本标签控制本地 GoodSync Server 的设置。

Serve files to other devices: 该设置决定 GoodSync 在本机上作为服务器还是客户端。
勾选时 — GoodSync 可接受其他设备的请求（即作为 Server）— 本机数据可通过 GoodSync Connect 从其他已安装 GoodSync 的设备访问。
未勾选时 — GoodSync 仅能发出请求，不能接受请求（即作为 Client）。
Enable server Web UI on port（默认 11000）: 勾选时 — 启用本地 GoodSync Server UI（服务器管理控制台）— 通过浏览器访问 http://localhost:11000。点击「Server Advanced Options」按钮在默认浏览器中打开。
未勾选时 — Web UI 禁用，但 GoodSync Server 继续运行。

服务器日志（Server logs）

Level of log detail（默认 Transaction）: 设置服务器日志详细级别。可能级别：0 = Critical、1 = Errors、2 = Actions、3 = Details、4 = Transaction、5 = Debug。
Retain logs for this many days（默认 15）: 保留服务器日志的天数 — 删除更早的日志文件。
Store logs in folder: 指定存储服务器日志的自定义文件夹 — 空时存储到服务器配置文件中所指定的文件夹（Windows 默认 C:/ProgramData/GoodSync/server，Mac 默认 /Library/Application Support/GoodSync/server）。
以上服务器设置都可在服务器配置文件中修改 — 详见 GoodSync Connect 手册的对应章节。

特定应用同步指引

本章说明流行应用的同步配置。

RoboForm

较新版的 RoboForm 提供命令 RoboForm → Tools → Sync Data — 可自动设置同步 Job 并启动 GoodSync。

Outlook

同步包含 Outlook 数据的 .PST 文件。默认情况下 .PST 存储于：

C:\Users\<User Name>\AppData\Local\Microsoft\Outlook

建议在 Job → Options → Advanced 启用「Copy locked files using VSS snapshots」选项 — 这样 GoodSync 即便 .PST 在使用中也能复制。

Mozilla Thunderbird

同步 Thunderbird 配置文件夹。位于：

C:\Users\<User Name>\AppData\Roaming\Thunderbird\Profiles

Windows Mail

同步 Windows Mail 数据文件夹。位于：

C:\Users\<User Name>\AppData\Local\Microsoft\Windows Mail

QuickBooks

QuickBooks (QB) 把所有数据存储在一个 CompanyName.QBW 格式的文件 — 这是要同步的文件。QB 备份文件扩展名为 .QBB。

建议用 QB 原生 Backup 命令备份 QBW 文件，并把备份文件也同步 — 双重保护。

同样建议启用 Job → Options → Advanced → Copy locked files using VSS snapshots — 这样 .QBW 在使用中也能复制。

NOTE：即便 .QBW 仅以查看模式打开（未修改）— QuickBooks 仍会修改该文件。因此 GoodSync 不支持 .QBW 文件的双向同步 — 仅支持单向备份。

ACT!

ACT! 锁定其数据文件 — 即使 ACT! 关闭文件仍被锁定。原因是 ACT! 安装了一个即使应用未运行仍活跃的 SQL 服务 — 该服务持续锁定 ACT! 数据文件。

要同步这些文件 — 需临时停止 MSSQL ACT! 服务：

选择「开始 → 运行」或按 Win+R，输入 services.msc 并回车。
找到名为 MSSQL$ACT7（或类似）的服务并停止。
执行 Sync — 完成后再启动该服务。

高级主题（Advanced Topics）

管理时间偏移（Managing time shifts）

FAT 文件系统在 Windows 中仍在使用 — 一些 FTP 服务器也存在以下问题：

存储的是本地文件修改时间 — 在不同时区间移动会使修改时间产生偏移。
FAT 中的修改时间仅 2 秒精度 — 把文件复制到 FAT 时修改时间可能略有不同。GoodSync 忽略 ±2 秒以内的修改时间差异。

GoodSync 识别两种类型的 Time Shift：

Old-New Time Shift：相当数量文件的「当前修改时间」与「保存的修改时间」整小时差异 — 在下次 Sync 时通过保存新修改时间修正。
Left-Right Time Shift：相当数量文件在左右两侧有整小时修改时间差异 — 该 Time Shift 转化为 Copy Time 操作。

路径中的环境变量（Environment variables in paths）

Windows 环境变量可在文件夹路径中以以下方式插入：

%VARIABLE%

环境变量只能通过直接编辑路径放入 — 不能通过 Browse 对话框。

常用环境变量：

%GSDISK% — 启动 GoodSync.exe 的盘（如 C: 或 F:）。便携版中用此引用 GoodSync2Go 卷上的文件夹。
%USERNAME% — 当前 Windows 用户账户名。
%USERPROFILE% — 当前用户配置目录。
%COMPUTERNAME% — 本机的 Windows 计算机名。

GoodSync 还会替换以下专用变量：

%YYYY% — 当前年份。
%MM% — 当前月份（01–12）。
%DD% — 当前月日（01–31）。
%DOW% — 当前星期几（0–6）。
%WOM% — 当前月内第几周（1–4）。
%HH% — 当前小时（00–23）。
%II% — 当前分钟（00–59）。

大小写敏感性（Case-sensitivity）

GoodSync 的文件与文件夹树是大小写不敏感的 — 即对 GoodSync 来说，Folder\File.txt 与 FOLDER\file.TXT 指向同一项。

但 GoodSync 保留大小写。即如果一侧文件（或文件夹）名从 FilE.txt 改为 fILe.txt — GoodSync 会把此变更传播到另一侧。

这些设计选择反映现代操作系统的现实：

Windows 上 NTFS 与 FAT32 都是大小写不敏感、保留大小写的。
macOS 默认文件系统大小写不敏感、保留大小写。
一些 UNIX 文件系统及基于其的 FTP/SFTP 服务器确实大小写敏感。

但要能把大小写不敏感的 Windows/macOS 文件系统同步到它们 — 我们的树必须保持大小写不敏感。

便携路径（Portable paths）

左右同步文件夹中可指定便携路径：

=VolumeName:\folder1\folder2

VolumeName 是可在 Windows Explorer 卷属性中设置的卷标。

路径以便携格式指定时 — GoodSync 会在所有连接到本机的便携（可移动）盘中查找名为 VolumeName 的卷 — 因此即便该卷下次插入时获得不同盘符，GoodSync 仍能找到。

在 Browse 对话框选择可移动盘上的文件夹时 — GoodSync 会提示以便携格式保存路径。

在 GoodSync2Go 启动所在文件夹内选择文件夹时 — 盘符会自动替换为 %GSDISK%。这样无论可移动盘插到什么计算机、得到什么盘符 — GoodSync2Go 都能找到其同步文件夹（因为它们都在 %GSDISK% 上）。

NOTE：

计算机专属路径用于指代仅在某一台计算机上有效的路径。
%GSDISK% 可用在 Script 选项中指定的程序里 — 这样程序就从 GoodSync2Go 所在盘运行。

GoodSync GUI 命令行

Windows 版 GoodSync GUI 可通过命令行选项启动以修改其行为。

命令行调用格式：

GoodSync.exe [<profile-option>...] [<run-option>...] [<global-option>...] [<job-command> and <job-options>]

<profile-option>、<job-command> 与 <job-options> 在GSYNC 章节定义。

<run-option> 可以是：

/?, /help: 显示此帮助信息。
/min 或 /tray: 最小化到系统托盘运行。
/forcetray: 最小化到系统托盘运行 — 不允许显示主窗口或 Mini 窗口。
/miniwin: 以 Mini Mode 启动 — 允许显示主窗口。
/forceminiwin: 以 Mini Mode 启动 — 不允许显示主窗口。

<global-option> — 除 GSYNC 中描述的之外，还包括：

/exit: 命令行启动的 Job 完成后退出 GoodSync GUI。
/exit-ifok: 命令行启动的 Job 在无 terminal 错误下完成后退出 GoodSync GUI。

Windows 安装器选项

GoodSync Windows 安装包可使用以下命令行选项启动：

/gs-userid=UserId /gs-appkey=AppKey

同时指定 /gs-userid 与 /gs-appkey 时 — GoodSync 安装后会：

把本机注册到 UserId 指定的 GoodSync Account。
从 UserId 设置的 GoodSync Account 在本机激活 GoodSync license。

这是在多台计算机上自动化安装 GoodSync 的好方法。
Account AppKey 可在 GoodSync Account Web UI 中指定。AppKey 仅允许计算机注册与 license 激活 — 不允许 GoodSync Connect 事务。
NOTE：这是在线激活 — 安装包必须能访问 https://www.goodsync.com。

/gs-proxy=Host:Port

设置代理地址与端口 — 用于连接 GoodSync 服务器。

/gs-proxy-auth=UserId:Password

设置代理 UserID 与 Password — 用于连接 GoodSync 服务器。

/S

静默运行安装包 — 不向用户请求输入。

GoodSync 批量部署（Mass Deployment）

使用下方链接下载相应平台的自动化 GoodSync 安装包 — 然后用任意首选的批量部署工具在所有设备上安装。

Windows

GoodSync for Windows MSI

Mac

GoodSync for Mac Shell Script

该 shell 脚本可使用以下命令行选项：

-u | --update: 用当前 GoodSync Connect 配置更新 GoodSync。
-i | --install login password [noDisco]: 用指定 GoodSync Connect 凭据安装 GoodSync。noDisco 表示无发现模式。
-k | --install-appkey gs-userid gs-appkey [noDisco]: 用指定 gs-userid 与 gs-appkey 安装并激活 GoodSync。
-c | --install-code username authcode [noDisco]: 用指定 username 与 authcode 安装并激活 GoodSync。
-l | --local-only: 以仅本地模式安装 GoodSync 与 gs-server — gs-server 作为系统守护进程运行，由 GoodSync 内部使用。
-r | --remove: 卸载 GoodSync。
-d | --no-daemons: 无守护进程地安装/更新 GoodSync — 不安装 gs-server，gs-runner（Runner Service）作为用户代理安装且不请求权限。
-n | --no-license-agreement: 首次安装时不显示许可协议 — 可与其他参数一起使用，例：GoodSyncInstaller -n -i login password。
-h | --help: 显示帮助。