حلّ المجتمع

Obsidian على ZimaOS: إصلاح عمليات تحميل الخزائن ومشكلات HTTPS

A ZimaBlade user reverse-proxied the browser-based Obsidian app but could not see a mounted vault and later found Selkies opening without Obsidian itself.

الخلاصة: إذا كان هدفك إنشاء خزنة Obsidian، فلا تبدأ بتشغيل واجهة Obsidian المكتبية داخل حاوية متصفح

جمع إعداد عام 2025 بين Obsidian من LinuxServer وSelkies ووكيل عكسي وخزنة مركّبة. قد ينجح ذلك، لكنه يضيف أربع طبقات منفصلة من الأعطال قبل أن تعدّل ملاحظة واحدة: أمان المتصفح، وWebSocket/‏HTTPS، وربط وحدات تخزين الحاوية، وعملية Obsidian المكتبية. في عام 2026، يوفّر ZimaSpace الآن OZSync for Obsidian تحديدًا للنسخ الاحتياطي والوصول السحابي والمزامنة بين الأجهزة، وهو مسار أول أفضل عندما يكون الهدف الحقيقي هو «الاحتفاظ بخزنـتي على ZimaOS».

تدرج OZSync for Obsidian ضمن منظومة إضافات ZimaOS.

اختر البنية قبل إصلاح الحاوية

هناك ثلاثة نماذج عملية:

  • مزامنة خزنة محلية عادية: يعمل Obsidian أصليًا على جهاز Mac أو الكمبيوتر الشخصي، بينما تحافظ طبقة مزامنة على الخزنة في ZimaOS.
  • فتح خزنة عبر نظام ملفات مركّب: يشير التطبيق المكتبي إلى مشاركة مركّبة، مع مراعاة مشكلات زمن الاستجابة والعمل دون اتصال المعتادة.
  • تشغيل Obsidian نفسه داخل حاوية متصفح: تبث LinuxServer/Selkies الواجهة الرسومية عن بُعد. وهذا هو الخيار الأكثر تعقيدًا.

إذا اخترت حاوية المتصفح فقط لأنك ظننت أنها مطلوبة لتخزين ZimaOS، فبسّط الإعداد أولًا.

إذا أبقيت على الحاوية، فتحقق من مساري المضيف والحاوية كلٌّ على حدة

عندما «لا تظهر» الخزنة مطلقًا، افحص ربط وحدة تخزين Docker بدلًا من واجهة Obsidian:

# مثال
/media/Notes/MyVault  ->  /vaults/MyVault

لا يستطيع Obsidian داخل الحاوية رؤية سوى المسار الموجود على اليمين. بينما يعرض ZimaOS Files المسار الموجود على اليسار. توضّح مسارات تطبيقات ZimaOS هذا الحد الفاصل، في حين تحدد عمليات ربط Docker سلوك التشغيل.

أصلح HTTPS قبل تصحيح أخطاء Selkies

قد تعتمد حاويات سطح المكتب التي تبث عبر المتصفح على واجهات برمجة تطبيقات آمنة في المتصفح وعلى اتصال WebSocket. إذا كان التطبيق يرفض في البداية «الوصول غير الآمن»، فقد كان توجيه الوكيل العكسي إلى HTTPS حلًا منطقيًا. لكن اختبر نقطة نهاية الوكيل قبل إضافة ربط الخزنة. فعمل صفحة Selkies الأساسية لا يثبت أن عملية Obsidian أو مسار WebSocket الخاص بها يعملان بصورة سليمة.

يوفّر توجيه ZimaOS عبر HTTPS نموذج الوكيل العكسي في ZimaOS.

عندما تفتح Selkies ولا يفتح Obsidian

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

docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVault

تنشر LinuxServer حاليًا Obsidian بوصفه حاوية يمكن الوصول إليها عبر الويب، لكن صورها لا تزال تعتمد على ضبط الأذونات الصحيحة لـ /config ووحدات تخزين المضيف. وتُعد حاوية Obsidian من LinuxServer المصدر الأساسي.

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

خزنة Obsidian هي في الأساس مجلد يضم ملفات Markdown وإعدادات .obsidian. خزّن هذا المجلد على وحدة تخزين بيانات عادية في ZimaOS، وأنشئ له نسخة احتياطية مستقلة. إذا تعطلت حاوية البث، فينبغي أن تظل ملاحظاتك قابلة للقراءة باستخدام أي محرر نصوص.

يتناول كل من النسخ الاحتياطي في ZimaOS ومتطلبات تطبيقات ZimaOS الاسترداد وتحديد الموارد.

استورد خزنة موجودة من دون إعادة إنشائها

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

استخدم المزامنة بدلًا من سطح مكتب المتصفح عند التحرير من أجهزة متعددة

بالنسبة إلى أجهزة الكمبيوتر المحمولة والهواتف، تحافظ البنية القائمة على المزامنة على تجربة Obsidian محلية وسريعة الاستجابة في كل جهاز. كما تقلل الاعتماد على جلسة متصفح بعيدة، وتتيح تدوين الملاحظات دون اتصال. استخدم أسلوب حاوية المتصفح عندما يكون الوصول المركزي إلى الواجهة الرسومية هو ما تريده تحديدًا، لا لمجرد أن البيانات موجودة على NAS.

الأسئلة الشائعة

لماذا لا تظهر خزنة Obsidian المركّبة؟

السبب الأكثر شيوعًا من جهة الحاوية هو عدم تطابق مسار وحدة التخزين. تحقق من مسار المضيف ومسار الحاوية والأذونات قبل تغيير إعدادات Obsidian.

هل يحتاج Obsidian إلى HTTPS على ZimaOS؟

لا يحتاج Obsidian المكتبي الأصلي إلى أن تعرض واجهة الويب في NAS المحرر. أما حاوية Selkies التي تبث عبر المتصفح فقد تتطلب HTTPS أو سلوك WebSocket آمنًا مضبوطًا بصورة صحيحة.

هل ينبغي أن أخزّن الخزنة على SMB؟

قد ينجح ذلك، لكن الخزنة المحلية مع المزامنة تكون عمومًا أسهل للاستخدام دون اتصال وأقل حساسية لانقطاعات الشبكة.

هل يمكنني نسخ خزنة Markdown موجودة مباشرةً؟

نعم. الخزنة مجلد من الملفات. انسخ الدليل بأكمله، بما في ذلك .obsidian إذا كنت تريد الإضافات والإعدادات، ثم وجّه نسخة Obsidian المختارة إلى ذلك المسار.

ما أبسط إعداد لـ Obsidian على ZimaOS الآن؟

إذا كان الهدف هو مزامنة الخزنة بين الأجهزة، فابدأ بتقييم تكامل OZSync الحالي بدلًا من إنشاء منظومة سطح مكتب كاملة داخل المتصفح.