🗒️ تثبيت Joplin Server — مزامنة ملاحظات ذاتية الاستضافة

انشر Joplin Server على Ubuntu بـ Docker — خلفية مزامنة ذاتية الاستضافة لتطبيق تدوين الملاحظات Joplin، تُبقي ملاحظاتك المشفّرة متزامنة عبر الأجهزة دون رسوم اشتراك.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — Joplin Server جاهز بأمر واحد، مع PostgreSQL خلفه.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/joplin-server/joplin-server-ubuntu.sh
chmod +x joplin-server-ubuntu.sh
sudo bash joplin-server-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/joplin-server/joplin-server-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x joplin-server-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم الأمر، يشغّل حاوية قاعدة بيانات PostgreSQL، ثم يطلق Joplin Server على المنفذ 22300 مع تخزين دائم لملاحظاتك ومرفقاتك وحسابات المستخدمين.

sudo bash joplin-server-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح، سجّل الدخول بحساب المسؤول الافتراضي، غيّر كلمة المرور فوراً، ثم وجّه تطبيقات Joplin لسطح المكتب والجوال إلى هذا السيرفر كهدف مزامنة.

http://<your-server-ip>:22300

المنافذ المستخدمة

المنفذالغرض
22300Joplin Server Web UI & Sync API (HTTP)
5432PostgreSQL database (internal)

نظرة عامة

Joplin Server هو خلفية المزامنة الرسمية ذاتية الاستضافة لـJoplin، تطبيق تدوين الملاحظات والمهام المجاني ومفتوح المصدر. بدلاً من الاعتماد على Joplin Cloud أو Dropbox أو OneDrive أو Nextcloud كهدف مزامنة، يمنحك Joplin Server خلفية مخصصة بحسابات مستخدمين وميزات مشاركة ولوحة إدارة عبر الويب — كل ذلك يعمل على بنيتك التحتية الخاصة. تتزامن الملاحظات والدفاتر والوسوم والمرفقات بتشفير من طرف إلى طرف بين كل أجهزتك (سطح المكتب، الجوال، الطرفية) عبر هذا السيرفر، وهو مدعوم بقاعدة بيانات PostgreSQL لتخزين موثوق متعدد المستخدمين.

لماذا تستخدمه

تلغي الاستضافة الذاتية لـJoplin Server تكلفة اشتراك Joplin Cloud المتكررة وتُبقي ملاحظاتك — التي غالباً ما تحتوي كلمات مرور أو بيانات شخصية أو معلومات أعمال — بالكامل على بنية تحتية تتحكم بها بدلاً من خدمة طرف ثالث. على عكس أهداف المزامنة العامة مثل Dropbox أو Nextcloud WebDAV، صُمم Joplin Server خصيصاً لـJoplin: يفهم الدفاتر ومراجعات الملاحظات بشكل أصلي، يدعم عدة حسابات مستخدمين بحصص تخزين فردية، ويتيح مشاركة آمنة للملاحظات والدفاتر بين المستخدمين على نفس السيرفر. للمستخدمين والفرق المهتمين بالخصوصية الذين يريدون تشفير Joplin من طرف إلى طرف دون الثقة بطرف ثالث بالبيانات المشفّرة، الاستضافة الذاتية هي الخيار الطبيعي.

متى تحتاجه

  • تستخدم Joplin عبر عدة أجهزة (سطح المكتب، الهاتف، اللوحي) وتحتاج مزامنة موثوقة دون اشتراك Joplin Cloud الشهري
  • تحتوي ملاحظاتك معلومات حساسة وتريد مزامنة مشفّرة من طرف إلى طرف دون الثقة بخدمة سحابية من طرف ثالث
  • تريد مشاركة ملاحظات أو دفاتر محددة مع أشخاص آخرين مباشرة عبر سيرفر المزامنة
  • تستضيف بالفعل أدوات إنتاجية أخرى ذاتياً وتريد بنية تحتية متسقة ومُدارة ذاتياً للملاحظات
  • تحتاج مزامنة ملاحظات متعددة المستخدمين لفريق صغير، كل عضو بحسابه وتخزينه المستقل
  • تجاوزت أهداف المزامنة العامة مثل Dropbox أو WebDAV، التي لا تدعم ميزات مشاركة Joplin وتعدد المستخدمين

