📝 تثبيت Trilium Notes — قاعدة المعرفة الهرمية والملاحظات الشخصية على Docker

نشر منصة Trilium Notes على Ubuntu باستخدام Docker — تطبيق تدوين الملاحظات وبناء قواعد المعرفة الهرمية مفتوح المصدر مع ميزة استنساخ الملاحظات والمزامنة على المنفذ 8080.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Trilium Notes على المنفذ 8080 مع قاعدة بيانات SQLite المدمجة والمزامنة المكتبية جاهزة.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/trilium/trilium-ubuntu.sh
chmod +x trilium-ubuntu.sh
sudo bash trilium-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/trilium/trilium-ubuntu.sh

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

chmod +x trilium-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للبيانات والملاحظات (`./trilium-data`) وضبط الصلاحيات وتشغيل Trilium Notes على المنفذ 8080.

sudo bash trilium-ubuntu.sh

4 تهيئة قاعدة المعرفة وضبط المزامنة

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8080. أكمل معالج الإعداد الأولي، وأنشئ كلمة المرور الرئيسية، وابدأ بناء شجرة معرفتك الهرمية أو اربط المزامنة مع البرامج المكتبية.

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

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

المنفذالغرض
8080Trilium Web UI + Sync Server API

نظرة عامة

تعد Trilium Notes منصة هرمية مفتوحة المصدر لتدوين الملاحظات وبناء قواعد المعرفة والويكي الشخصي (Personal Knowledge Base) مصممة خصيصاً للمطورين والباحثين ومحترفي التوثيق. تعمل المنصة عبر المنفذ 8080، وتتميز بهيكل شجري لانهائي التفرع، وميزة استنساخ الملاحظات (Note Cloning) التي تتيح وضع الملاحظة الواحدة في عدة مجلدات دون تكرارها، ومحرر نصوص غني ومرئي، ودعم الأكواد البرمجية، وخرائط الروابط والعلاقات البصرية، وتشفير الملاحظات الحساسة، والمزامنة الثنائية مع برامج سطح المكتب.

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

تعجز تطبيقات الملاحظات البسيطة (مثل Apple Notes وKeep) عن تنظيم الأبحاث التقنية المعقدة، بينما تحتجز التطبيقات السحابية التجارية (مثل Notion وEvernote) ملاحظاتك الخاصة خلف جدران سحابية مغلقة واشتراكات شهرية. تمنحك Trilium Notes عقلاً ثانياً آمناً ومستضافاً ذاتياً: نظم آلاف الملاحظات في شجرة هرمية لانهائية، ونفذ سكريبتات الأتمتة البرمجية، وشفر ملاحظاتك الحساسة، مع ملكية كاملة لبياناتك بنسبة 100%.

متى تحتاجه

  • تحتاج لقاعدة معرفة هرمية منظمة بعمق لانهائي لتوثيق الأبحاث والأنظمة التقنية المعقدة
  • تريد ميزة 'استنساخ الملاحظات' (Note Cloning) لعرض نفس الملاحظة المرجعية في عدة تصنيفات في نفس الوقت
  • تريد تخزيناً آمناً وخاصاً 100% لملاحظاتك وأكوادك البرمجية دون رفعها لسحابات خارجية
  • تريد مزامنة ثنائية كاملة بين سيرفرك الخاص وتطبيقات سطح المكتب على أجهزة Windows وmacOS ولينكس
  • تحتاج لتشفير الملاحظات الحساسة بكلمة مرور خاصة لحماية كلمات السر والمفاتيح البرمجية

