🎨 تثبيت Penpot — بديل Figma مفتوح المصدر لتصميم الواجهات والنماذج الأولية على Docker

نشر منصة Penpot على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لتصميم واجهات وتجارب المستخدم (UI/UX) والبديل الحر لـ Figma مع دعم معايير SVG وشبكات CSS Grid والعمل الجماعي اللحظي.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Penpot على المنفذ 9009 مع قاعدة بيانات PostgreSQL 15 وذاكرة Redis وحفظ دائم للمشاريع.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/penpot/penpot-ubuntu.sh

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

chmod +x penpot-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين لقاعدة البيانات والملفات (`./db` و`./assets`) وتشغيل حاويات الواجهة الأمامية لـ Penpot (منفذ 9009) والواجهة الخلفية ومحرك التصدير وقاعدتي PostgreSQL 15 وRedis.

sudo bash penpot-ubuntu.sh

4 إنشاء الحساب والبدء في التصميم

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:9009. أنشئ حساب المشرف، واضبط مساحة عمل فريقك، وابدأ في دعوة المصممين والمطورين للتعاون التفاعلي.

http://<your-server-ip>:9001

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

المنفذالغرض
9001Penpot Frontend (Web UI)
6379Redis (internal only)
5432PostgreSQL (internal only)

نظرة عامة

تعد Penpot أول منصة ويب مفتوحة المصدر لتصميم وتطوير واجهات المستخدم (UI/UX) وبناء النماذج التفاعلية (Prototypes) مصممة خصيصاً للفرق متعددة التخصصات. تعمل المنصة على المنفذ 9009 (واجهة الويب) مدعومة بخدمات مصغرة وقاعدتي PostgreSQL وRedis، وتعتمد أصلياً على معايير الويب القياسية المفتوحة (SVG). وتتميز المنصة بدمج أنظمة تخطيط CSS Flexbox وCSS Grid الحقيقية في أدوات التصميم، مما يردم الفجوة تماماً بين المصممين والمطورين مع دعم التعاون اللحظي متعدد المستخدمين على نفس مساحة العمل داخل خوادمك الخاصة.

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

تفرض منصات التصميم التجارية (مثل Figma وAdobe XD وSketch) اشتراكات شهرية باهظة لكل مصمم، وتخزن تصميمات ونماذج منتجاتك السرية على خوادم سحابية خارجية بصيغ مغلقة. تمنحك الاستضافة الذاتية لـ Penpot السيادة الكاملة على بياناتك وملفاتك، مع عدد غير محدود من المصممين والمشاريع بدون أي تكاليف تراخيص، وتصدير مباشر بصيغة SVG المفتوحة ونظام محاذاة يطابق أكواد CSS تماماً.

متى تحتاجه

  • تحتاج فرق التصميم والبرمجة لمساحة عمل تشاركية لتصميم النماذج التفاعلية في الوقت الفعلي دون دفع رسوم اشتراك لكل مستخدم
  • تلتزم بحفظ خصوصية وسرية تصميمات المنتجات الجديدة والشاشات على خوادمك الداخلية (On-Premises)
  • تريد مكونات تصميم تحاكي أنظمة CSS Grid وFlexbox الواقعية لتسهيل تحويل التصميم إلى كود برمجي للمطورين
  • تبحث عن منصة مفتوحة تعتمد على معايير الفيكتور المفتوحة (SVG) بدلاً من الصيغ الاحتكارية المغلقة
  • ترغب في عدد غير محدود من مساحات العمل والمكتبات ومكونات التصميم المشتركة دون قيود الباقات المدفوعة

