📋 تثبيت WeKan — لوحة كانبان التفاعلية لإدارة المشاريع وبديل Trello على Docker

نشر منصة WeKan على Ubuntu باستخدام Docker — لوحة كانبان التفاعلية مفتوحة المصدر وبديل Trello لإدارة المشاريع وسحب وإفلات المهام بالوقت الفعلي على المنفذ 8080.

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

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

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

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

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/project-management/wekan/wekan-ubuntu.sh

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

chmod +x wekan-ubuntu.sh

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

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

sudo bash wekan-ubuntu.sh

4 إنشاء حساب المشرف وأول لوحة كانبان

افتح متصفحك على الرابط http://ip-سيرفرك:8080. سجل حسابك الأول (الذي يُمنح رتبة المشرف العام تلقائياً)، وأنشئ لوحتك الأولى بالقوائم والمسارات، وادعُ أعضاء فريقك للتعاون.

http://:8080
# Register the first account — it becomes the administrator

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

المنفذالغرض
8080WeKan web UI + websockets
27017MongoDB (internal only)

نظرة عامة

تعد WeKan منصة ولوحة كانبان (Kanban Board) تعاونية ومفتوحة المصدر لإدارة المشاريع والمهام صُممت كبديل حر ومستضاف ذاتياً لمنصات Trello وAsana. تعمل المنصة عبر المنفذ 8080 بالاعتماد على قاعدة بيانات MongoDB، لتتيح إدارة وتتبع المهام بصرياً عبر القوائم، والبطاقات، والمسارات الأفقية (Swimlanes)، والحقول المخصصة، والوسوم، والمهام الفرعية، وقوائم التحقق، والمرفقات. وتمكن فرق العمل من متابعة سير المشاريع عبر المراحل المختلفة في بيئة تعاونية فورية ومستقرة بدون أي اشتراكات سحابية.

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

تقيد المنصات السحابية التجارية (مثل Trello وJira) الميزات المتقدمة كالمسارات الأفقية والحقول المخصصة وعدد الأعضاء باشتراكات باهظة تُحسب لكل مستخدم شهرياً، فضلاً عن تخزين خطط ومشاريع شركتك الحساسة على خوادم تجارية. يمنحك WeKan منصة كانبان مؤسسية متكاملة مع خصوصية تامة لبياناتك 100%، ولوحات وأعضاء غير محدودين، واستيراد مباشر للوحات Trello القديمة بضغطة زر، وبدون أي تكاليف تراخيص.

متى تحتاجه

  • تريد لوحة كانبان بصرية تفاعلية ومستضافة ذاتياً بنسبة 100% كبديل لتطبيقات Trello وAsana
  • تريد متابعة وتوزيع المهام بالسحب والإفلات وتلوين البطاقات وتحديد مواعيد التسليم النهائية
  • تحتاج إلى مسارات أفقية (Swimlanes) ومهام فرعية لإدارة المشاريع الهندسية والبرمجية المعقدة
  • تريد استيراد لوحاتك القديمة وسجلات بطاقاتك السابقة من Trello أو ملفات الـ CSV بسهولة
  • تحتاج لتعاون فوري وتحديثات حية بالـ WebSockets لعدة مستخدمين دون دفع رسوم اشتراك شهرية لكل موظف