حالات الاستخدام الشائعة

  • مزامنة الملاحظات الشخصية وقوائم المهام واليوميات المشفّرة عبر تطبيقات Joplin لسطح المكتب وAndroid وiOS
  • مشاركة دفتر معين مع فرد من العائلة أو زميل يستخدم أيضاً تطبيق Joplin لسطح المكتب أو الجوال
  • تشغيل قاعدة معرفة مشتركة لفريق صغير بحسابات فردية وحصص تخزين لكل مستخدم
  • استبدال اشتراك مدفوع في Joplin Cloud أو Evernote ببديل ذاتي الاستضافة، خالٍ من الإعلانات، بتخزين غير محدود
  • الحفاظ على أرشيف ملاحظات يعمل بلا اتصال بالكامل ومشفّر من طرف إلى طرف لكنه يتزامن عند توفر الاتصال
  • نسخ احتياطي وتتبع إصدارات لتاريخ الملاحظات عبر تتبع مراجعات Joplin المدمج المخزّن على سيرفرك الخاص

الميزات الرئيسية

  • خلفية مزامنة مصممة خصيصاً لـJoplin بدعم أصلي للدفاتر والوسوم وتاريخ مراجعات الملاحظات
  • دعم متعدد المستخدمين بحسابات فردية وبيانات اعتماد تسجيل دخول وحصص تخزين لكل مستخدم
  • دعم التشفير من طرف إلى طرف — يمكن تشفير الملاحظات على جهاز العميل قبل وصولها للسيرفر مطلقاً
  • مشاركة الملاحظات والدفاتر بين المستخدمين المسجلين على نفس السيرفر بصلاحيات قابلة للتخصيص
  • لوحة إدارة عبر الويب لإدارة المستخدمين ومراقبة استخدام التخزين وضبط إعدادات السيرفر
  • REST API متوافق مع كل عملاء Joplin الرسميين — سطح المكتب (Windows/macOS/Linux) وAndroid وiOS والطرفية
  • تخزين مدعوم بـPostgreSQL لاتساق بيانات موثوق متعدد المستخدمين ومتوافق مع ACID
  • لا حدود لحجم الملفات أو عدد الملاحظات سوى ما يستطيع قرص وقاعدة بيانات سيرفرك التعامل معه

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:22300 وسجّل الدخول ببريد وكلمة مرور المسؤول الافتراضيين الظاهرين في مخرجات الإعداد
  • غيّر كلمة مرور المسؤول الافتراضية فوراً تحت إعدادات المستخدم في لوحة الإدارة
  • أنشئ حسابات مستخدمين إضافية تحت Admin → Users إذا كان عدة أشخاص سيزامنون ملاحظاتهم لهذا السيرفر
  • افتح تطبيق Joplin لسطح المكتب أو الجوال، اذهب إلى Tools/Configuration → Synchronisation، واختر 'Joplin Server' كهدف مزامنة
  • أدخل رابط هذا السيرفر وبريدك وكلمة مرورك في إعدادات مزامنة عميل Joplin، ثم شغّل مزامنة يدوية
  • فعّل التشفير من طرف إلى طرف من إعدادات عميل Joplin إذا أردت تشفير الملاحظات قبل مغادرتها لجهازك
  • كرّر إعداد هدف المزامنة على كل جهاز (سطح المكتب، الهاتف، اللوحي) باستخدام نفس بيانات اعتماد الحساب
  • أعدّ وكيلاً عكسياً مع HTTPS إذا كنت تخطط للمزامنة من خارج شبكتك المحلية

أفضل ممارسات الأمان

  • ضع Joplin Server خلف وكيل عكسي مع HTTPS — يجب ألا تنتقل حركة المزامنة وبيانات تسجيل الدخول عبر HTTP عادي أبداً
  • غيّر كلمة مرور المسؤول الافتراضية فوراً بعد أول تسجيل دخول — هذه أهم خطوة أولى
  • فعّل التشفير من طرف إلى طرف في عميل Joplin حتى تُشفّر الملاحظات قبل الرفع، مما يُبقيها غير قابلة للقراءة حتى من مشغّل السيرفر
  • لا تكشف منفذ قاعدة بيانات PostgreSQL مباشرة للإنترنت أبداً — أبقه على شبكة Docker الداخلية فقط
  • استخدم كلمات مرور قوية وفريدة لكل حساب مستخدم، إذ يعرّض الحساب المخترَق كامل تاريخ ملاحظات ذلك المستخدم
  • حافظ على تحديث صورة Docker الخاصة بـJoplin Server لتلقي تصحيحات الأمان لواجهة المزامنة ولوحة الإدارة
  • قيّد تسجيل المستخدمين الجدد إذا كانت لوحة الإدارة تسمح بذلك، حتى يستطيع الوصول للسيرفر الحسابات التي أنشأتها فقط
  • انسخ مفتاح/كلمة مرور التشفير الرئيسي احتياطياً بشكل منفصل عن السيرفر — فقدانه يقفلك نهائياً عن الملاحظات المشفّرة

