GoodSync 日志解读与自我诊断指南
日志文件位置
不同平台的日志路径不同：
| 平台 | GoodSync 日志目录 | 临时文件目录 |
|---|---|---|
| Windows | %APPDATA%\GoodSync\Logs\ | %TEMP%\GoodSync\ |
| macOS | ~/Library/Application Support/GoodSync/Logs/ | $TMPDIR |
| Linux | ~/.goodsync/logs/ | /tmp/ |
| Synology | 套件内数据目录 | DSM 临时目录 |
| QNAP | 套件内数据目录 | QTS 临时目录 |
| Docker | 容器内 /root/.goodsync/logs/ | 容器 /tmp/ |
快速打开日志目录：
- GoodSync 主界面 → 菜单栏 Help → Open Log Folder
日志级别
GoodSync 在作业 Options → Advanced → Log Detail Level 提供 5 档日志级别：
| 级别 | 输出内容 | 适用场景 |
|---|---|---|
| Minimal | 仅错误和警告 | 日常运行 |
| Low | 关键事件 + 错误 | 日常运行（推荐） |
| Normal | 所有文件操作摘要 | 推荐（默认） |
| Verbose | 详细文件信息 + 操作参数 | 问题排查 |
| Maximal | 完整调用栈 + 所有内部状态 | 深度调试、联系技术支持 |
日常保持「Normal」即可。遇到问题时切换到「Verbose」或「Maximal」，重跑一次触发问题的作业，然后查看新生成的日志。
日志结构解读
GoodSync 的日志格式：
[时间戳] [级别] [作业名] 具体信息
# 示例：
[2026-10-13 14:30:22] [Info] [BackupToNAS] Analyze started
[2026-10-13 14:30:22] [Info] [BackupToNAS] Left: D:\Backup
[2026-10-13 14:30:22] [Info] [BackupToNAS] Right: gstps://Family-NAS-Syno.user.goodsync/backup
[2026-10-13 14:30:25] [Info] [BackupToNAS] Found 1234 files on left
[2026-10-13 14:30:26] [Info] [BackupToNAS] Found 1230 files on right
[2026-10-13 14:30:27] [Warn] [BackupToNAS] File modified on both sides: config.ini
[2026-10-13 14:30:27] [Info] [BackupToNAS] Conflict auto-resolved: keep both
[2026-10-13 14:30:28] [Info] [BackupToNAS] Sync started
[2026-10-13 14:30:35] [Error] [BackupToNAS] Cannot write to right side: Access Denied
[2026-10-13 14:30:35] [Error] [BackupToNAS] Sync failed with 1 error日志级别标记
| 级别标记 | 含义 | 是否需要关注 |
|---|---|---|
[Info] | 正常信息 | 了解同步流程用 |
[Warn] | 警告（非致命） | 需要关注但不一定是问题 |
[Error] | 错误（同步中断或部分失败） | 必须解决 |
[Debug] | 调试信息 | 仅 Verbose/Maximal 级别出现 |
[Trace] | 跟踪信息 | 仅 Maximal 级别出现，最底层 |
常见关键词搜索
连接问题
# PowerShell 搜索日志
Select-String -Path "$env:APPDATA\GoodSync\Logs\*.log" -Pattern "mediator|connect|forwarder|refused|timeout" -SimpleMatch
# 关键词含义：
# "mediator" → Connect 协调服务器交互
# "connect" → 连接尝试
# "forwarder" → Forwarder 转发
# "refused" → 连接被拒绝
# "timeout" → 超时权限问题
Select-String -Path "$env:APPDATA\GoodSync\Logs\*.log" -Pattern "access denied|permission|denied" -SimpleMatch同步失败
Select-String -Path "$env:APPDATA\GoodSync\Logs\*.log" -Pattern "error|failed|exception"限流问题（云存储）
Select-String -Path "$env:APPDATA\GoodSync\Logs\*.log" -Pattern "throttl|rate limit|slowdown|429"块级传输状态
Select-String -Path "$env:APPDATA\GoodSync\Logs\*.log" -Pattern "block level"
# 看到 "Block level transfer enabled" = 块级传输生效
# 看到 "Block level not available" = 降级到文件级GoodSync 内建诊断工具
Help → Run Diagnostics
GoodSync 主界面 → Help → Run Diagnostics 会自动检测：
- GoodSync Connect 配置是否正确
- 端点连接是否正常
- 作业配置是否有明显问题
- 系统环境是否满足 GoodSync 运行要求
检测完成后生成诊断报告，包括：
- 每个检测项的结果（通过/警告/失败）
- 失败项的具体原因和修复建议
- 系统信息（操作系统版本、CPU、内存、磁盘）
- GoodSync 版本和运行模式
生成压缩诊断包
诊断工具可以把日志、配置、系统信息打包成一个压缩包：
- 位置：GoodSync → 菜单栏 Help → Generate Support Package
- 用途：遇到复杂问题时发给 GoodSync 技术支持
GoodSync 主界面状态区
GoodSync 主界面底部或右下角有状态区：
| 状态 | 含义 |
|---|---|
| 绿色勾选 | 最近一次同步成功 |
| 黄色感叹号 | 最近一次同步有警告（如冲突自动解决） |
| 红色叉号 | 最近一次同步失败 |
| 灰色图标 | 作业从未运行或被手动暂停 |
| 齿轮图标转动 | 作业正在运行中 |
实时日志面板
GoodSync 主界面底部的「Log」标签页是实时日志面板：
- 同步过程中实时滚动显示操作日志
- 可以筛选当前作业的日志
- 可以导出为文本文件
状态文件 _gsdata_
GoodSync 在每个端点路径下维护 _gsdata_ 目录：
目标端点/
└── _gsdata_/
├── _state/ ← GoodSync 的内部状态文件（不要手动修改！）
├── _history/ ← 版本历史目录（在这）
└── _jobs_/ ← 作业配置（可选）重要：_gsdata_ 目录中的 _state/ 子目录是 GoodSync 用来追踪文件状态的核心数据结构。不要手动修改或删除——如果怀疑状态文件损坏，应该通过 GoodSync 重新 Analyze 让它重建。
重建状态文件
如果怀疑 _state/ 目录损坏导致同步异常：
- GoodSync 主界面 → 作业 → Clear State（或类似选项）
- GoodSync 会清空内部状态文件并强制全量重新分析
- 重新 Analyze → 应该能正常计算差异
自检清单
提交问题到 GoodSync 技术支持前，按以下清单准备：
- [ ] GoodSync 版本号（主界面 Help → About）
- [ ] 操作系统版本
- [ ] 两端端点类型（如 GSTP / Google Drive / SMB 等）
- [ ] 问题的可复现步骤
- [ ] 触发问题的作业配置（导出为 .gs XML 文件）
- [ ] Verbose 或 Maximal 级别的日志文件
- [ ] 诊断工具生成的 Support Package
- [ ]
_gsdata_/_state/目录的状态（是否被手动修改过）
GoodSync 技术支持渠道
GoodSync 官方技术支持：
- 帮助中心：help.goodsync.com
- 社区论坛：GoodSync 用户讨论
- 商业客户：购买商业版后有优先支持渠道
- Bug 报告：GoodSync 官网的问题反馈页面
提交 Bug 时务必附上完整的诊断信息和可复现步骤——良好的反馈能大大加快问题解决速度。