من يحتاجه

  • فرق هندسة البرمجيات ومديرو المشاريع لإدارة مراحل الـ Agile ودورات السبرنت (Sprints)
  • فرق التسويق وصناع المحتوى لتنظيم الحملات الإعلانية وجدول النشر ومراجعة التصاميم
  • فرق الدعم الفني وتقنية المعلومات لإدارة مهام صيانة البنية التحتية وتوزيع الأجهزة
  • المستقلون وأصحاب الأعمال الصغيرة لمتابعة مراحل تسليم المشاريع للعملاء والفواتير
  • أصحاب السيرفرات المنزلية لتنظيم المهام الشخصية وترقيات السيرفرات ومشاريع الأتمتة

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

  • إدارة سبرنت برمجي مدته أسبوعان بأعمدة: 'قائمة الانتظار'، 'قيد التنفيذ'، 'مراجعة الكود'، 'الاختبار'، 'مكتمل'
  • استيراد 10 لوحات قديمة من Trello بكافة التعليقات والمرفقات وقوائم التحقق المكتملة
  • تنظيم مشروع إعادة تصميم موقع باستخدام مسارات أفقية مستقلة لـ 'الواجهة الأمامية' و'الخلفية' و'المحتوى'
  • إسناد البطاقات للموظفين مع وسوم ملونة وتحديد الساعات المقدرة ومواعيد الاستحقاق
  • تنظيم مشاريع ترقية السيرفر المنزلي ببطاقات تحتوي على مخططات الشبكة وقوائم مراجعة الإعدادات

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

  • لوحة كانبان تفاعلية في الوقت الفعلي على المنفذ 8080: سحب وإفلات فوري للبطاقات مدعوم بـ WebSockets
  • مسارات عمل متعددة الأبعاد: دعم القوائم العمودية، والمسارات الأفقية (Swimlanes)، والمهام الفرعية المتداخلة
  • بيانات غنية للبطاقات: نصوص بتنسيق Markdown، ووسوم ملونة، ومرفقات، وقوائم تحقق، وتواريخ استحقاق
  • استيراد سهل من Trello وCSV: نقل لوحاتك وملفاتك السابقة مباشرة من ملفات Trello JSON
  • نظام صلاحيات متدرج: تحديد مديري اللوحات، والأعضاء العاديين، والزوار المشاهدين فقط
  • حقول وقواعد مخصصة: إنشاء قوائم منسدلة وتواريخ وحقول نصوص مخصصة حسب متطلبات مشروعك
  • عرض التقويم والخط الزمني: استعراض البطاقات والمهام حسب تواريخ تسليمها ومراحل الإنجاز
  • معمارية Docker Compose تجمع تطبيق WeKan مع قاعدة بيانات MongoDB على المنفذ 8080

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8080
  • اضغط على 'Register' وسجل أول حساب (يصبح الحساب الأول المسجل تلقائياً هو المشرف العام للسيرفر)
  • توجه إلى Admin Panel ← Settings وعطّل التسجيل العام إذا كنت تريد قصر السيرفر على فريقك فقط
  • اضغط على '+ Add Board'، واختر لون الخلفية وأنشئ أعمدة مراحل عملك (مثل: قيد الانتظار، قيد العمل، مكتمل)
  • ادعُ أعضاء فريقك باسم المستخدم أو البريد الإلكتروني وحدد صلاحياتهم باللوحة
  • ضع WeKan خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع دعم ترقية الـ WebSockets
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة بيانات MongoDB (`./data`)

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

  • تنبيه أمني حاسم: سجل حساب المشرف فور اكتمال التثبيت مباشرة؛ فالأول يسجل يحصل على صلاحيات المشرف المطلقة
  • عطّل ميزة التسجيل العام (`WITH_REGISTRATION=false` أو من لوحة الإدارة) بعد إنشاء حسابات فريقك
  • استخدم تشفير HTTPS دائماً مع تشفير WebSockets (`wss://`) لحماية تفاصيل المهام والمشاريع بالشبكة
  • أبقِ منفذ قاعدة البيانات الداخلي MongoDB 27017 معزولاً عن الإنترنت العام
  • احمِ مجلد البيانات `./data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم WeKan واجهة الويب والـ WebSockets عبر منفذ TCP 8080. اسمح بالمنفذ 8080 للشبكة المحلية (`ufw allow 8080/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تمرير ترويسات الـ WebSocket (`Upgrade` و`Connection`) لمنفذ 8080.

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

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات MongoDB بكافة اللوحات والبطاقات والمرفقات
  • استخرج نسخة احتياطية لقاعدة البيانات عبر mongodump: `docker exec wekan-db mongodump --out /dump`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env` المحتوي على `ROOT_URL`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة برفع نسخة احتياطية بحاوية تجريبية للتأكد من ظهور كافة اللوحات بنجاح

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

  • ترك السيرفر بدون تسجيل فوري بعد التثبيت مما يسمح لأي زائر خارجي بإنشاء الحساب الأول والاستيلاء على رتبة المشرف
  • كتابة رابط `ROOT_URL` بشكل خاطئ في ملف `.env` مما يسبب تعطل اتصالات الـ WebSocket وفشل سحب البطاقات
  • عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب مسح كافة اللوحات والمهام عند تحديث الحاوية
  • التشغيل خلف وكيل عكسي بدون تفعيل ترويسات الـ WebSockets مما يعطل التحديث الفوري للبطاقات بين المتصفحات
  • ترك التسجيل العام متاحاً على سيرفر متصل بالإنترنت العام

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

  • حركة البطاقات لا تتحدث فورياً بين المستخدمين — تأكد من تفعيل ترقية الـ WebSockets في إعدادات الوكيل العكسي (Nginx: `proxy_set_header Upgrade $http_upgrade`)
  • ظهور خطأ 502 Bad Gateway في الواجهة — انتظر 30 ثانية لاكتمال إقلاع MongoDB وراجع السجلات: `docker logs wekan -f`
  • روابط المرفقات والصور مكسورة — تأكد من تطابق `ROOT_URL` تماماً مع الرابط الذي تكتبه بالمتصفح (مثل `https://wekan.example.com`)
  • تعذر تسجيل حساب جديد — تأكد من تفعيل التسجيل من لوحة المشرف Admin Panel أو ضبط `WITH_REGISTRATION=true`
  • فشل الاتصال بقاعدة البيانات — تأكد من عمل حاوية `wekan-db` وصحة صلاحيات المجلد

