用戶手冊 · 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: 顯示幫助。