一、先明确:Synology Drive 日志的 3 大类型与核心作用

Synology Drive 日志按 “功能场景” 分为 3 类,不同类型的日志对应不同排查需求,需先明确区别再针对性查看:
日志类型
核心记录内容
查看场景(用户痛点)
存储位置(默认路径)
1. 同步日志
每一次文件同步的状态(成功 / 失败)、同步时间、文件路径、错误代码
排查 “文件同步卡住”“部分文件同步失败”“同步速度慢”
DSM:/var/log/synodrive/;客户端:本地应用日志文件夹
2. 协作日志
多人协作时的操作记录(如谁编辑了文件、谁添加了批注、版本冲突记录)
定位 “团队文件被误删”“版本覆盖导致数据丢失”“批注不显示”
DSM:Synology Drive 管理控制台→协作日志;客户端:协作历史记录
3. 系统日志
Synology Drive 服务的运行状态(如服务启动 / 停止、连接服务器失败、资源占用异常)
解决 “客户端无法连接 NAS”“Drive 服务频繁崩溃”“CPU 占用过高”
DSM:控制面板→日志中心→应用程序→Synology Drive;客户端:系统事件日志
官方提醒:最易忽略的日志价值 —— 同步日志中的 “错误代码”(如 401、403、500)是定位问题的关键,而非仅看 “同步失败” 的提示文字。

二、分步指南:查看 Synology Drive 日志的 4 种场景(多端覆盖)

Synology Drive 日志需在 “DSM 端(服务器)” 和 “客户端(Windows/macOS/ 移动端)” 分别查看,不同端的日志侧重点不同,以下是详细操作步骤:

2.1 场景 1:在 DSM 端查看完整日志(服务器端,推荐优先查看)

DSM 端日志记录 “所有客户端的同步行为”“服务运行状态”,适合排查跨客户端的共性问题(如所有电脑同步失败):

子步骤 1.1:查看同步日志与系统日志

  1. 登录 Synology DSM 管理界面,打开「Synology Drive 管理控制台」(需先安装 Synology Drive Server 套件);
  1. 点击左侧导航栏「日志」,选择日志类型:
    • 「同步日志」:查看所有文件的同步记录,可按 “客户端 IP”“文件路径”“同步状态” 筛选(如筛选 “失败” 状态,快速定位问题文件);
    • 「系统日志」:查看 Drive 服务的运行状态,如 “2024-06-10 09:30: Synology Drive Server 启动成功”“2024-06-10 10:15: 连接数据库超时”;
  1. 查看细节:点击单条日志,右侧会显示 “详细描述”(如同步失败的错误代码、触发时间、涉及的用户账号)。

子步骤 1.2:通过日志中心查看系统级日志

若需查看更全面的服务运行日志(如资源占用、端口冲突):
  1. 打开 DSM「控制面板→日志中心→应用程序」;
  1. 在 “应用程序” 下拉菜单中选择「Synology Drive」,即可查看系统级日志(如 “端口 5001 被占用,Drive 服务启动失败”);
  1. 可点击「导出」,将日志保存为 TXT 文件,便于后续分析或发送给官方支持。

2.2 场景 2:在 Windows 客户端查看日志(本地同步问题)

Windows 客户端日志记录 “本地文件与 NAS 的同步交互”,适合排查 “单台电脑同步失败”(如某文件始终同步不了):

子步骤 2.1:打开客户端日志文件夹

  1. 打开 Synology Drive Windows 客户端(右下角任务栏图标,右键→「设置」);
  1. 在 “设置” 窗口点击「高级→日志」,点击「打开日志文件夹」,自动跳转至日志存储路径(默认:C:Users[你的用户名]AppDataRoamingSynologySynology Drivelog);

子步骤 2.2:解读日志文件

  1. 日志文件夹包含 2 类核心文件:
    • sync.log:记录所有文件同步的详细过程,每一行包含 “时间戳、同步状态、文件路径、错误信息”(如 “2024-06-10 10:20: [ERROR] /Document/Report.docx: Sync failed, Error 403: Permission denied”);
    • service.log:记录客户端服务的运行状态(如 “服务启动成功”“与 NAS 断开连接”);
  1. 用记事本或 Notepad++ 打开日志文件,按 “Ctrl+F” 搜索关键词(如文件名、错误代码),快速定位问题记录。

2.3 场景 3:在 macOS 客户端查看日志

