استضافة Excalidraw على VPS: لوح تعاوني مفتوح المصدر

لماذا تستضيف Excalidraw بنفسك بدلاً من النسخة العامة

الفوائد الملموسة

• لا رسوم برمجية — المكوّنان (الواجهة وخادم التعاون) برخصة MIT. تدفع مقابل VPS فقط.
• سرية النماذج — تبقى جلسات الرسم على بنيتك التحتية ولا يمر أي ملف تصميم عبر طرف ثالث.
• التحكم في الوصول — قائمة IP أو SSO‏ OIDC أو HTTP Basic Auth أمام nginx حسب مستوى العزل المطلوب.
• جلسات وأعضاء غير محدودين — لا سقف يفرضه الخطة؛ الحد الوحيد هو ذاكرة RAM للخادم، وخادم excalidraw-room خفيف الوزن.
• استمرارية اختيارية — ربط وحدة تخزين Docker أو حاوية S3 متوافقة لأرشفة اللوحات المصدَّرة بصيغة JSON.
• التكامل مع مجموعة الأدوات المستضافة ذاتياً — Excalidraw إلى جانب Penpot وMattermost وDocmost يُغلق محيط SaaS لوكالة بأكملها.

البنية: حاويتان بأدوار مختلفة

المتطلبات الأساسية

قائمة التحقق من المتطلبات

• خادم VPS بما لا يقل عن 1 نواة و512 ميغابايت RAM (يُوصى بـ 1 غيغابايت للفريق).
• Docker Engine وإضافة Docker Compose مثبَّتان (للتحقق: docker compose version).
• اسم نطاق مُوجَّه نحو IP الخادم — بدون TLS تُحجب WebSockets في المتصفحات الحديثة.
• وصول SSH بصلاحيات root أو مستخدم بصلاحيات sudo.
• شهادة TLS صالحة — يهيئ ServOrbit Let's Encrypt تلقائياً.

نشر Excalidraw في 5 خطوات

1. 01

   إنشاء VPS وتثبيت Docker

   شغّل VPS Ubuntu 24.04 من لوحة تحكم ServOrbit. بعد الاتصال عبر SSH، إن لم يكن Docker مثبتاً بعد، شغّل:

   curl -fsSL https://get.docker.com | sh

   تحقق من استجابة Docker Compose Plugin قبل المتابعة:

   docker compose version

2. 02

   بناء الصورة مع رابط التعاون الخاص بك

   انسخ المستودع الرسمي ثم ابنِ الصورة مع استبدال نطاقك. استبدل collab.yourdomain.com بالنطاق الفرعي الذي تخصصه لـ excalidraw-room:

   git clone https://github.com/excalidraw/excalidraw.git
   cd excalidraw
   docker build \
     --build-arg VITE_APP_WS_SERVER_URL=wss://collab.yourdomain.com \
     -t my-excalidraw:latest .

   تُدمج هذه الخطوة عنوان خادم WebSocket في حزمة JavaScript. إن غيّرت النطاق لاحقاً ستحتاج إلى إعادة البناء.

3. 03

   كتابة ملف docker-compose.yml

   أنشئ مجلد عمل وضع الملف التالي. تستمع الخدمتان داخلياً؛ nginx (الخطوة التالية) هو نقطة الدخول العامة الوحيدة:

   mkdir ~/excalidraw-stack && cd ~/excalidraw-stack

   محتوى docker-compose.yml:

   services:
     excalidraw:
       image: my-excalidraw:latest
       restart: unless-stopped
       networks:
         - excalidraw
   
     excalidraw-room:
       image: excalidraw/excalidraw-room:latest
       restart: unless-stopped
       networks:
         - excalidraw
   
   networks:
     excalidraw:

   شغّل المجموعة:

   docker compose up -d

4. 04

   إعداد nginx مع ترويسات WebSocket

   هذه الخطوة هي المكان الذي تفشل فيه معظم عمليات النشر بصمت: بدون ترويستَي Upgrade وConnection، يفتح المتصفح اتصالاً HTTP عادياً بدلاً من WebSocket، وتبدو ميزة التعاون كأنها لا تعمل دون أي رسالة خطأ.

   كتلة nginx للواجهة الأمامية لـ ‎Excalidraw (draw.yourdomain.com):

   server {
       listen 443 ssl;
       server_name draw.yourdomain.com;
   
       location / {
           proxy_pass http://excalidraw:80;
           proxy_set_header Host $host;
       }
   }

   كتلة nginx لخادم الغرفة (collab.yourdomain.com):

   server {
       listen 443 ssl;
       server_name collab.yourdomain.com;
   
       location / {
           proxy_pass http://excalidraw-room:80;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection "upgrade";
           proxy_set_header Host $host;
           proxy_read_timeout 86400s;
       }
   }

   أعِد تحميل nginx (nginx -s reload) بعد وضع الكتل.

5. 05

   اختبار التعاون في الوقت الفعلي

   افتح https://draw.yourdomain.com في علامتَي تبويب أو متصفحَين مختلفَين. انقر على Live collaboration في شريط الأدوات وأنشئ جلسة. انسخ رابط الجلسة في علامة التبويب الثانية.

   ارسم شيئاً في علامة التبويب الأولى: يجب أن تظهر اللمسة في الثانية فوراً. إن لم تظهر، تحقق أولاً من ترويسات WebSocket في nginx (تُظهر أدوات الشبكة في المتصفح إن كان الاتصال قد ارتقى إلى 101 Switching Protocols).

Excalidraw المستضاف ذاتياً مقابل بدائل SaaS

مرّر الجدول أفقيًا

للمزيد: SSO وقوائم IP المسموح بها

allow 203.0.113.0/24;
allow 198.51.100.42;
deny all;

التكامل مع مجموعة الأدوات المستضافة ذاتياً