من يحتاجه

  • مصممو واجهات وتجربة المستخدم (UI/UX) لبناء شاشات التطبيقات والمواقع والنماذج الأولية التفاعلية
  • مطورو الواجهات الأمامية (Frontend) لفحص قيم CSS والخطوط والمسافات واستخراج أيقونات SVG
  • مديرو المنتجات والوكالات الرقمية لتقديم نماذج تفاعلية حية وقابلة للنقر للعملاء وأصحاب المصلحة
  • المؤسسات والشركات الحريصة على الخصوصية والسيادة الرقمية لملفات التصميم والهوية
  • أصحاب السيرفرات المنزلية والمطورون الباحثون عن ستوديو تصميم متكامل ومستقل

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

  • تصميم واجهات تطبيقات ومواقع متجاوبة بالكامل بالاعتماد على حاويات CSS Grid وFlexbox المدمجة
  • بناء مكتبات تصميم موحدة (Design Systems) بمكونات قابلة لإعادة الاستخدام مع المتغيرات والألوان والخطوط
  • إنشاء نماذج تفاعلية قابلة للنقر تحاكي التطبيقات الحقيقية مع المؤثرات البصرية لاختبار تجربة المستخدم
  • العمل التشاركي اللحظي لعدة مصممين على نفس اللوحة مع رؤية مؤشرات الماوس الملونة وملاحظات الفريق
  • استخراج وتصدير أيقونات SVG نقية وتنسيقات CSS جاهزة للنسخ واستخدامها في مشاريع React وVue

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

  • اعتماد كامل على معايير SVG: حفظ كافة العناصر والمنحنيات والنصوص كمتجهات قياسية مفتوحة
  • محركات محاذاة CSS Grid وFlexbox: تصميم عناصر واجهات تتصرف وتتجاوب تماماً كما في أكواد CSS الحقيقية
  • تعاون لحظي متعدد المستخدمين: يعمل الفريق في نفس اللحظة على نفس اللوحة مع تتبع المؤشرات المباشرة
  • نماذج أولية تفاعلية: ربط الشاشات بمحفزات النقر والحركات الانتقالية لاختبار تجربة الاستخدام
  • مكتبات مكونات وأصول مشتركة: نشر حزم المكونات عبر مشاريع الفريق مع التحديث التلقائي للتغييرات
  • وضع فحص المطورين: فحص المسافات وأكواد الألوان والخطوط ونسخ أكواد CSS الجاهزة بنقرة واحدة
  • معمارية خدمات مصغرة تشمل محرك Exporter معتمد على Chromium لتصدير ملفات PDF وPNG عالية الدقة
  • معمارية Docker Compose تجمع Penpot مع PostgreSQL 15 وRedis 7 ومجلدات التخزين الدائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:9009 لعرض صفحة تسجيل الدخول
  • اضغط على 'Create Account' لإنشاء حساب المشرف الأساسي
  • اضبط إعدادات خادم البريد SMTP في ملف `config.env` إذا كنت ترغب في تفعيل روابط الدعوة عبر البريد
  • أنشئ مساحة عمل فريقك الأولى (Team Workspace) وابدأ مشروعك الجديد على اللوحة اللانهائية
  • استكشف أدوات CSS Grid وFlexbox في الشريط الجانبي الأيمن للتحكم في مرونة العناصر
  • ضع Penpot خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة للاستخدام في الإنتاج
  • ادعُ المصممين والمطورين لمساحة العمل عبر روابط الدعوة المباشرة

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

  • سجل حساب المشرف الأساسي فور تشغيل الحاويات لحماية المنصة
  • تنبيه أمني هام: استخدم تشفير HTTPS دائماً عبر شهادة SSL — حيث تشترط المتصفحات HTTPS لنسخ الحافظة وقنوات WebSockets
  • أبقِ منافذ PostgreSQL (5432) وRedis (6379) معزولة داخل شبكة Docker ولا تكشفها للإنترنت العام
  • عطل التسجيل العام المفتوح للغرباء في حال قصر السيرفر على فريقك الداخلي فقط
  • احمِ مجلدي `./db` و`./assets` اللذين يحتويان على ملفات المشاريع والصور المرفوعة بصلاحيات مناسبة
  • حدّث صور حاويات penpotapp دورياً للحصول على الميزات والتحديثات الأمنية المستمرة

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

