📝 تثبيت SiYuan — قاعدة المعرفة والملاحظات الكتلية المستقلة على Docker
نشر منصة SiYuan على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لإدارة المعرفة الشخصية (PKM) وتدوين الملاحظات الكتلية مع الروابط ثنائية الاتجاه وقواعد البيانات الشبيهة بـ Notion.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/siyuan/siyuan-ubuntu.sh
chmod +x siyuan-ubuntu.sh
sudo bash siyuan-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/siyuan/siyuan-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x siyuan-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد مساحة العمل الدائم (`./workspace`) وتوليد رمز أمان عشوائي `accessAuthCode` مكون من 12 خانة وتشغيل حاوية SiYuan الرسمية على المنفذ 6806.
sudo bash siyuan-ubuntu.sh
4 تسجيل الدخول وإنشاء أول دفتر ملاحظات
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:6806. اكتب رمز المصادقة accessAuthCode، وأنشئ دفتر ملاحظات جديداً، واستكشف الروابط الكتلية وقواعد البيانات، واربط تطبيقات الحواسيب والهواتف.
http://<your-server-ip>:6806
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 6806 | Web UI (host → container 6806) — guarded by access auth code |
| accessAuthCode | 12-character code, generated — save it or you are locked out |
| ./workspace | All notes as files |
نظرة عامة
تعد SiYuan منصة إدارة معرفة شخصية (PKM) وتدوين ملاحظات متقدمة تضع الخصوصية والتخزين المحلي في المقام الأول. تعمل المنصة عبر المنفذ 6806 وتتم حمايتها برمز مصادقة (`accessAuthCode`)، حيث تحفظ كافة الملاحظات كملفات مفتوحة داخل مجلد مساحة عمل محلي. وتجمع بين قوة الملاحظات الكتلية والروابط ثنائية الاتجاه في Roam Research وLogseq، وقوة قواعد البيانات البصرية (Attribute Views) في Notion، وسرعة تحرير Markdown. وتوفر رسوماً بيانية تفاعلية لشبكة الأفكار، وخرائط ذهنية، وبحثاً شاملاً، واستعلامات SQL، مع مزامنة مشفرة بـ E2EE لجميع الأجهزة.
لماذا تستخدمه
تحتجز منصات الملاحظات السحابية (مثل Notion وEvernote) معرفتك الشخصية داخل خوادم تجارية مغلقة، وتعاني من بطء الاتصال، وتفرض قيوداً على تصدير البيانات. تمنحك الاستضافة الذاتية لـ SiYuan بديلاً يضاهي قوة Notion مع سيادة كاملة بنسبة 100% على بياناتك: تحفظ ملاحظاتك كملفات قياسية بسيرفرك الخاص، بدون أي اشتراكات دورية، مع تحرير فوري وسرعة استجابة مذهلة.
متى تحتاجه
- تبحث عن بديل مفتوح المصدر ومستقل لـ Notion أو Obsidian Sync أو Roam Research يدعم الروابط الكتلية الدقيقة
- تحتاج إلى قاعدة معرفة تحفظ كافة بياناتك محلياً بصيغ ملفات قياسية ومفتوحة دون التقيد بشركة سحابية
- تريد جداول وقواعد بيانات بصرية شبيهة بـ Notion (Attribute Views) مع خصائص مخصصة وفلاتر وترتيب
- تريد روابط ثنائية الاتجاه، ورسوماً بيانية تفاعلية لشبكة الأفكار، وخرائط ذهنية تتولد آلياً من تسلسل العناوين
- تريد مزامنة فورية وسلسة لملاحظاتك عبر مختلف الأجهزة (ويندوز، ماك، لينكس، آيفون، أندرويد) عبر سيرفرك الخاص
من يحتاجه
- الباحثون والأكاديميون وصناع المعرفة لتنظيم المراجع والاقتباسات وتوليف الأفكار المترابطة
- مهندسو البرمجيات ومديرو الأنظمة لتوثيق معمارية الأنظمة وأدلة التشغيل ومقتطفات الأكواد
- الطلاب والدارسون لبناء 'عقل ثانٍ' (Second Brain) طويل الأمد يربط المفاهيم التعليمية
- مديرو المشاريع لتنظيم المهام الأسبوعية وتتبع الأخطاء في جداول وقوائم كانبان بصرية
- أصحاب السيرفرات المنزلية لاستضافة خادم ملاحظات موحد لجميع أجهزة العائلة على Ubuntu
حالات الاستخدام الشائعة
- استضافة خادم ملاحظات مركزي يعمل طوال الوقت ويمكن الوصول إليه من حواسيب العمل والهواتف
- بناء 'عقل ثانٍ' تقني بروابط ثنائية تربط السيرفرات والبرامج والمخططات الشبكية ببعضها
- إدارة مهام العمل ومشاريع التطوير باستخدام لوحات كانبان وجداول بخصائص وتصنيفات مخصصة
- توليد خرائط ذهنية تفاعلية بنقرة زر واحدة من القوائم النقطية والعناوين لتسهيل الحفظ والمراجعة
- البحث المتقدم داخل الملاحظات باستخدام استعلامات SQL المدمجة (مثل `SELECT * FROM blocks...`)
الميزات الرئيسية
- دقة على مستوى الكتل (Block-Level): كل فقرة، أو عنوان، أو عنصر قائمة، أو كود برمجي هو كتلة مستقلة قابلة للربط والتضمين
- قواعد بيانات بصرية شبيهة بـ Notion: إنشاء لوحات كانبان، وجداول، وقوائم مع فلاتر وتصنيفات مرنة
- روابط خلفية ثنائية ورسم بياني: اكتشاف الروابط التلقائي، والإشارات غير المربوطة، وشبكة معرفية ثنائية وثلاثية الأبعاد
- معمارية محلية بالكامل: تخزين الملاحظات كملفات JSON مفتوحة داخل مسار `./workspace` دون أي قيود
- دعم استعلامات SQL: تنفيذ استعلامات SQL مباشرة داخل قاعدة بيانات الملاحظات لاستخراج وتجميع المعلومات
- بطاقات استذكار وتكرار متباعد: تحويل أي كتلة إلى بطاقة استذكار ومراجعة لترسيخ المعلومات
- مزامنة عبر الأجهزة: المزامنة مع تطبيقات الحواسيب والهواتف عبر بروتوكولات WebDAV أو S3 أو الخادم المباشر
- نشر منظم عبر Docker مع ربط مجلد `./workspace` وحماية الوصول عبر معلمة `--accessAuthCode`
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:6806 لعرض واجهة SiYuan
- اكتب رمز المصادقة `accessAuthCode` المكون من 12 خانة والمولد أثناء التثبيت لفتح مساحة العمل
- اضغط على 'New Notebook' في الشريط الجانبي وأنشئ دفتر ملاحظاتك الأول (مثل 'العمل' أو 'الملاحظات الشخصية')
- أنشئ صفحة جديدة واكتب `/` لاستعراض قائمة الأوامر الشاملة (العناوين، الجداول، الأكواد، قواعد البيانات)
- حمّل تطبيق SiYuan للهواتف أو الحواسيب واضبط إعدادات المزامنة مع سيرفرك من Settings ← Sync
- ضع SiYuan خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- احفظ رمز `accessAuthCode` بأمان داخل مدير كلمات المرور الخاص بك (مثل Vaultwarden)
أفضل ممارسات الأمان
- تنبيه أمني حاسم: احفظ دائماً رمز المصادقة `accessAuthCode`؛ فبدون هذا الرمز لن تتمكن من دخول واجهة الويب نهائياً
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي لتأمين تحرير الملاحظات ومزامنتها أثناء النقل
- لا تشغل SiYuan على شبكة عامة دون ضبط رمز مصادقة قوي في معلمة `--accessAuthCode`
- احمِ مجلد مساحة العمل `./workspace` الذي يحتوي على ملفاتك بصلاحيات نظام صارمة بالسيرفر
- فعل كلمة مرور التشفير التام (E2EE) من إعدادات المزامنة السحابية إذا كنت تزامن مع مساحات خارجية
- حدّث صورة الحاوية دورياً للحصول على أحدث التحسينات وميزات الأمان
المنافذ وإعدادات جدار الحماية
يقدم SiYuan واجهة الويب وخادم المزامنة عبر منفذ TCP 6806. يجب السماح بالمنفذ 6806 في جدار الحماية للشبكة المحلية (`ufw allow 6806/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل WebSocket وأبقِ المنفذ 6806 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ كامل مجلد `./workspace` احتياطياً، والذي يحتوي على كافة الدفاتر والكتل والمرفقات وقواعد البيانات
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على رمز الأمان ومسارات التخزين
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد مساحة العمل بحاوية تجريبية للتأكد من استرجاع الملاحظات والروابط بنجاح
الأخطاء الشائعة
- فقدان رمز `accessAuthCode` مما يعطل تسجيل الدخول بالمتصفح (يمكن تعديله في معاملات تشغيل الحاوية)
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
- عدم ربط مجلد التخزين الدائم `./workspace`، مما يسبب فقدان كافة الدفاتر والملاحظات عند تحديث الحاوية
- تعديل ملفات `.sy` البرمجية الداخلية يدوياً أثناء تشغيل الحاوية دون إيقاف البرنامج أولاً
- كشف المنفذ 6806 للإنترنت العام مباشرة دون تشفير الوكيل العكسي
استكشاف الأخطاء وإصلاحها
- الواجهة تطلب رمز الدخول وترفض كلمة المرور — راجع القيمة الدقيقة لـ `--accessAuthCode` في ملف `docker-compose.yml`
- واجهة الويب لا تفتح على المنفذ 6806 — افحص سجلات الحاوية بالأمر: `docker logs siyuan -f`
- فشل مزامنة تطبيق الحواسيب — تأكد من أن الرابط في الإعدادات يبدأ بـ `https://` وصحة رمز الأمان
- خطأ في صلاحيات كتابة الملاحظات — اضبط ملكية المجلد بالأمر: `chown -R 1000:1000 ./workspace`
- الرسم البياني للأفكار لا يظهر — تأكد من تفعيل ميزة تسريع العتاد WebGL في متصفحك
البدائل
تطبيق Obsidian للملاحظات بـ Markdown. أداة Logseq مفتوحة المصدر للملاحظات الكتلية. منصة Notion السحابية التجارية. منصة BookStack للتوثيقات والويكي. تطبيق Joplin المفتوح المصدر.
متى لا تستخدمه
تجنب استخدام SiYuan إذا كنت تبحث خصيصاً عن منصة توثيق وويكي عامة للشركات تتيح التصفح المجاني للقراء والزوار كصفحات توثيق مفتوحة (حيث صُممت BookStack أو Wiki.js لتوثيقات الشركات العامة). وإذا كنت تريد فقط مجلد نصوص Markdown بسيطاً جداً بدون معرّفات الكتل وقواعد البيانات، فإن Obsidian أخف كخيار محلي.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو رمز accessAuthCode في SiYuan؟
رمز `accessAuthCode` هو كلمة المرور الأمنية الرئيسية (تُمرر عبر `--accessAuthCode`) التي تحمي واجهة SiYuan وخادم المزامنة من وصول المتطفلين، ويجب إدخالها عند تسجيل الدخول من أي متصفح.
كيف يحفظ SiYuan الملاحظات والمستندات؟
يحفظ SiYuan الملاحظات كملفات قياسية بصيغة `.sy` داخل مجلد `./workspace/data`، حيث يتم التعامل مع كل فقرة وعنوان وجدول ككتلة بيانات مستقلة تمتلك معرّف ID فريداً.
هل يمكن ربط تطبيقات الهواتف والحواسيب بهذا السيرفر؟
نعم! في تطبيق SiYuan الرسمي للحواسيب والهواتف (أندرويد وآيفون)، انتقل إلى الإعدادات ← المزامنة، واختر 'SiYuan Kernel' واكتب رابط سيرفرك ورمز الـ accessAuthCode لتتم مزامنة الملاحظات فورياً.
هل يدعم SiYuan قواعد البيانات والجداول المتقدمة مثل Notion؟
نعم! يتضمن SiYuan ميزة 'Attribute Views' التي توفر جداول بصرية متطورة ولوحات كانبان وقوائم بخصائص مخصصة (نصوص، تواريخ، أرقام، علاقات) مع إمكانيات الفلترة والترتيب.
كم يستهلك SiYuan من الذاكرة العشوائية (RAM)؟
تم تطوير SiYuan بلغات Go وTypeScript وهو خفيف جداً، حيث يستهلك عادة ما بين 60 إلى 150 ميجابايت فقط من الذاكرة العشوائية داخل Docker.