macOS 客户端日志路径与 Windows 不同,但查看逻辑一致,步骤如下:
  1. 打开 Synology Drive macOS 客户端(顶部菜单栏图标,右键→「偏好设置」);
  1. 点击「高级→日志」,点击「显示日志」,跳转至日志路径(默认:~/Library/Application Support/Synology/Synology Drive/log);
  1. 核心日志文件与 Windows 一致(sync.log和service.log),用 “文本编辑” 或 “终端” 打开查看,搜索关键词排查问题。

2.4 场景 4:在移动端(iOS/Android)查看简化日志

移动端日志仅记录 “关键同步事件”(如同步成功、同步失败),适合快速排查基础问题:
  1. 打开 Synology Drive 移动端 App,点击底部「我的」;
  1. 选择「设置→关于→日志」,查看简化日志(如 “2024-06-10 11:00: 相册文件夹同步成功,共 30 个文件”“2024-06-10 11:05: 文档文件夹同步失败,权限不足”);
  1. 若需详细日志,可点击「导出日志」,通过邮件发送到电脑,再进一步分析。

三、重点:Synology Drive 常见日志代码与解读(官方整理)

日志中的 “错误代码” 是排查问题的 “钥匙”,以下是官方整理的高频代码,包含原因与解决方法,可直接对照使用:
错误代码
日志描述(示例)
核心原因
分步解决方法
401
“Sync failed: Error 401: Unauthorized”
客户端与 NAS 的身份验证失败(如账号密码错误、Token 过期)
1. 退出客户端账号(Windows:右键图标→「退出登录」);2. 重新登录,输入正确的 DSM 账号密码;3. 若仍失败,在 DSM「控制面板→用户账号」中,确认账号未被禁用。
403
“File /Report.docx: Error 403: Permission denied”
客户端账号对目标文件 / 文件夹无 “读取 / 写入” 权限
1. 登录 DSM→「File Station」,找到目标文件;2. 右键→「属性→权限」,添加客户端账号;3. 授予「读取 / 写入」权限,点击「应用」;4. 重启客户端同步。
404
“Folder not found: Error 404: Not Found”
同步的目标文件夹已被删除或移动(NAS 端)
1. 在 DSM「File Station」中,确认文件夹是否存在;2. 若已删除,恢复回收站中的文件夹;3. 若已移动,在客户端「设置→同步任务」中,重新选择新路径。
500
“Server error: Error 500: Internal Server Error”
Synology Drive Server 服务运行异常(NAS 端)
1. 登录 DSM→「套件中心→已安装」;2. 找到「Synology Drive Server」,点击「操作→重启」;3. 等待服务重启(约 1 分钟),再重启客户端同步。
503
“Service unavailable: Error 503: Service Unavailable”
NAS 端 Drive 服务过载或未启动
1. 打开 DSM「资源监控→进程」,查看「synodrive-server」进程是否运行;2. 若未运行,在「套件中心」重启服务;3. 若 CPU / 内存占用过高(>80%),关闭非必要服务(如 Docker),再重试。
Sync Conflict
“File /Data.xlsx: Sync Conflict - Multiple edits”
多端同时编辑同一文件,导致版本冲突
1. 登录 DSM「Synology Drive」,找到冲突文件(文件名后带 “(冲突)”);2. 点击文件→「版本历史」,对比不同版本内容;3. 合并内容后,删除多余冲突文件;4. 重启同步。

四、日志管理:保存、导出与清理(避免日志堆积)

长期使用后,日志文件会占用存储空间,需定期管理,官方推荐以下操作:

4.1 日志保存时间设置(DSM 端)

  1. 登录 DSM→「Synology Drive 管理控制台→日志→设置」;
  1. 在 “日志保存时间” 中,选择保存周期(如 “30 天”,企业用户可设 “90 天” 用于审计);
  1. 勾选 “自动删除过期日志”,系统会定期清理超期日志,无需手动操作。

4.2 导出日志给官方支持(排查复杂问题)

