🛠️ تثبيت AFFiNE — مستندات ولوحات بيضاء وقواعد بيانات في مكان واحد
انشر AFFiNE على Ubuntu بـ Docker وPostgreSQL وRedis — مساحة عمل ذاتية الاستضافة تدمج مستندات بأسلوب Notion، ولوحة رسم بأسلوب Miro، وقواعد بيانات، على المنفذ 3040.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/affine/affine-ubuntu.sh
chmod +x affine-ubuntu.sh
sudo bash affine-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/affine/affine-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x affine-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، يولّد كلمة مرور قاعدة بيانات من 24 حرفاً، يُشغّل حاوية ترحيل لمرة واحدة، ثم يُشغّل AFFiNE مع PostgreSQL 16 وRedis 7 على المنفذ 3040.
sudo bash affine-ubuntu.sh
4 تسجيل حساب المشرف
افتح AFFiNE وسجّل — الحساب الأول الذي تسجّله يصبح مشرف السيرفر:
http://<your-server-ip>:3040
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3040 | Web app (host → container 3010) — first account is admin |
| internal | PostgreSQL 16 + Redis 7 (not published) |
| ./storage | Uploaded files and attachments (also ./db and ./config) |
نظرة عامة
AFFiNE مساحة عمل مفتوحة المصدر وشاملة تدمج محرر مستندات كتلي بأسلوب Notion، ولوحة رسم لا نهائية بأسلوب Miro، وقواعد بيانات خفيفة في تطبيق واحد، مبني على إطار عمل التحرير BlockSuite. الفكرة المحورية هي أن الصفحة ليست أداتين منفصلتين مُلصقتين معاً — يمكن عرض نفس الكتل وتحريرها كمستند خطي منظّم أو تحويلها فوراً إلى لوحة حرة حيث تصبح بطاقات ومخططات وملاحظات لاصقة قابلة للترتيب بحرية. استضافته ذاتياً بـ Docker Compose تُشغّل سيرفر AFFiNE إلى جانب PostgreSQL للتخزين وRedis للتخزين المؤقت والمهام الخلفية، ما يمنحك بديلاً خاصاً لنظيرَي Notion وMiro السحابيين المدفوعَين بالاشتراك.
لماذا تستخدمه
Notion وMiro أداتان ممتازتان كلٌّ على حدة، لكن إبقاء الملاحظات المنظمة في أداة والعصف الذهني الحر في أداة أخرى يعني نسخ المحتوى ذهاباً وإياباً بينهما باستمرار. يُزيل AFFiNE هذا الاحتكاك بجعل المستندات واللوحات البيضاء عرضين لنفس الكتل الأساسية بالضبط، بحيث يصبح مستند اجتماع خريطة ذهنية بنقرة واحدة والعكس دون فقدان التنسيق أو المحتوى. الاستضافة الذاتية تعني أن ملاحظاتك ومخططاتك وقواعد بياناتك الداخلية تعيش على نسخة PostgreSQL خاصة بك بدلاً من سحابة طرف ثالث، دون اشتراك لكل مقعد ودون اعتماد على استمرار وجود شركة لإبقاء مساحة عملك متاحة.
متى تحتاجه
- تريد أداة واحدة تتعامل مع المستندات المنظمة ورسم اللوحات البيضاء الحر دون التنقل بين تطبيقات
- سئمت من نسخ المحتوى يدوياً بين تطبيق ملاحظات مثل Notion وأداة لوحة بيضاء مثل Miro
- تريد أن تعيش قاعدة معرفة فريقك وملاحظات الاجتماعات والمخططات على بنية تحتية تتحكم بها
- تحتاج تحريراً تعاونياً فورياً لفريق صغير دون دفع تسعير SaaS لكل مقعد
- تريد قواعد بيانات خفيفة (جداول بعروض متعددة) مدمجة مباشرة داخل مستنداتك بدلاً من أداة جداول بيانات منفصلة
- أنت مرتاح لتشغيل وصيانة مكدّس Docker مدعوم بـ PostgreSQL وRedis مقابل الموثوقية التي يمنحها
من يحتاجه
- الفرق الصغيرة والشركات الناشئة التي تريد بديلاً عن Notion وMiro دون اشتراكين منفصلين
- فرق المنتج والتصميم التي تنتقل بسلاسة بين المواصفات المكتوبة والعصف الذهني البصري أو الرسم التخطيطي
- الأفراد والمؤسسات المهتمة بالخصوصية التي لا تريد تخزين الملاحظات والمستندات الداخلية على سحابة طرف ثالث
- عشاق الاستضافة الذاتية الذين يبنون قاعدة معرفة شخصية إلى جانب خدمات مختبرهم المنزلي الأخرى
- المعلمون والطلاب الذين يريدون أداة مدمجة لتدوين الملاحظات ورسم الخرائط الذهنية لتنظيم المقررات الدراسية
- المؤسسات التي تفضّل مفتوح المصدر أولاً وتفضّل أدوات ذاتية الاستضافة وقابلة للتدقيق على SaaS تجاري مغلق
حالات الاستخدام الشائعة
- تدوين ملاحظات اجتماع منظمة كمستند، ثم التحويل لوضع اللوحة الحرة لرسم مخطط عملية ذي صلة في نفس الصفحة
- بناء متتبع مشروع خفيف باستخدام كتل قاعدة بيانات AFFiNE المدمجة بدلاً من جدول بيانات منفصل أو قاعدة بيانات Notion
- إجراء جلسات عصف ذهني تعاونية على لوحة لا نهائية بملاحظات لاصقة وأشكال ومستندات مدمجة
- الحفاظ على قاعدة معرفة شخصية أو جماعية من مستندات طويلة بصفحات متداخلة وروابط عكسية
- رسم إطار عمل أو مخطط انسيابي تقريبي مباشرة بجانب المواصفات المكتوبة التي يوثّقها، في نفس مساحة العمل
- مشاركة رابط للقراءة فقط أو قابل للتحرير لصفحة أو لوحة معينة مع متعاونين خارج الفريق الأساسي
الميزات الرئيسية
- تحرير موحّد للمستندات واللوحات البيضاء — نفس المحتوى قابل للعرض كصفحة خطية أو لوحة لا نهائية حرة
- مبني على BlockSuite، إطار تحرير قائم على CRDT يدعم التعاون الفوري متعدد المستخدمين جاهزاً من الصندوق
- قواعد بيانات خفيفة مدمجة بعروض متعددة (جدول، كانبان) مباشرة داخل المستندات
- صفحات متداخلة، وروابط عكسية، وبحث نصي كامل عبر مساحة العمل بأكملها
- أنواع كتل غنية — نص وصور وتضمينات وكتل كود وقوائم مهام — قابلة للاستخدام في وضعَي المستند واللوحة
- ضوابط إدارة ذاتية الاستضافة، حيث يصبح الحساب الأول المُسجَّل مشرف السيرفر تلقائياً
- تخزين مدعوم بـ PostgreSQL مع دعم فهرسة شبيهة بـ pgvector وRedis للتخزين المؤقت ومعالجة المهام الخلفية
- رابط خارجي قابل للتكوين بحيث تُحلّ روابط المشاركة وعناوين الأصول بشكل صحيح خلف نطاق مخصص ووكيل عكسي
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:3040 فوراً وسجّل الحساب الأول — يصبح مشرف السيرفر تلقائياً
- أنشئ مساحة عملك الأولى وقرّر اصطلاح تسمية/تنظيم للصفحات قبل أن يبدأ فريقك بإضافة محتوى
- جرّب تحويل مستند بين وضع الصفحة ووضع اللوحة الحرة لتكوين فكرة عن كيفية انتقال الكتل بين العرضين
- ادعُ أعضاء الفريق لمساحة العمل واضبط الصلاحيات المناسبة بمجرد تهيئة إدارة المستخدمين
- اضبط AFFINE_SERVER_EXTERNAL_URL على رابطك العام الحقيقي إذا كنت تضع AFFiNE خلف نطاق ووكيل عكسي — روابط المشاركة تعتمد عليه
- أعدّ وكيلاً عكسياً بـ HTTPS (Nginx Proxy Manager أو ما شابه) قبل الاعتماد على AFFiNE لأي شيء أبعد من اختبار محلي
- انسخ أحجام ./db و./storage و./config احتياطياً قبل إجراء أي تغيير إعداد كبير
- تحقق دورياً من إصدارات AFFiNE الجديدة وحدّث صورة Docker للحصول على إصلاحات الأخطاء وميزات محرر BlockSuite الجديدة
أفضل ممارسات الأمان
- سجّل حساب المشرف فور التثبيت مباشرة — إلى أن يفعل أحد ذلك، تبقى النسخة غير مُطالَب بها فعلياً
- لا تكشف المنفذ 3040 مباشرة للإنترنت العام دون وكيل عكسي يوفر HTTPS
- اضبط AFFINE_SERVER_EXTERNAL_URL بشكل صحيح بمجرد وضعه خلف نطاق، فعدم التطابق قد يُسرّب عناوين داخلية في الروابط المُولَّدة
- أبقِ PostgreSQL وRedis غير منشورَين على المضيف — يجب أن يكونا قابلَين للوصول فقط من حاوية AFFiNE عبر شبكة Docker الداخلية
- استخدم كلمة مرور قاعدة بيانات قوية ومُولَّدة عشوائياً بدلاً من كلمة افتراضية أو بسيطة
- قيّد روابط دعوة مساحة العمل وصلاحيات المشاركة لتجنب كشف مستندات خاصة للعامة عن غير قصد
- حافظ على تحديث صور Docker، فـ AFFiNE وBlockSuite يُطوَّران بنشاط بإصدارات متكررة
- انسخ دليل الإعدادات احتياطياً بأمان، فقد يحتوي على قيم إعداد سيرفر حساسة
المنافذ وإعدادات جدار الحماية
يُنشَر تطبيق AFFiNE على المنفذ 3040 على المضيف، المُعيَّن من المنفذ الداخلي 3010 في الحاوية — تصفّح دائماً إلى 3040، وليس 3010. يعمل PostgreSQL وRedis كخدمات داخلية على شبكة Docker ولا يُنشَران على المضيف افتراضياً، لذا لا يحتاجان قواعد جدار حماية خاصة بهما طالما لم تكشفهما يدوياً. للوصول عن بُعد، ضع المنفذ 3040 خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة بدلاً من فتحه مباشرة، واحجب الوصول الوارد المباشر للمنفذ 3040 في الجدار الناري باستثناء وكيلك العكسي أو VPN.
النسخ الاحتياطي والصيانة
- انسخ حجم ./db احتياطياً — إنه دليل بيانات PostgreSQL الذي يحمل كل مستند ولوحة وسجل قاعدة بيانات
- انسخ حجم ./storage احتياطياً، الذي يحمل الملفات المرفوعة والصور والمرفقات الأخرى المُشار إليها في مستنداتك
- انسخ دليل ./config احتياطياً، الذي يحمل إعداد السيرفر بما فيه الرابط الخارجي وإعدادات التشغيل الأخرى
- انسخ docker-compose.yml وأي ملف .env احتياطياً حتى يمكن إعادة إنشاء إعداد الحاويات المتعددة الدقيق (التطبيق وPostgreSQL وRedis)
- احفظ النسخ الاحتياطية خارج السيرفر واختبرها دورياً، فقد تنمو مساحة العمل لتصبح مستودع معرفة الفريق الأساسي
- قبل ترقيات إصدار AFFiNE الكبرى، خذ نسخة احتياطية جديدة — ترحيلات المخطط تعمل تلقائياً ويجب أن يكون لها مسار تراجع
الأخطاء الشائعة
- تأخير تسجيل الحساب الأول، ما يترك فترة قصيرة يمكن فيها لأي شخص يصل للرابط الاستيلاء على دور المشرف
- الخلط بين منفذ المضيف (3040) والمنفذ الداخلي للحاوية (3010) عند إعداد وكيل عكسي أو قاعدة جدار حماية
- نسيان تحديث AFFINE_SERVER_EXTERNAL_URL بعد نقل AFFiNE خلف نطاق حقيقي، ما يُعطّل روابط المشاركة وعناوين الأصول
- كشف منافذ PostgreSQL أو Redis للمضيف أو الإنترنت رغم أنها مخصصة للوصول الداخلي فقط من حاوية AFFiNE
- تخطي النسخ الاحتياطي المنتظم لـ ./db و./storage و./config، ومعاملة مساحة العمل كشيء قابل للاستغناء عنه رغم أنها تصبح بنية تحتية أساسية للفريق
- تشغيل صورة Docker قديمة لأشهر دون التحقق من التحديثات، وتفويت إصلاحات الأخطاء وميزات محرر BlockSuite الجديدة
استكشاف الأخطاء وإصلاحها
- لا يمكن الوصول لواجهة الويب ← تأكد أنك تتصفح المنفذ 3040 على المضيف، وليس المنفذ الداخلي 3010 للحاوية
- روابط المشاركة أو الصور مكسورة بعد إضافة وكيل عكسي ← تحقق أن AFFINE_SERVER_EXTERNAL_URL يطابق الرابط العام الفعلي
- حاوية الترحيل تفشل عند أول تشغيل ← راجع سجلات docker لخدمة الترحيل وتأكد أن حاوية PostgreSQL سليمة قبل تشغيلها
- أخطاء اتصال بقاعدة البيانات ← تحقق أن كلمة مرور قاعدة البيانات المُولَّدة في .env تطابق ما هُيِّئ به PostgreSQL؛ عدم التطابق بعد تعديل يدوي لـ .env سبب شائع
- التعاون الفوري لا يتزامن بين المستخدمين ← تأكد أن Redis يعمل وقابل للوصول، فهو يدعم طبقة المزامنة الفورية
- الصور أو الملفات المرفوعة لا تُحمَّل ← تحقق أن حجم ./storage مُركَّب بشكل صحيح وله الصلاحيات المناسبة
- أداء بطيء مع مساحة عمل كبيرة ← تحقق من حدود موارد PostgreSQL وI/O القرص، فمساحة العمل المتنامية تزيد حجم قاعدة البيانات مع الوقت
البدائل
Notion هو البديل التجاري المهيمن للمستندات وقواعد البيانات، بتجربة هاتف أكثر صقلاً، لكنه يتطلب اشتراكاً لميزات الفريق ويخزّن كل شيء على سيرفرات Notion. تغطي Miro وExcalidraw جانب اللوحة البيضاء جيداً لكنها لا تندمج مع تحرير المستندات المنظمة كما يفعل AFFiNE. Logseq وObsidian ممتازان لتدوين الملاحظات الشخصية محلية الأولوية بروابط عكسية لكنهما يفتقران لتعاون AFFiNE الفوري المدمج ولوحته البيضاء المتكاملة. Outline بديل ذاتي الاستضافة قوي إذا كنت تحتاج فقط توثيقاً جماعياً منظماً دون مكوّن اللوحة البيضاء. للمزيج المحدد من مستندات ولوحة بيضاء وقواعد بيانات خفيفة ذاتية الاستضافة كأداة موحدة واحدة، يبقى AFFiNE الخيار الأكثر مباشرة.
متى لا تستخدمه
إذا كان فريقك يحتاج فقط مستندات منظمة ولا يستخدم لوحات بيضاء أو مخططات، فويكي ذاتي الاستضافة أبسط مثل Outline أو BookStack لديه عبء تشغيلي أقل من تشغيل PostgreSQL وRedis لـ AFFiNE. إذا كنت تحتاج نظام تكامل الطرف الثالث الناضج لـ Notion (Zapier ومئات التضمينات وسوق قوالب ضخم)، فلن يضاهيه نظام AFFiNE الأصغر عمراً بعد. تجنّب استضافة AFFiNE ذاتياً إذا لم تكن مستعداً لإدارة نسخ احتياطية منتظمة لثلاثة أحجام منفصلة ومواكبة تحديثات مشروع مفتوح المصدر سريع التطور. لمستخدم واحد يريد فقط ملاحظات محلية بسيطة دون سيرفر إطلاقاً، فأداة محلية الأولوية مثل Obsidian أقل عبئاً بكثير من إعداد مكدّس Docker Compose.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الذي يميّز AFFiNE عن Notion؟
الميزة المحورية هي أن المستندات واللوحات البيضاء هي نفس المحتوى في عرضين. يمكن تحرير الصفحة كمستند منظم بأسلوب Notion ثم تحويلها إلى لوحة حرة حيث تصبح نفس الكتل بطاقات قابلة للتحريك — لا حاجة لنسخ أو إعادة إنشاء أي شيء بين العرضين.
كيف يُنشأ حساب المشرف؟
الحساب الأول الذي تسجّله على النسخة قيد التشغيل يصبح مشرف السيرفر — لا توجد بيانات اعتماد افتراضية. هذا يجعل اللحظة التي تلي التثبيت مباشرة حساسة: سجّل فوراً حتى لا يستولي أحد يجد الرابط على حساب المشرف، وأبقِ المنفذ 3040 محجوباً حتى تفعل.
ما المنفذ الذي يستخدمه AFFiNE؟
تصل إليه عبر المنفذ 3040 على المضيف، الذي يُعيَّن من المنفذ الداخلي 3010 للحاوية. تذكر بعض الوثائق والأدوات 3010، لكنه المنفذ الداخلي — تصفّح دائماً إلى 3040. يعمل PostgreSQL وRedis إلى جانبه على شبكة Docker ولا يُنشَران.
ما الذي أحتاج نسخه احتياطياً؟
ثلاثة أحجام: ./db يحمل بيانات PostgreSQL بكل مستنداتك، و./storage يحمل الملفات المرفوعة والمرفقات، و./config يحمل إعداد السيرفر. انسخ الثلاثة معاً احتياطياً حتى تُعيد الاستعادة إنشاء نسخة تعمل بالكامل.
لماذا يهم AFFINE_SERVER_EXTERNAL_URL؟
يبني AFFiNE روابط المشاركة وعناوين الأصول من تلك القيمة، فإذا لم تطابق العنوان الذي يزوره المستخدمون فعلياً، ستحصل على أصول مكسورة وروابط مشاركة تشير للمضيف الخاطئ. عندما تنقله خلف نطاق ووكيل TLS، حدّث AFFINE_SERVER_EXTERNAL_URL إلى الرابط العام الحقيقي.