📋 تثبيت Planka — لوحة كانبان التشاركية وإدارة المهام (بديل Trello) على Docker
نشر منصة Planka على Ubuntu باستخدام Docker — لوحة كانبان مفتوحة المصدر الأنيقة والبديل الحر لـ Trello لتتبع المهام والمشاريع التشاركية لحظياً مع دعم Markdown وقاعدة بيانات PostgreSQL.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/project-management/planka/planka-ubuntu.sh
chmod +x planka-ubuntu.sh
./planka-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/project-management/planka/planka-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x planka-ubuntu.sh
3 تشغيل المثبت
./planka-ubuntu.sh
4 إنشاء حساب المشرف وبدء التنظيم
http://your-server-ip:3061
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3061 | Planka web interface (mapped from container port 1337) |
| 5432 | PostgreSQL — internal to the Docker network, not exposed to the host |
نظرة عامة
تعد Planka منصة ويب عصرية وخفيفة ومفتوحة المصدر لإدارة المشاريع وتتبع المهام بأسلوب كانبان (Kanban) التفاعلي مبنية بتقنيات React وRedux وقاعدة بيانات PostgreSQL. تعمل المنصة على المنفذ 3061 (المحول من 1337 الداخلي)، وتقدم واجهة مرئية فائقة النقاء مستوحاة من منصة Trello الشهيرة. وتتيح للفرق والمستخدمين تنظيم الأعمال والمهام عبر مشاريع ولوحات وقوائم وبطاقات مرنة مع التحديث اللحظي المباشر، وتنسيقات Markdown الغنية، والوسوم الملونة، ومواعيد الاستحقاق، وقوائم المهام الفرعية، وإسناد المهام للأعضاء.
لماذا تستخدمه
تفرض أدوات إدارة المشاريع السحابية التجارية (مثل Trello وAsana وMonday.com) قيوداً على عدد اللوحات والمستخدمين في الباقات المجانية، واشتراكات شهرية متكررة لكل موظف، وتخزن خطط مشاريعك السرية على خوادم خارجية. تمنحك الاستضافة الذاتية لـ Planka السيادة التامة على بياناتك، مع عدد غير محدود من اللوحات والمستخدمين بدون أي تكاليف تراخيص، واستجابة فائقة السرعة على خوادمك الخاصة.
متى تحتاجه
- تحتاج أنت وفريقك إلى لوحة كانبان مرئية ونظيفة لإدارة المهام دون دفع اشتراكات شهرية لكل مستخدم
- تبحث عن بديل مفتوح المصدر ومستقل لمنصة Trello يدعم التحديث اللحظي المباشر
- تدير خطط تطوير البرمجيات أو الحملات التسويقية أو قوائم المهام الشخصية عبر عدة لوحات
- تلتزم بحفظ سرية وخصوصية خطط العمل وملفات المشاريع داخل خوادمك الخاصة
- تريد تطبيق إدارة مهام خفيف جداً وسريع يعمل بسلاسة على سيرفر VPS اقتصادي أو سيرفر منزلي
من يحتاجه
- فرق تطوير البرمجيات لتخطيط دورات العمل (Sprints) ومتابعة تطوير الميزات وحل الأخطاء
- مديرو المشاريع والفرق التسويقية لتتبع الحملات الإعلانية وجداول نشر المحتوى
- الشركات الصغيرة والناشئة لإدارة العمليات اليومية وتوزيع المهام بين الأقسام
- المستقلون والمستشارون لتنظيم مراحل تسليم مشاريع العملاء والمواعيد النهائية
- أصحاب السيرفرات المنزلية وهواة الإنتاجية لتنظيم الأهداف الشخصية والمشاريع المنزلية
حالات الاستخدام الشائعة
- إدارة دورات العمل البرمجية عبر قوائم: 'المهام المعلقة'، 'قيد التنفيذ'، 'قيد المراجعة'، و'المكتملة'
- تنظيم الجداول التحريرية للنشر مع وسوم التصنيف الملونة، وإرفاق مسودات المقالات، وتحديد مواعيد النشر
- التعاون التشاركي اللحظي أثناء اجتماعات الفريق مع رؤية تحريك البطاقات مباشرة أمام الجميع
- تقسيم المهام المعقدة إلى قوائم مهام فرعية (Checklists) مع مؤشر بصري لنسبة الإنجاز المكتملة
- أرشفة البطاقات المنجزة والبحث السريع في أرشيف المشاريع السابقة باستخدام فلاتر الكلمات الدلالية
الميزات الرئيسية
- مزامنة لحظية مباشرة: تنعكس التعديلات التي يجريها أي عضو في الفريق فورياً على شاشات باقي الأعضاء
- هيكل تنظيمي هرمي للمشاريع: تنظيم العمل عبر مشاريع (Projects)، لوحات (Boards)، قوائم (Lists)، وبطاقات (Cards)
- دعم كامل لتنسيقات Markdown في وصف البطاقات والتعليقات مع تلوين الأكواد وإرفاق الصور
- وسوم ملونة مخصصة، مواعيد استحقاق مع تنبيهات التأخر، مرفقات الملفات، وإسناد البطاقات للموظفين
- تتبع الوقت وسجل تدقيق شامل للأنشطة يوضح من قام بإنشاء أو تحريك أو تعديل كل بطاقة
- نظام صلاحيات متكامل (RBAC): مشرفو المشاريع، المديرون، المحررون، وصلاحيات القراءة فقط
- قاعدة بيانات PostgreSQL 16 عالية الأداء تضمن حفظ المهام وسجلات الأنشطة بشكل موثوق
- معمارية Docker Compose تجمع Planka مع PostgreSQL 16 ومجلدات التخزين الدائم للبيانات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3061 لعرض شاشة تسجيل الحساب
- أنشئ حساب المشرف الأساسي بالبريد الإلكتروني واسم المستخدم وكلمة مرور قوية
- أنشئ مشروعك الأول (مثل: 'فريق التطوير') وأضف لوحتك الأولى (مثل: 'دورة العمل 1')
- أنشئ قوائم كانبان القياسية ('مهام جديدة'، 'قيد التنفيذ'، 'مكتملة') وأضف بطاقات مهامك الأولى
- ادعُ أعضاء الفريق من إعدادات المشروع (Project Settings ← Members) وحدد صلاحياتهم
- ضع Planka خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL لتأمين بيئة الإنتاج
- أعد سكريبت نسخ احتياطي دوري لقاعدة بيانات PostgreSQL في المجلد `./db`
أفضل ممارسات الأمان
- أنشئ حساب المشرف الأساسي فور تشغيل الحاوية لمنع أي طرف غريب من أخذ ملكية اللوحة
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية كلمات المرور وبيانات المهام أثناء النقل
- أبقِ منفذ قاعدة البيانات PostgreSQL 5432 معزولاً داخل شبكة Docker ولا تكشفه للإنترنت العام
- اضبط مفتاحاً سرياً قوياً (`SECRET_KEY`) في ملف Compose لتشفير رموز الجلسات (JWT)
- احمِ مجلدي `./db` و`./data` بصلاحيات نظام مناسبة على السيرفر
- حدّث صورة الحاوية دورياً للحصول على الميزات والتحديثات الأمنية المستمرة
المنافذ وإعدادات جدار الحماية
يقدم تطبيق Planka واجهته عبر منفذ TCP 3061 (المحول من 1337 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترويسات ترقية WebSocket ووجهه لمنفذ 3061، مع إبقاء المنفذ 3061 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./db` احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL 16 بكافة المشاريع واللوحات والبطاقات والمستخدمين
- انسخ مجلد `./data` (/app/data) لحفظ كافة مرفقات البطاقات وصور الملفات الشخصية
- استخرج نسخة احتياطية دورية لقاعدة البيانات عبر pg_dump: `docker exec planka-db pg_dump -U postgres planka > planka_backup.sql`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة باسترجاع نسخة البيانات داخل حاوية تجريبية للتأكد من ظهور كافة اللوحات والبطاقات بنجاح
الأخطاء الشائعة
- ترك المفتاح السري `SECRET_KEY` الافتراضي دون تغييره في الإنتاج، مما يضعف أمان جلسات JWT
- نسيان تفعيل ترويسات ترقية قنوات WebSockets في الوكيل العكسي، مما يسبب فشل المزامنة اللحظية المباشرة
- عدم ربط مجلدات التخزين الدائم `./db` و`./data`، مما يسبب فقدان اللوحات والمرفقات عند تحديث الحاوية
- كشف منفذ قاعدة البيانات PostgreSQL 5432 للإنترنت العام مباشرة دون حماية
- التشغيل في بيئة الإنتاج عبر HTTP غير المشفر بدون شهادة SSL
استكشاف الأخطاء وإصلاحها
- عدم مزامنة التعديلات اللحظية — تأكد من تفعيل `Upgrade $http_upgrade` و`Connection 'upgrade'` في إعدادات الوكيل العكسي Nginx
- خطأ في الاتصال بقاعدة البيانات عند بدء التشغيل — انتظر 15 ثانية لاكتمال تهيئة PostgreSQL وافحص السجلات عبر `docker logs planka-db -f`
- فشل رفع مرفقات البطاقات — تأكد من صلاحيات الكتابة على مجلد `./data` في السيرفر
- ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs planka -f`
- نسيان كلمة مرور المشرف — حدث سجل المستخدم أو كلمة المرور في جدول `user_account` داخل قاعدة بيانات PostgreSQL عبر سطر الأوامر
البدائل
منصة Wekan لوحة كانبان مفتوحة المصدر غنية بالميزات مبنية بـ Meteor. منصة Focalboard بديل مفتوح المصدر لـ Trello وNotion من Mattermost. منصة Taiga مخصصة للفرق البرمجية الرشيقة (Agile). منصة Trello الأداة التجارية السحابية الشهيرة.
متى لا تستخدمه
تجنب استخدام Planka إذا كنت بحاجة إلى مخططات جانت الزمنية المعقدة (Gantt Charts)، وتتبع الميزانيات المالية وتوزيع ساعات العمل لعشرات المطورين (حيث تعد منصات مثل OpenProject أو Taiga أنسب للمشاريع المؤسسية الضخمة). وإذا كنت تبحث عن مساحة عمل شاملة تجمع التوثيق والجداول وقواعد البيانات معاً، ففكر في منصات مثل AppFlowy أو Outline.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين Planka ومنصة Trello؟
تعد Planka بديلاً مجانياً ومفتوح المصدر 100% ومستضافاً ذاتياً لـ Trello. وتوفر نفس تجربة لوحات كانبان المرئية مع عدد غير محدود من اللوحات والبطاقات والمستخدمين مع الاحتفاظ بكافة بياناتك على سيرفرك الخاص.
هل تدعم Planka التحديثات اللحظية المباشرة؟
نعم! تستخدم Planka قنوات WebSockets لمزامنة أي تغييرات في اللوحات فورياً بين كافة المستخدمين المتصلين؛ فعندما يحرك عضو بطاقة معينة، يراها باقي الأعضاء تتحرك في نفس اللحظة.
هل يمكن رفع مرفقات وملفات داخل بطاقات المهام؟
نعم، يمكنك إرفاق الصور ومستندات PDF والملفات المضغوطة بالبطاقات، ويتم حفظ هذه المرفقات بشكل دائم في مجلد `./data` بالسيرفر.
ما هي قاعدة البيانات التي تعتمد عليها Planka؟
تعتمد Planka على قاعدة بيانات PostgreSQL 16 عالية الكفاءة لتخزين كافة اللوحات والبطاقات والمستخدمين وسجلات الأنشطة.
كم تستهلك Planka من الذاكرة العشوائية (RAM)؟
تستهلك حاوية Planka مع قاعدة بيانات PostgreSQL حوالي 120 إلى 200 ميجابايت فقط من الذاكرة العشوائية مجتمعة، مما يجعلها خفيفة وسريعة للغاية.