若通过日志无法解决问题,需将日志发送给 Synology 官方支持:
  1. DSM 端:打开「Synology Drive 管理控制台→日志」,点击「导出」,选择 “所有日志”,保存为 ZIP 文件;
  1. 客户端:Windows 端在日志文件夹中,压缩sync.log和service.log;
  1. 打开 Synology 支持中心(https://www.synology.com/zh-cn/support),提交工单时上传日志文件,说明问题现象。

4.3 清理客户端旧日志(Windows/macOS)

  1. Windows:打开日志文件夹(C:Users[用户名]AppDataRoamingSynologySynology Drivelog),删除 30 天前的日志文件;
  1. macOS:打开日志路径(~/Library/Application Support/Synology/Synology Drive/log),手动删除旧日志;
  1. 注意:保留最近 7 天的日志,便于后续排查新问题。

五、案例分析:通过日志解决 3 类常见问题(实战演示)

结合实际使用场景,演示如何通过日志快速定位并解决问题:

案例 1:Windows 客户端同步某文件始终失败

  1. 查看日志:打开 Windows 客户端日志sync.log,搜索文件名 “Project.pdf”,找到日志记录:“2024-06-10 14:30: [ERROR] /Project.pdf: Sync failed, Error 403: Permission denied”;
  1. 定位原因:Error 403 说明权限不足,客户端账号对 “Project.pdf” 无写入权限;
  1. 解决步骤:登录 DSM→「File Station」找到该文件→右键「属性→权限」→添加客户端账号并授予「读取 / 写入」权限→重启客户端同步,问题解决。

案例 2:多团队成员编辑文件后出现冲突

  1. 查看日志:在 DSM「Synology Drive 管理控制台→日志→协作日志」,找到冲突文件 “Report.xlsx”,日志显示 “2024-06-10 15:10: Sync Conflict - User A and User B edited the file at the same time”;
  1. 定位原因:用户 A 和用户 B 在 15:00-15:10 同时编辑该文件,未同步导致冲突;
  1. 解决步骤:打开该文件的「版本历史」,对比 A 和 B 的修改内容→合并关键信息→删除冲突版本→通知团队成员重新同步,避免再次同时编辑。

案例 3:移动端无法连接 NAS,提示 “服务不可用”

  1. 查看日志:移动端「设置→关于→日志」显示 “2024-06-10 16:00: Connect failed, Error 503: Service Unavailable”;
  1. 定位原因:Error 503 说明 NAS 端 Drive 服务未启动;
  1. 解决步骤:登录 DSM「套件中心→已安装」→找到「Synology Drive Server」→点击「重启」→1 分钟后移动端重新连接,问题解决。

六、常见问题解答(日志使用中的高频疑问)

Q1:客户端日志文件夹找不到,怎么办?

A1:多为 “隐藏文件夹未显示”,解决步骤:
  • Windows:打开文件资源管理器→点击顶部「查看」→勾选「隐藏的项目」,即可看到 AppData 文件夹;
  • macOS:打开「访达」→按「Command+Shift+G」→输入路径~/Library→回车,即可找到 Application Support 文件夹。

Q2:日志中出现乱码,无法正常阅读,如何处理?

A2:是日志文件编码格式不匹配,解决方法:
  • 用 Notepad++ 打开日志文件→点击顶部「编码」→选择「UTF-8」→保存后重新打开,乱码消失;
  • macOS 用 “文本编辑” 打开时,选择「格式→制作纯文本」,再设置编码为 UTF-8。

Q3:日志记录太多,如何快速找到关键信息?

A3:利用 “关键词搜索” 和 “筛选功能”:
  • DSM 端:在日志页面按 “同步状态” 筛选(如 “失败”),再搜索文件名或错误代码;
  • 客户端:用记事本打开日志→按 “Ctrl+F” 输入关键词(如 “Error”“失败”“文件名”),快速定位问题记录。

总结

Synology Drive 日志是 “排查故障的核心工具”,掌握 “查看日志→解读代码→解决问题” 的流程,能大幅提升问题处理效率。日常使用中,建议定期查看同步日志(如每周 1 次),及时发现潜在问题(如权限不足、服务异常);遇到复杂问题时,导出日志给官方支持,获取精准帮助。通过本文的步骤与解读,即使是非技术用户,也能轻松通过日志管理 Synology Drive 的同步与协作。
Synology Drive 日志描述详解:查看步骤 + 代码解读 + 问题排查

新闻中心

联系我们

技术支持

  • ·

    Synology Drive 我...

  • ·

    Synology Drive 与...

  • ·

    Synology Drive 内...

  • ·

    Synology Drive 同...

  • ·

    Synology删除文件后存储空...

  • ·

    Synology DSM 检查系...

  • ·

    Synology Drive能当...

  • ·

    Synology Docker容...

相关文章

地址:北京市海淀区白家疃尚品园             1号楼225

北京群晖时代科技有限公司

微信咨询

新闻中心