👨💻 تثبيت Appwrite — منصة خلفية ذاتية الاستضافة (Backend-as-a-Service)
انشر Appwrite على Ubuntu — منصة خلفية مفتوحة المصدر توفر المصادقة وقواعد البيانات والتخزين والدوال بلا خادم والرسائل خلف لوحة تحكم واحدة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/appwrite/appwrite-ubuntu.sh
chmod +x appwrite-ubuntu.sh
sudo bash appwrite-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/appwrite/appwrite-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x appwrite-ubuntu.sh
3 تشغيل المثبت
يثبّت السكريبت Docker إن لزم ويشغّل حاوية مثبّت Appwrite الرسمية، التي تولّد docker-compose.yml وملف .env، ثم تُشغّل نحو 15 حاوية. التشغيل الأول يستغرق عدة دقائق ويحتاج 4 جيجابايت رام على الأقل.
sudo bash appwrite-ubuntu.sh
4 إنشاء حساب المسؤول
افتح المتصفح وانتقل إلى لوحة تحكم Appwrite، ثم أنشئ حساب المسؤول الأول من شاشة التسجيل:
http://<your-server-ip>:8201
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8201 | Console + API via internal Traefik (HTTP) |
| 8448 | Console + API (HTTPS) |
| internal | MariaDB, Redis, workers, realtime (~15 containers) |
نظرة عامة
Appwrite منصة خلفية مفتوحة المصدر (Backend-as-a-Service) تجمع العناصر التي تحتاجها معظم التطبيقات خلف لوحة تحكم واحدة ذاتية الاستضافة: مصادقة مع أكثر من 30 مزود OAuth، قاعدة بيانات موجهة للمستندات، تخزين ملفات مع تحويلات الصور، دوال بلا خادم بعشرات اللغات، ورسائل للبريد الإلكتروني والرسائل النصية والإشعارات الفورية. بدلاً من ربط خدمات منفصلة معاً، تتحدث مكتبات العميل للويب والجوال والمنصات الأصلية إلى مثيل Appwrite واحد عبر واجهة برمجية واحدة، مما يتيح لفريق صغير إطلاق سيرفر خلفي حقيقي دون بنائه وتشغيله من الصفر.
لماذا تستخدمه
بناء سيرفر خلفي إنتاجي من الصفر يعني إعداد المصادقة وقاعدة بيانات وتخزين ملفات ومهام خلفية وتسليم إشعارات كلاً على حدة، ثم إبقاء كل ذلك آمناً ومتاحاً. يجمّع Appwrite كل هذا كحزمة واحدة ذاتية الاستضافة خلف Docker Compose، لذا تحصل على سيرفر خلفي يعمل في الوقت الذي يستغرقه تشغيل المثبّت بدلاً من أسابيع من عمل التكامل. ولأنه ذاتي الاستضافة، تبقى بيانات المستخدمين الحساسة وملفاتهم على بنية تحتية تتحكم بها بدلاً من سحابة طرف ثالث، بينما لا تزال مكتبات العميل تمنح مطوري الواجهة الأمامية والجوال نفس سير العمل السريع القائم على API الذي يحصلون عليه من خدمة BaaS مستضافة مثل Firebase.
متى تحتاجه
- تبدأ تطبيق جوال أو ويب جديداً وتحتاج مصادقة وقاعدة بيانات وتخزيناً ودوالاً دون بناء كل منها من الصفر
- تريد تجنب الارتباط بمزود مع خدمة BaaS مستضافة مغلقة مثل Firebase مع الحفاظ على سير عمل تطوير سريع مشابه
- لدى مؤسستك متطلبات إقامة بيانات أو GDPR أو امتثال تتطلب بقاء بيانات المستخدمين على بنية تحتية تتحكم بها
- تحتاج دوالاً بلا خادم ورسائل معاملاتية إلى جانب بيانات CRUD قياسية في نفس منصة السيرفر الخلفي
- تبني نموذجاً أولياً بسرعة وتريد سيرفراً خلفياً يعمل في دقائق بدلاً من قضاء أيام في ربط الخدمات معاً
- تريد لوحة تحكم واحدة ومجموعة واحدة من مكتبات العميل تغطي المصادقة وقاعدة البيانات والتخزين والدوال والرسائل بدلاً من ربط أدوات منفصلة معاً
من يحتاجه
- مطورو تطبيقات الجوال والويب الذين يحتاجون مصادقة وقاعدة بيانات وتخزين دون بناء سيرفر خلفي مخصص
- الشركات الناشئة والفرق الصغيرة التي تريد الإطلاق بسرعة دون تخصيص مهندسين للبنية التحتية الخلفية
- الفرق المهتمة بالخصوصية والشركات الأوروبية التي تحتاج بقاء بيانات المستخدمين على بنية تحتية تتحكم بها للامتثال لـ GDPR
- الوكالات التي تبني عدة تطبيقات لعملاء وتستفيد من منصة خلفية ذاتية الاستضافة واحدة قابلة لإعادة الاستخدام
- المطورون المهاجرون من Firebase أو Supabase الذين يريدون بديلاً مفتوح المصدر وذاتي الاستضافة
- الفرق التي تبني تطبيقات داخلية أو B2B تحتاج دوالاً بلا خادم ورسائل إلى جانب بيانات CRUD قياسية
حالات الاستخدام الشائعة
- إضافة مصادقة مستخدمين بالبريد الإلكتروني وكلمة المرور أو الروابط السحرية أو OAuth (Google وGitHub وApple وأكثر من 30 آخرين) لتطبيق جوال أو ويب
- تخزين والاستعلام عن بيانات تطبيق منظمة باستخدام قاعدة بيانات المستندات في Appwrite ونظام صلاحياتها
- التعامل مع رفع الملفات مع تغيير حجم الصور واقتصاصها وتحويل الصيغة تلقائياً عبر واجهة Storage
- تشغيل دوال بلا خادم تُستدعى بأحداث قاعدة البيانات أو طلبات HTTP أو جداول زمنية دون إدارة سيرفرات
- إرسال بريد إلكتروني معاملاتي أو رسائل نصية أو إشعارات فورية للمستخدمين عبر خدمة Messaging المدمجة
- بناء سيرفر خلفي SaaS متعدد المستأجرين حيث يملك كل فريق أو منظمة بيانات معزولة عبر ميزة Teams في Appwrite
الميزات الرئيسية
- مصادقة بالبريد الإلكتروني وكلمة المرور، روابط سحرية، رمز مرور بالهاتف، جلسات مجهولة، وأكثر من 30 مزود OAuth2
- خدمة قواعد بيانات بمجموعات ومستندات وصلاحيات دقيقة على مستوى الصف والحقل واستعلامات فورية
- خدمة تخزين مع معاينات ملفات وتحويلات صور (تغيير حجم، اقتصاص، تحويل صيغة) ودعم فحص الفيروسات
- خدمة دوال تدعم Node.js وPython وPHP وGo وRuby وJava وDart وDeno وأكثر، تُستدعى بأحداث أو جداول زمنية
- خدمة رسائل لإرسال البريد الإلكتروني والرسائل النصية والإشعارات الفورية من حملات موحدة
- خدمة فورية تدفع تحديثات حية عبر WebSockets عند تغيّر سجلات أو مستندات قاعدة البيانات
- فرق وعضويات لبناء تطبيقات متعددة المستأجرين بصلاحيات قائمة على الأدوار
- مكتبات عميل للويب وFlutter وiOS وAndroid وReact Native، ومكتبات سيرفر لـ Node.js وPHP وPython وRuby وأكثر
كيفية الاستخدام بعد التثبيت
- أنشئ حساب المسؤول الأول من شاشة تسجيل لوحة التحكم فور انتهاء تشغيل الحزمة
- أنشئ مشروعاً جديداً من لوحة التحكم — كل مشروع يحصل على مفاتيح API ومستخدمين وموارد معزولة خاصة به
- أضف منصة (Web أو Flutter أو iOS أو Android) لتسجيل تطبيقك والحصول على معرّف المشروع ونقطة النهاية لمكتبة العميل
- اضبط طرق المصادقة تحت Auth → Settings، بتفعيل مزودات OAuth أو تدفق البريد الإلكتروني/كلمة المرور الذي تحتاجه
- أنشئ قاعدة بيانات ومجموعات تحت Databases، وحدد الحقول والصلاحيات لكل مجموعة
- ثبّت مكتبة عميل Appwrite في تطبيقك وهيئها بنقطة نهاية المشروع ومعرّفه
- انشر دالة بلا خادم تحت Functions إذا احتاج تطبيقك منطقاً خلفياً يُستدعى بأحداث أو جداول زمنية
- اضبط مزودات Messaging (SMTP وTwilio وFCM) تحت Messaging إذا احتجت بريداً إلكترونياً أو رسائل نصية أو إشعارات فورية
أفضل ممارسات الأمان
- أنشئ حساب المسؤول فوراً بعد التشغيل الأول — لوحة تحكم غير مُطالَب بها هي باب مفتوح لأي شخص يصل للمنفذ 8201
- ضع لوحة التحكم والواجهة البرمجية خلف وكيل عكسي مع HTTPS لأن هذا النشر يقدم HTTP عادي على المنفذ 8201 افتراضياً
- استخدم مفاتيح API محددة الصلاحيات بدلاً من مفتاح واحد بوصول كامل للمشروع
- اضبط صلاحيات المجموعات والمستندات بعناية — نموذج صلاحيات Appwrite دقيق، راجع الإعدادات الافتراضية قبل تخزين بيانات مستخدمين حقيقية
- قيّد روابط إعادة توجيه OAuth وأسماء مضيفي المنصات المسجلة حتى لا تُصدر رموز لنطاقات غير مصرح بها
- حافظ على تحديث الحاويات الخمسة عشر معاً باستخدام مسار الترقية الرسمي من Appwrite بدلاً من تحديث الصور فردياً
- قيّد الوصول الشبكي المباشر لحاويات MariaDB وRedis والعمال الداخلية — فقط موجّه Traefik يحتاج أن يكون متاحاً
- فعّل المصادقة الثنائية لحسابات مسؤولي لوحة التحكم نفسها بمجرد أن تصبح قاعدة مستخدميك وبياناتك حية
المنافذ وإعدادات جدار الحماية
ينشر هذا النشر المنفذ المضيف 8201 لـ HTTP و8448 لـ HTTPS، وكلاهما موجّه داخلياً عبر وكيل Traefik العكسي المدمج في Appwrite إلى الواجهة البرمجية ولوحة التحكم والخدمات الفورية — لا تحتاج كشف أو إدارة منافذ خدمة فردية بنفسك. كل شيء آخر، بما فيه MariaDB وRedis وعمال الطابور وبيئات تنفيذ الدوال، يعمل على شبكة Docker داخلية دون منافذ مضيف منشورة، لذا فهو غير قابل للوصول من خارج السيرفر افتراضياً. ولأن المنفذ 8201 هو HTTP عادي، ضع وكيلاً عكسياً منهياً لـ TLS مثل Nginx Proxy Manager أمامه قبل قبول أي حركة مرور مستخدمين حقيقية، وقيّد الوصول المباشر للمنفذين 8201/8448 في الجدار الناري لمضيف الوكيل العكسي فقط.
النسخ الاحتياطي والصيانة
- انسخ أحجام Docker التي ينشئها Appwrite لبيانات MariaDB والملفات المرفوعة وكود الدوال والبنايات — فقدانها يعني فقدان سيرفرك الخلفي بالكامل
- استخدم mysqldump أو أدوات النسخ الاحتياطي الأصلية لـ MariaDB على حاوية appwrite-mariadb لتصدير متسق لقاعدة البيانات بدلاً من نسخ ملفات من قاعدة بيانات تعمل
- انسخ ملف .env الذي أنشأه المثبّت، الذي يحتوي على المفاتيح السرية والإعدادات اللازمة لإعادة تشغيل الحزمة بنفس الشكل
- خزّن نسخ حجم التخزين الاحتياطية (الملفات المرفوعة) بشكل منفصل عن نسخ قاعدة البيانات حتى يمكن استعادة أي منهما بشكل مستقل عند الحاجة
- وثّق معرّفات مشاريعك ومفاتيح API وتسجيلات المنصات خارج قاعدة البيانات، لأن بعض هذا يسهل نسيانه عند إعادة بناء مشروع
- اختبر استعادة كاملة على مضيف منفصل دورياً — إعادة بناء الحاويات الخمس عشرة من الصفر والتأكد من عودة المستخدمين والبيانات والملفات سليمة
الأخطاء الشائعة
- ترك لوحة التحكم دون مطالبة بعد التثبيت، مما يسمح لأي شخص يصل للمنفذ 8201 بتسجيل الحساب الأول (المسؤول)
- كشف المنفذ 8201 مباشرة للإنترنت دون وكيل عكسي TLS، مما يرسل مفاتيح API ورموز الجلسات عبر HTTP عادي
- التقليل من احتياجات الموارد — يشغّل Appwrite نحو 15 حاوية وVPS بـ 1-2 جيجابايت سيعاني أو يفشل في تشغيل الحزمة
- استخدام مفتاح API واحد واسع لكل تكامل عميل بدلاً من مفاتيح محددة النطاق تقتصر على ما يحتاجه كل تكامل فعلياً
- ترك صلاحيات المجموعات والمستندات عند إعدادات افتراضية فضفاضة جداً، مما يعرّض بيانات المستخدمين عبر حدود وصول خاطئة
- تعديل صور الحاويات الفردية يدوياً بدلاً من استخدام أمر الترقية المدعوم من Appwrite، مما يسبب تبايناً في الإصدارات بين الخدمات
- نسيان نسخ ملف .env احتياطياً، مما يجعل إعادة بناء أسرار الحزمة وإعداداتها بعد فشل المضيف مستحيلاً
استكشاف الأخطاء وإصلاحها
- المثبّت يتجمد أو الحاويات تعيد التشغيل باستمرار — تحقق من الرام المتاحة بـ free -h؛ تحتاج حاويات Appwrite الخمس عشرة 4 جيجابايت فأكثر وستتعثر أو تدخل حلقة تعطل بأقل من ذلك
- لوحة التحكم غير متاحة على المنفذ 8201 — تأكد أن جميع الحاويات تعمل بـ docker ps، وتحقق أن حاوية موجّه Traefik تحديداً سليمة
- طلبات مكتبة العميل تفشل بأخطاء صلاحيات — تحقق أن نطاقات مفتاح API تطابق ما يحتاجه استدعاء المكتبة وأن صلاحيات المجموعة/المستند تسمح للمستخدم أو الدور الطالب
- إعادة توجيه تسجيل دخول OAuth تفشل — تأكد أن رابط إعادة التوجيه واسم مضيف المنصة المسجلين في لوحة التحكم يطابقان تماماً ما يرسله تطبيقك، بما في ذلك البروتوكول والمنفذ
- الدوال تفشل في التنفيذ أو تنتهي مهلتها — تحقق من سجلات بناء الدالة في لوحة التحكم وتأكد أن بيئة التشغيل ونقطة الدخول تطابقان الكود المنشور
- التحديثات الفورية لا تصل — تحقق أن مكتبة العميل مشتركة في القناة الصحيحة وأن حركة WebSocket غير محظورة بوكيل أمام Appwrite
- تعديلات المخطط أو الترحيلات لا تظهر — قد تستغرق حقول مجموعة Appwrite لحظة للفهرسة؛ تحقق أن حالة الحقل 'available' قبل الاستعلام
البدائل
Supabase هو أقرب مقارنة ومبني على PostgreSQL، مما يمنحك SQL حقيقياً وإضافات وأدوات علائقية قياسية بدلاً من نموذج المستندات في Appwrite — خيار أفضل إذا كان فريقك يفكر بالفعل بمنطق SQL. Firebase هو خدمة BaaS المُدارة بالكامل من Google، مغلقة المصدر بمكتبات عميل ممتازة لكن دون خيار استضافة ذاتية ونموذج تسعير قائم على الاستخدام قد يصبح مكلفاً. Pocketbase بديل أخف بكثير بملف تنفيذي واحد للمشاريع الأصغر التي لا تحتاج بيئات تشغيل الدوال أو خدمة الرسائل في Appwrite. Parse Server خدمة BaaS ذاتية الاستضافة أقدم لا تزال مُصانة بنظام بيئي أصغر من نظام Appwrite الحالي. كخدمة BaaS ذاتية الاستضافة ومفتوحة المصدر بأوسع مجموعة ميزات مدمجة — مصادقة وقاعدة بيانات وتخزين ودوال ورسائل كلها في لوحة تحكم واحدة — يبقى Appwrite من أكمل الخيارات المتاحة اليوم.
متى لا تستخدمه
Appwrite ليس الخيار الصحيح إذا كان فريقك يعمل بالفعل بشكل أساسي بـ SQL ويريد وصولاً مباشراً لقاعدة البيانات — أساس Supabase القائم على PostgreSQL يناسب سير العمل هذا أكثر من قاعدة بيانات Appwrite الموجهة للمستندات. يحتاج أيضاً موارد حقيقية: نحو 15 حاوية و4 جيجابايت رام فأكثر تستبعده من مثيلات VPS الصغيرة جداً أو المشاريع الهوائية بميزانيات محدودة جداً، حيث يكون ملف Pocketbase التنفيذي الواحد خياراً أفضل. إذا كنت تحتاج خدمة مُدارة بالكامل دون أي مسؤولية بنية تحتية ولا تمانع الارتباط بمزود واحد، يزيل Firebase العبء التشغيلي الذي لا يزال Appwrite يطلب منك تحمّله. وإذا كان تطبيقك بسيطاً بما يكفي بحيث تكفيه قاعدة بيانات Postgres واحدة ومكتبة مصادقة خفيفة، فقد تكون مجموعة ميزات BaaS الكاملة منصة أكبر مما يحتاجه المشروع.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
كيف يعمل مثبّت Appwrite؟
يشغّل السكريبت حاوية مثبّت Appwrite الرسمية، التي تولّد ملف docker-compose.yml وملف .env ثم تُشغّل الحزمة. تحصل على الإعداد المدعوم من المصدر الرسمي. الحزمة تتكون من نحو 15 حاوية، لذا يستغرق التشغيل الأول عدة دقائق.
ما المنافذ التي يستخدمها Appwrite؟
يكشف هذا النشر لوحة التحكم والواجهة البرمجية على المنفذ المضيف 8201 لـ HTTP و8448 لـ HTTPS. موجّه Traefik الداخلي في Appwrite يقف أمام جميع الخدمات، لذا هذان هما المنفذان الوحيدان اللذان تنشرهما.
ما بيانات الاعتماد الافتراضية؟
لا توجد. عند أول زيارة للوحة التحكم على المنفذ 8201، تُنشئ حساب المسؤول بنفسك. افعل هذا فوراً، قبل أن يتمكن أي شخص آخر من الوصول للوحة التحكم وتسجيل الحساب الأول.
كم رام يحتاجه Appwrite؟
4 جيجابايت على الأقل. يشغّل Appwrite نحو 15 حاوية — الواجهة البرمجية وعدة عمال والخدمة الفورية وMariaDB وRedis وموجّه — لذا فهو أثقل بكثير من تطبيق بحاوية واحدة.
كيف يختلف Appwrite عن Supabase؟
يستخدم Appwrite قاعدة بيانات مستندات بنموذج قائم على لوحة التحكم ويجمّع دوالاً بلا خادم ورسائل. Supabase مبني على PostgreSQL، مما يمنحك SQL حقيقياً وإضافات وأدوات قياسية.