المنافذ وإعدادات جدار الحماية

يستمع Joplin Server على المنفذ 22300 للوحة إدارة الويب وREST API الخاص بالمزامنة المستخدم من قبل كل عملاء Joplin. تعمل قاعدة بيانات PostgreSQL على المنفذ 5432 لكنها تبقى داخلية لشبكة Docker ولا تُنشر أبداً للمضيف، لذا لا يمكن الوصول إليها من خارج السيرفر. يجب ألا يُكشف المنفذ 22300 مباشرة للإنترنت دون TLS — ضع Joplin Server خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 بشهادة صالحة، وقيّد الوصول المباشر للمنفذ 22300 في الجدار الناري على الشبكات الموثوقة أو VPN عند الإمكان.

النسخ الاحتياطي والصيانة

  • انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام باستخدام pg_dump — تحتوي كل محتوى الملاحظات والمراجعات وحسابات المستخدمين والبيانات الوصفية
  • انسخ أي حجم تخزين دائم مستخدم لتخزين الملفات/المرفقات إذا كان Joplin Server مضبوطاً لتخزين المرفقات على القرص
  • انسخ ملف docker-compose.yml وإعدادات البيئة احتياطياً حتى يمكن إعادة إنشاء السيرفر بشكل مطابق على مضيف جديد
  • خزّن النسخ الاحتياطية خارج السيرفر على قرص منفصل أو تخزين بعيد، وشفّر ملفات النسخ لأنها قد تحتوي بيانات ملاحظات مفكوكة التشفير
  • اختبر استعادة نسخة احتياطية على سيرفر تجريبي دورياً للتأكد أن نسخة قاعدة البيانات والأحجام تُستعاد بشكل صحيح
  • احتفظ بسجل آمن منفصل لكلمة مرور التشفير من طرف إلى طرف لكل مستخدم — النسخ الاحتياطي للسيرفر وحده لا يستطيع فك تشفير الملاحظات المشفّرة

الأخطاء الشائعة

  • ترك كلمة مرور المسؤول الافتراضية دون تغيير بعد التثبيت، مما يعرّض السيرفر بالكامل لأي شخص يجدها
  • كشف المنفذ 22300 مباشرة للإنترنت دون وكيل عكسي وشهادة TLS
  • نسيان تفعيل التشفير من طرف إلى طرف، مما يترك محتوى الملاحظات قابلاً للقراءة في قاعدة البيانات لأي شخص يملك وصولاً للسيرفر
  • فقدان كلمة مرور التشفير من طرف إلى طرف دون نسخة احتياطية — هذا يقفلك نهائياً عن الملاحظات المشفّرة، حتى كمسؤول السيرفر
  • عدم نسخ قاعدة بيانات PostgreSQL احتياطياً بشكل منفصل، مما يؤدي لفقدان كامل للملاحظات إذا حُذفت الحاوية أو الحجم
  • تشغيل Joplin Server دون أحجام تخزين دائمة، مما يجعل كل الملاحظات تختفي بعد إعادة تشغيل الحاوية أو تحديث الصورة
  • تجاهل حصص التخزين للإعدادات متعددة المستخدمين، مما قد يسمح لدفتر مستخدم واحد بملء قرص السيرفر بأكمله

استكشاف الأخطاء وإصلاحها

  • لا يمكن الوصول للوحة إدارة الويب — تحقق من تشغيل الحاوية، وتأكد أن المنفذ 22300 غير محظور بالجدار الناري، وراجع سجلات الحاوية
  • عميل Joplin لا يستطيع المزامنة — تأكد أن رابط هدف المزامنة والبريد وكلمة المرور المدخلة في العميل تطابق بالضبط السيرفر والحساب
  • تفشل المزامنة بخطأ اتصال قاعدة بيانات — تحقق أن حاوية PostgreSQL سليمة ويمكن الوصول إليها من حاوية Joplin Server على شبكة Docker
  • تظهر الملاحظات مشفّرة أو غير قابلة للقراءة في عميل واحد لكن ليس في الآخرين — عادة يعني هذا أن كلمة مرور التشفير الرئيسية لم تُدخَل بعد على ذلك الجهاز
  • مزامنة بطيئة لمجموعات ملاحظات كبيرة — تحقق من I/O قرص السيرفر وفكّر بزيادة shared_buffers في PostgreSQL لأداء أفضل
  • فشل مشاركة دفتر — تأكد أن كلا المستخدمين حسابان مسجلان على نفس نسخة السيرفر، إذ لا يستطيع Joplin Server مشاركة الدفاتر عبر سيرفرات مختلفة
  • تُظهر لوحة الإدارة أخطاء تخزين — تحقق من المساحة المتوفرة على القرص الداعم لقاعدة بيانات PostgreSQL وتخزين المرفقات