يقدم Penpot واجهته عبر منفذ TCP 9009 (المحول من 8080 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترويسات ترقية WebSocket ووجهه لمنفذ 9009، مع إبقاء المنفذ 9009 مغلقاً في جدار الحماية الخارجي وفتح المنفذين 80 و443 للزوار.

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

  • انسخ مجلد `./db` احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL بكافة المشاريع واللوحات ومكتبات المكونات
  • انسخ مجلد `./assets` لحفظ كافة الصور المرفوعة والخطوط المخصصة والوسائط
  • استخرج نسخة احتياطية دورية لقاعدة البيانات عبر pg_dump: `docker exec penpot-db pg_dump -U penpot penpot > penpot_backup.sql`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • اختبر الاستعادة باسترجاع نسخة البيانات في حاوية تجريبية للتأكد من فتح كافة اللوحات والتصميمات بنجاح

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

  • تشغيل Penpot على سيرفر برامات أقل من 4 جيجابايت (حيث تتطلب الواجهة الخلفية ومحرك Exporter ذاكرة كافية)
  • نسيان تفعيل ترويسات ترقية قنوات WebSockets في الوكيل العكسي، مما يسبب فشل التعاون اللحظي المباشر
  • ترك التسجيل المفتوح متاحاً في خادم عام متصل بالإنترنت، مما يسمح للغرباء بإنشاء حسابات واستهلاك الموارد
  • عدم ربط مجلدات التخزين الدائم `./db` و`./assets`، مما يسبب فقدان المشاريع بالكامل عند تحديث الحاوية
  • التشغيل عبر بروتوكول HTTP غير المشفر مما يسبب مشاكل في تحميل الخطوط ونسخ العناصر للحافظة

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

  • فشل مزامنة التعاون اللحظي — تأكد من تفعيل `Upgrade $http_upgrade` و`Connection 'upgrade'` في إعدادات الوكيل العكسي Nginx
  • فشل تصدير ملفات PNG وPDF — افحص سجلات حاوية Exporter بالأمر: `docker logs penpot-exporter -f`
  • رسائل البريد لا تصل — راجع إعدادات SMTP وخادم الإرسال في ملف `config.env`
  • ظهور خطأ 502 Bad Gateway — افحص حالة الحاويات بالأمر `docker ps` وراجع سجلات الواجهة الخلفية `docker logs penpot-backend -f`
  • نسيان كلمة مرور المشرف — أعد تعيين كلمة المرور عبر سطر أوامر Clojure داخل حاوية backend

البدائل

برنامج Figma المنصة التجارية الرائدة في تصميم الواجهات. تطبيق Adobe XD أداة أدوبي لتصميم النماذج. برنامج Lunacy تطبيق تصميم مكتبي خفيف. أدوات Excalidraw وDraw.io لتخطيط المخططات والرسوم البيانية البسيطة. برنامج Inkscape لرسوميات الفيكتور المكتبية.

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

تجنب استخدام Penpot إذا كنت تبحث فقط عن لوحة بيضاء بسيطة وسريعة لرسم المخططات الهندسية السريعة وعصف الأفكار (حيث تعد Excalidraw أو Draw.io أخف بكثير). وإذا كنت تحتاج لتصميم مطبوعات تجارية ضخمة بدقة ألوان الطباعة CMYK، فإن Inkscape أو Adobe Illustrator مخصصان للطباعة.

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

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

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

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

كم عدد الحاويات التي يحتاجها Penpot للعمل؟

يعمل Penpot كحزمة متكاملة من 5 حاويات: `penpot-frontend` (الواجهة)، `penpot-backend` (المحرك البرمجي)، `penpot-exporter` (محرك تصدير PDF/PNG عبر Chromium)، `penpot-db` (قاعدة PostgreSQL 15)، و`penpot-redis` (الذاكرة الوسيطة).

هل يمكن لـ Penpot استيراد ملفات Figma؟

نعم! يوفر Penpot إضافة رسمية للتحويل من Figma إلى Penpot، كما يدعم استيراد ملفات الفيكتور القياسية SVG مباشرة إلى اللوحة.

ما هو المنفذ الافتراضي لتشغيل Penpot؟

يتم توجيه واجهة Penpot عبر المنفذ 9009 (أو 9001 حسب التكوين) على السيرفر، والذي يحول الطلبات لمنفذ 8080 الداخلي للحاوية.

هل يدعم Penpot العمل الجماعي التشاركي في الوقت الفعلي؟

نعم! يدعم Penpot التحرير الجماعي اللحظي الأصلي، حيث يرى جميع أعضاء الفريق مؤشرات ماوس بعضهم الحية والتعديلات الفورية على نفس الملف.

هل يمكن تصدير التصميمات بصيغة SVG وPDF؟

نعم، يتيح Penpot تصدير أي عنصر أو لوحة أو مشروع كامل كملفات فيكتور SVG نقية، أو صور PNG عالية الدقة، أو مستندات PDF متعددة الصفحات.