من يحتاجه

  • مشاريع ومطورو البرمجيات ومديرو الأنظمة لتوثيق معمارية السيرفرات والأوامر التقنية والأكواد
  • الباحثون والأكاديميون والطلاب لتنظيم أبحاث التخرج والمراجع العلمية والخرائط المفاهيمية
  • أصحاب السيرفرات المنزلية لاستضافة ويكي شخصي وتوثيق شامل لإعدادات الشبكة والسيرفر
  • المستخدمون المتقدمون لبناء أنظمة إدارة علاقات شخصية وتتبع العادات عبر سكريبتات جافاسكريبت
  • الكتاب والمؤلفون لتنظيم مسودات الكتب والروايات في فصول ومجلدات متفرعة

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

  • بناء ويكي شامل لتوثيق البنية التحتية للسيرفرات وعناوين الـ IP وأوامر Docker وإجراءات النسخ الاحتياطي
  • استنساخ ملاحظة مرجعية لأوامر Docker لتظهر داخل مجلد '#Linux' ومجلد '#DevOps' معاً بتعديل متزامن
  • كتابة سكريبت جافاسكريبت مدمج ينشئ تلقائياً قالباً يومياً للمذكرات كل صباح
  • حماية ملاحظة تحتوي على مفاتيح التعافي بكلمة مرور مشفرة بخوارزمية AES-256 القوية
  • استكشاف الروابط والعلاقات بين المفاهيم البحثية عبر الخريطة البصرية التفاعلية في Trilium

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

  • هيكل شجري هرمي لانهائي على المنفذ 8080: تنظيم متفرع ومفتوح للملاحظات مع دعم السحب والإفلات
  • استنساخ الملاحظات (Cloning): وضع نفس الملاحظة في عدة فروع شجرية مع تعديل متزامن حي
  • أنواع محتوى متعددة: ملاحظات نصية، وأكواد برمجية ملونة، وخرائط ذهنية، ومخططات Mermaid
  • أتمتة برمجية بـ JavaScript: تشغيل سكريبتات مخصصة لأتمتة المهام وبناء ودجات تفاعلية
  • مزامنة مكتبية ثنائية: توافق كامل مع برامج سطح المكتب لأنظمة ويندوز وماك ولينكس للعمل بدون إنترنت
  • تشفير الملاحظات الفردية: حماية الملاحظات الحساسة والشجرات الفرعية بتشفير AES-256 بكلمة مرور
  • خرائط الروابط والعلاقات: مخططات بصرية تفاعلية توضح العلاقات والروابط بين مواضيعك وملاحظاتك
  • معمارية Docker Compose تجمع Trilium مع ربط مجلد `./trilium-data` لقاعدة بيانات SQLite والملفات المرفقة

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8080 لعرض معالج إعداد Trilium
  • اختر 'I am a new user' ثم اختر 'I want to create a new Trilium document for my notes'
  • أنشئ كلمة المرور الرئيسية الآمنة لحسابك
  • استكشف الشجرة التجريبية للتعرف على ميزات السمات (Attributes) والاستنساخ والخرائط
  • حمل برنامج Trilium المكتبي على حاسوبك واربطه بالسيرفر عبر الرابط `http://ip-سيرفرك:8080` للمزامنة
  • ضع Trilium خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد البيانات `./trilium-data`

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

  • تنبيه أمني حاسم: عيّن كلمة مرور رئيسية قوية ومعقدة أثناء معالج التثبيت الأولي
  • استخدم تشفير HTTPS دائماً في الإنتاج؛ فملاحظاتك الشخصية تحتوي على أفكارك ومعلوماتك الخاصة
  • استخدم ميزة تشفير الملاحظات للمعلومات شديدة الحساسية كالمفاتيح البرمجية
  • لا تكشف المنفذ 8080 للإنترنت العام مباشرة دون حماية وكيل عكسي مشفر
  • احمِ مجلد البيانات `./trilium-data` الذي يحتوي على ملف `document.db` بصلاحيات نظام صارمة
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يعمل Trilium Notes عبر منفذ TCP 8080 (للوحة الويب والمزامنة المكتبية). اسمح بالمنفذ 8080 في جدار الحماية للشبكة المحلية (`ufw allow 8080/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8080، مع إبقاء المنفذ 8080 مغلقاً خارجياً.

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

  • انسخ مجلد `./trilium-data` احتياطياً، والذي يحتوي على ملف `document.db` (قاعدة بيانات SQLite بكافة الملاحظات والصور والتعديلات)
  • ينشئ Trilium تلقائياً نسخاً احتياطية يومية داخل مجلد `./trilium-data/backup/`؛ تأكد من حفظها في مكان آمن
  • انسخ ملف `config.ini` الذي يحتوي على إعدادات المنافذ والشهادات
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بنسخ ملف `document.db` لحاوية تجريبية للتأكد من فتح الملاحظات والشجرات بنجاح

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

  • نسيان كلمة المرور الرئيسية (تعتمد Trilium على التشفير المحلي ولا توجد إمكانية لاسترجاع كلمة المرور بالبريد)
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر مما يعرض كلمات المرور والملاحظات للتنصت
  • عدم ربط مجلد التخزين الدائم `./trilium-data`، مما يسبب فقدان كامل قاعدة المعرفة عند تحديث الحاوية
  • كشف المنفذ 8080 للإنترنت العام مباشرة دون تأمين
  • محاولة تعديل ملف `document.db` بأدوات SQLite خارجية أثناء عمل حاوية Trilium مما يتسبب في تلف القاعدة

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

  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs trilium -f`
  • خطأ في صلاحيات كتابة قاعدة البيانات — اضبط ملكية المجلد بالأمر: `chown -R 1000:1000 ./trilium-data`
  • فشل المزامنة من التطبيق المكتبي — تأكد من احتواء الرابط على `https://` ووجود شهادة SSL صالحة بالسيرفر
  • تلف قاعدة البيانات — استرجع أحدث نسخة احتياطية آلية من مجلد `./trilium-data/backup/`
  • بطء فتح الملاحظات — تتعامل المنصة بسلاسة مع أكثر من 50,000 ملاحظة، لكن تجنب تضمين صور غير مضغوطة بحجم ضخم

البدائل

تطبيق Obsidian للملاحظات النصية بصيغة Markdown. تطبيق Logseq للخرائط المعرفية. منصة Notion التجارية السحابية. تطبيق Joplin للملاحظات والمزامنة. منصة SilverBullet للويكي الشخصي.

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

تجنب استخدام Trilium Notes إذا كنت تريد حفظ ملاحظاتك كملفات Markdown نصية مفردة على القرص الصلب (حيث صُممت Obsidian أو Logseq للملفات النصية الصريحة). وإذا كنت تبحث عن منصة توثيق جماعية لفرق العمل مع تعديل متزامن، فإن BookStack أو Outline أفضل للفرق.

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

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

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

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

ما هي منصة Trilium Notes وما الذي يميزها عن غيرها؟

Trilium Notes منصة هرمية لتدوين الملاحظات وبناء قواعد المعرفة. وتتميز بهيكلها الشجري لانهائي التفرع، وإمكانية استنساخ الملاحظات لتتواجد في عدة أماكن متزامنة، وتنفيذ سكريبتات جافاسكريبت، وتشفير الملاحظات بخوارزمية AES-256.

هل يمكن مزامنة Trilium Notes مع الكمبيوتر الشخصي؟

نعم! توفر Trilium تطبيقات مكتبية رسمية لأنظمة ويندوز وماك ولينكس. يمكنك ربط البرنامج المكتبي بسيرفرك الخاص للمزامنة والعمل أوفلاين بدون إنترنت.

ما نوع قاعدة البيانات التي تستخدمها Trilium Notes؟

تستخدم Trilium Notes ملف قاعدة بيانات SQLite مدمج واحد (`document.db`) داخل مجلد `./trilium-data`، مما يجعل عمليات النسخ الاحتياطي والترحيل في غاية السهولة بنسخ مجلد واحد.

هل يتوفر تطبيق للهواتف الذكية لـ Trilium Notes؟

تتضمن المنصة واجهة ويب مخصصة للهواتف الذكية تعمل تلقائياً وبسلاسة فور فتح رابط السيرفر من متصفح سفاري أو كروم على هاتفك.

كم تستهلك Trilium Notes من الذاكرة العشوائية (RAM)؟

تم بناء Trilium بـ Node.js وهي فائقة الكفاءة، حيث تستهلك عادة ما بين 100 إلى 250 ميجابايت فقط من الذاكرة العشوائية داخل Docker.