البدائل

منصة Planka البسيطة والعصرية للوحات كانبان. منصة Taiga لإدارة المشاريع بمنهجيات Agile وسبرنت. منصة Vikunja لإدارة المهام والقوائم. تطبيق Nextcloud Deck المدمج بسحابة نكست كلاود. منصة Trello السحابية التجارية.

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

تجنب استخدام WeKan إذا كنت تبحث فقط عن قائمة مهام ومشتريات شخصية بسيطة (حيث يعد Vikunja أو Memos أخف وأسرع). وإذا كنت تحتاج لمخططات جانت معقدة وتتبع عميق لمشاكل البرمجيات والـ Commits، فإن منصات Taiga أو Redmine مخصصة لدورات التطوير المعقدة.

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

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

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

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

ما هي منصة WeKan وما الفرق بينها وبين Trello؟

تعد WeKan لوحة كانبان مفتوحة المصدر ومستضافة ذاتياً. تقدم نفس تجربة سحب وإفلات البطاقات التفاعلية الموجودة في Trello، مع إضافة ميزات متقدمة مثل المسارات الأفقية (Swimlanes)، والمهام الفرعية، والخصوصية التامة بدون أي رسوم تراخيص.

هل يمكنني استيراد لوحاتي القديمة من Trello إلى WeKan؟

نعم! قم بتصدير لوحتك من Trello كملف JSON، ثم افتح WeKan واضغط على '+ Add Board' ← 'Import' ← 'Trello' وارفع الملف. وسيتم استيراد كافة القوائم والبطاقات وقوائم التحقق والمرفقات تلقائياً.

لماذا يعد متغير ROOT_URL بالغ الأهمية في WeKan؟

تم بناء WeKan على منصة Meteor.js وبروتوكول WebSockets. ويجب أن يطابق متغير `ROOT_URL` الرابط والبروتوكول والمنفذ المستخدم في متصفحك بدقة (مثل `http://ip-سيرفرك:8080`) لضمان عمل مزامنة البطاقات الفورية.

كيف يتم إنشاء حساب المشرف العام في WeKan؟

يُمنح أول حساب مستخدم يتم تسجيله على سيرفر WeKan الجديد صلاحيات المشرف العام (Server Administrator) تلقائياً. لذلك احرص على تسجيل حسابك فور اكتمال التثبيت مباشرة.

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

تستهلك منظومة WeKan (تطبيق Node.js مع قاعدة MongoDB) عادة ما بين 250 إلى 600 ميجابايت فقط من الذاكرة العشوائية داخل Docker، مما يجعلها سريعة وخفيفة على السيرفر.