حلّ المجتمع

إعداد Obsidian LiveSync المستضاف ذاتيًا على CasaOS: CouchDB وHTTPS وأمان المزامنة

A March 2025 CasaOS post linking to an external Big Bear tutorial for Obsidian Self-hosted LiveSync. The forum body does not preserve the actual Compose configuration, so a durable page must keep the historical source while using current upstream LiveSync/CouchDB guidance.

إن مشاركة المنتدى الأصلية عبارة عن مقدمة ورابط إلى برنامج تعليمي خارجي، وليست سجلًا كاملًا للنشر. وهي تعد بإعداد سريع لـ CasaOS من أجل Obsidian Self-hosted LiveSync، لكن المشاركة نفسها لا تحتفظ بصورة CouchDB، أو مسارات وحدات التخزين، أو بيانات الاعتماد، أو إعداد HTTPS، أو إعداد العميل المستخدم في الفيديو الأصلي.

للتثبيت الحالي، استخدم مشروع Self-hosted LiveSync المُصان بوصفه الأساس التقني. ما يزال إعداد المشروع الأساسي يعتمد على CouchDB، ويوثق صراحةً استخدام Docker، وبيانات CouchDB وإعداداته الدائمة، وإتاحة الوصول عبر HTTPS، ومعرّف إعداد لتهيئة عملاء Obsidian.

صورة مصغرة لبرنامج Big Bear التعليمي لتشغيل Obsidian Self-hosted LiveSync على CasaOS
تشير مشاركة المجتمع أساسًا إلى هذا البرنامج التعليمي الخارجي لعام 2025، بدلًا من تخزين إعدادات النشر في المنتدى نفسه.

إن Self-hosted LiveSync طبقة مزامنة، وليس تطبيق Obsidian نفسه

يبقى Obsidian مثبتًا على أجهزة الكمبيوتر المكتبية أو الأجهزة المحمولة لديك. يضيف Self-hosted LiveSync إضافة مزامنة مجتمعية وقاعدة بيانات على الخادم، بحيث يمكن أن تنتقل تغييرات خزائن الملاحظات بين الأجهزة من دون الاعتماد على خدمة Sync المدفوعة من Obsidian.

المشروع الأساسي برمجية مجتمعية، وليس خدمة رسمية من Obsidian.

يمثل CouchDB مكوّن الخادم الأساسي

يستخدم دليل الإعداد الحالي للمشروع الأساسي CouchDB بوصفه الواجهة الخلفية المستضافة ذاتيًا الرئيسية. وينشئ مثال Docker الخاص به أدلة دائمة لبيانات CouchDB وإعداداته قبل بدء الحاوية.

استخدم إعداد خادم Self-hosted LiveSync الحالي بدلًا من نسخ علامات الصور القديمة من فيديو.

احفظ قاعدة بيانات CouchDB خارج الحاوية المؤقتة

تحتوي قاعدة البيانات على التمثيل المتزامن لملاحظاتك والحالة المرتبطة بها. اربط أدلة بيانات CouchDB وإعداداته بوحدة تخزين CasaOS دائمة، حتى لا تؤدي إعادة إنشاء الحاوية إلى مسح الواجهة الخلفية للمزامنة.

احتفظ بهذه المجلدات منفصلة عن طبقات Docker المؤقتة العادية.

استخدم بيانات اعتماد فريدة لـ CouchDB

لا تُبقِ على أسماء المستخدمين أو كلمات المرور النموذجية الواردة في البرنامج التعليمي. أنشئ بيانات اعتماد قوية وفريدة لمسؤول CouchDB، واحتفظ بها بعيدًا عن لقطات الشاشة وملفات Compose المشتركة ومنشورات المنتديات العامة.

إذا كُشفت بيانات الاعتماد، فغيّرها وراجع فورًا أي مثيل CouchDB يمكن الوصول إليه عن بُعد.

ينبغي أن تستخدم المزامنة عن بُعد HTTPS

إذا احتاجت أجهزة متعددة إلى المزامنة خارج الشبكة المحلية، فأتح CouchDB عبر مسار HTTPS آمن بدلًا من نشر HTTP غير المشفر مباشرةً على الإنترنت. تتضمن وثائق المشروع الأساسية أمثلة على الوكيل العكسي وإعداد النطاق.

تُعد شبكة VPN أو الشبكة المتراكبة خيارًا آخر عندما تحتاج أجهزتك الخاصة فقط إلى الوصول.

يجب أن تتوافق إعدادات CORS والمصدر مع سير عمل العميل

قد تمنع إعدادات أمان CouchDB الطلبات الواردة من المتصفح أو عرض الويب حتى عندما يكون الخادم قابلًا للوصول. يهيئ إجراء إعداد Self-hosted LiveSync سلوك CouchDB المطلوب، بدلًا من اعتبار حاوية قاعدة بيانات عامة مكتملة بمجرد فتح المنفذ 5984.

استخدم معرّف الإعداد بحذر

يمكن للإرشادات الحالية للمشروع الأساسي إنشاء معرّف إعداد حتى يستورد جهاز Obsidian آخر إعدادات الاتصال. وقد يحتوي هذا المعرّف على تفاصيل اتصال حساسة.

تعامل معه كسرّ: أرسله فقط إلى جهازك الموثوق، وتجنب نشره في لقطات الشاشة أو سجل المحادثات الذي يمكن للآخرين الوصول إليه.

لا تلغي المزامنة الفورية تعارضات التحرير

قد يؤدي تحرير جهازين للملاحظة نفسها في الوقت ذاته تقريبًا إلى إنشاء تعارضات أو الحاجة إلى التوفيق بين التغييرات. يمنحك الاستضافة الذاتية تحكمًا في الخادم، لكنها لا تحول التحرير الموزع إلى نظام ملفات ذي كاتب واحد.

اختبر سير العمل باستخدام خزنة ملاحظات مؤقتة قبل ترحيل نسختك الوحيدة من الملاحظات المهمة.

المزامنة ليست نسخة احتياطية

إذا حُذفت ملاحظة وانتقلت عملية الحذف إلى جميع العملاء، فقد أدى النظام المتزامن وظيفته. احتفظ بنسخ احتياطية مستقلة ومُدارة الإصدارات من خزنة Obsidian، ومن بيانات CouchDB عند الاقتضاء.

يحمي ذلك من الحذف العرضي، أو أخطاء الإضافات، أو تلف قاعدة البيانات، أو التعديل الجماعي غير المقصود.

المصدر خاص بـ CasaOS

استهدف البرنامج التعليمي التاريخي CasaOS. إذا كان المضيف الآن هو ZimaOS، فاستخدم سير عمل متجر التطبيقات/Compose الحالي ومسارات التخزين الحالية في ZimaOS، بدلًا من افتراض تطابق تخطيط حزمة CasaOS.

الأسئلة الشائعة حول Obsidian LiveSync

هل تحتوي مشاركة المنتدى الأصلية على إعداد Compose الكامل؟

لا. فهي تشير أساسًا إلى برنامج Big Bear التعليمي الخارجي.

ما الواجهة الخلفية التي يوثقها Self-hosted LiveSync حاليًا؟

يستخدم الإعداد الأساسي الحالي CouchDB، ويوفر مسار نشر عبر Docker.

هل تحل المزامنة المستضافة ذاتيًا محل النسخ الاحتياطية؟

لا. احتفظ بنسخة احتياطية مستقلة من الخزنة، لأن عمليات الحذف والتعديلات الخاطئة قد تتزامن أيضًا.