Synology Sync

by my3rs
5
4
3
2
1
Score: 36/100

Description

Sync your Obsidian vault with your Synology NAS via the official Synology Drive API.

Reviews

No reviews yet.

Stats

0
stars
305
downloads
2
forks
18
days
0
days
10
days
1
total PRs
1
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
146
commits

Latest Version

10 days ago

Changelog

本次更新是一次重大升级。全面重构了同步引擎内核,大幅提升了文件上传与深层目录遍历的稳定性,并带来了全新的同步状态视图日志搜索与筛选面板

🚀 核心同步引擎升级

  • 三向比对差异计算器:基于本地状态、本地基线与远程清单实现三向差异分析,显著提高文件变更与冲突判定的精准度。
  • 分布式同步锁与心跳续期:引入 Synology 同步清单与云端锁管理机制,加入后台心跳续期,有效防止多设备并发同步时产生竞态与数据覆盖。
  • 递归目录遍历优化:重构远程 Synology 目录检索逻辑,支持深层子目录的递归遍历,确保嵌套文件及文件夹同步无遗漏。
  • 并发处理与冲突自动解决:全面优化并发文件传输调度,优化冲突自动合并与解决逻辑,移除繁琐的打扰式弹窗。

🎨 界面与交互体验

  • 新增同步状态视图
    • 新增专用的同步状态面板与详情视图,支持在侧边栏实时查看同步进度与文件状态。
    • 在文件菜单与编辑菜单中增加状态视图快速切换入口。
  • 高级日志面板
    • 日志模态框重构,新增关键词搜索日志级别过滤一键清空日志功能。
    • 优化顶部工具栏布局与移动端字体排版。
  • 首次登录配置向导
    • 新增新手引导向导,首次配置 NAS 连接时一步步引导完成同步基准设置。
  • 设置界面重构与完整
    • 重新梳理并分组设置选项,完善中英文双语界面的帮助与字段描述。

🐛 稳定性与问题修复

  • 修复文件上传路径分割问题:修复 Synology API 客户端在深层路径上传时参数分离错误的 Bug。
  • 清单与锁文件容错增强:修复初始同步或清单文件不存在时的异常处理逻辑,杜绝同步中断和潜在的误删风险。
  • 大文件同步性能保护:优化单个超大文件的传输跳过与限流逻辑,降低内存占用与网络拥塞。
  • 新增调试模式:在设置中提供「调试模式」开关,开启后输出详细的 WebAPI 交互日志,便于排查 NAS 连接与权限问题。

README file from

Github

Obsidian Synology Sync

Release

中文

Disclaimer: This plugin is an independent community project and is not affiliated with, funded, or endorsed by Synology Inc.

Sync your Obsidian vault with your Synology NAS via the Official Synology Drive API. This plugin provides a secure and reliable way to backup and synchronize your Obsidian notes directly to your Synology Drive without relying on any third-party cloud services.

Features

  • Direct synchronization leveraging the Official Synology WebAPI for maximum security and native compatibility.
  • Support for two-way sync, upload only, and download only modes.
  • Secure connection using your Synology credentials (your credentials communicate directly with your NAS; no third-party servers are involved).
  • Multi-language support (English and Chinese).

Configuration

  1. Go to the "Synology Sync" settings tab.
  2. Enter your Synology NAS URL (e.g., https://your-nas-ip:5001).
  3. Enter your Synology username and password.
  4. Test the connection and start syncing!

See the sync and recovery guide for usage details, or the development guide to build and test the plugin.

Disclaimer

Important Notice & Trademark Disclaimer:

  • Disclaimer: This plugin is an independent community project and is not affiliated with, funded, or endorsed by Synology Inc. Synology, Synology Drive, and other Synology product names/logos are trademarks or registered trademarks of Synology Inc.
  • This plugin is an open-source, third-party tool designed to synchronize Obsidian notes with your Synology NAS via the Synology WebAPI. By using this plugin, you acknowledge and agree to the following:
  1. Safety First: While reasonable efforts have been made to ensure the reliability and security of this plugin, unexpected bugs, environmental differences, network fluctuations, or improper NAS configurations may result in synchronization errors, file corruption, or permanent data loss. We strongly recommend that you make complete backups of your vault (for example, using local copies or Synology Hyper Backup) before using this plugin, especially when running synchronization tasks.
  2. No Warranty: The software is provided "AS IS", without warranty of any kind, express or implied. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
  3. Data Privacy: Your Synology account credentials and plugin configurations are saved securely on your local device only. This plugin communicates directly with your self-hosted NAS, and no data is ever transmitted to or stored on any third-party servers.

By installing or using this plugin, you acknowledge that you have read, understood, and accepted this disclaimer.