البدائل

Joplin Cloud هو الخيار المُستضاف الرسمي من فريق Joplin، يقدم مزامنة بلا صيانة باشتراك شهري مدفوع مع مشاركة ملاحظات/دفاتر مدمجة. Nextcloud، عند اقترانه بهدف مزامنة Joplin عبر WebDAV، يمكن أن يعمل كخلفية مزامنة عامة إذا كنت تستضيف Nextcloud بالفعل، رغم افتقاره لميزات المشاركة الأصلية وإدارة تعدد المستخدمين الخاصة بـJoplin Server. يعمل Dropbox وOneDrive كأهداف مزامنة بسيطة بدون WebDAV للمستخدم الفردي لكن لا يقدمان مشاركة بين حسابات Joplin ويعتمدان على مزود سحابي من طرف ثالث. للفرق أو المستخدمين المهتمين بالخصوصية الذين يريدون ميزات Joplin الأصلية متعددة المستخدمين على بنية تحتية يتحكمون بها بالكامل، Joplin Server هو الخيار المصمم خصيصاً لذلك.

متى لا تستخدمه

Joplin Server ليس ضرورياً إذا كنت مستخدماً فردياً مرتاحاً لاستخدام Dropbox أو OneDrive أو سيرفر WebDAV تُشغّله بالفعل — تلك تعمل بشكل جيد كأهداف مزامنة بسيطة دون عبء تشغيل سيرفر وقاعدة بيانات مخصصين. إذا كنت تحتاج صيانة سيرفر معدومة ولا تمانع رسوم اشتراك، يتولى Joplin Cloud الرسمي المزامنة والنسخ الاحتياطي والتحديثات نيابة عنك. Joplin Server أيضاً يدعم مزامنة الملاحظات فقط — ليس تخزين ملفات عاماً أو محرر مستندات تعاونياً، لذا إذا كنت تحتاج تحريراً تعاونياً في الوقت الفعلي، فأدوات مثل Notion أو منصة ويكي خيار أنسب.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

هل Joplin Server مجاني للاستخدام؟

نعم. Joplin Server مجاني ومفتوح المصدر. استضافته ذاتياً لا تكلفك سوى ما تدفعه مقابل السيرفر الذي يعمل عليه — لا توجد رسوم اشتراك كما في خدمة Joplin Cloud الرسمية.

هل ما زلت أحصل على تشفير من طرف إلى طرف عند الاستضافة الذاتية؟

نعم. يُفعَّل تشفير Joplin من طرف إلى طرف ويُتحكم به بالكامل من تطبيقات العميل، وليس السيرفر. عند تفعيله، تُشفّر الملاحظات على جهازك قبل رفعها، لذا لا يستطيع حتى مشغّل السيرفر قراءة محتواها — هذا يعمل بنفس الطريقة سواء استخدمت Joplin Cloud أو Joplin Server الخاص بك.

هل يمكنني مشاركة دفاتر مع أشخاص آخرين باستخدام Joplin Server؟

نعم. يدعم Joplin Server مشاركة الملاحظات الفردية والدفاتر الكاملة بين حسابات المستخدمين المسجلة على نفس نسخة السيرفر. يحتاج كلا المستخدمين حساباً على سيرفرك، ويمكن إدارة صلاحيات المشاركة من العميل أو لوحة الإدارة.

ماذا يحدث لملاحظاتي إذا فقدت الوصول للسيرفر؟

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

كيف يختلف Joplin Server عن المزامنة عبر Dropbox أو Nextcloud؟

يعمل Dropbox وNextcloud WebDAV كتخزين ملفات عام يزامن Joplin ملفات بياناته إليه، دون أي وعي بالدفاتر أو المستخدمين أو المشاركة. صُمم Joplin Server خصيصاً لـJoplin: يفهم الملاحظات والدفاتر بشكل أصلي، يدعم عدة حسابات مستخدمين مستقلة بحصص فردية، ويتيح مشاركة مباشرة للملاحظات/الدفاتر بين المستخدمين — لا شيء من هذا تقدمه أهداف المزامنة العامة للملفات.