تثبيت Kasm Workspaces على VPS لينكس (Ubuntu)

يبث Kasm Workspaces أسطح مكتب ومتصفحات داخل حاويات إلى متصفحك الخاص، فتستطيع فتح Chrome للاستخدام لمرة واحدة أو سطح مكتب لينكس كاملاً من أي مكان. على VPS لينكس من Infrawire تُعد نسخة الخادم الواحد (single server) أبسط طريقة لتشغيله. يستهدف هذا الدليل Ubuntu 24.04 (ويعمل Ubuntu 22.04 بالطريقة نفسها).

📋 المتطلبات

• خادم VPS جديد من نوع KVM بنظام Ubuntu ووصول SSH بصلاحية root ودون أي خدمة أخرى تستمع على المنفذ 443. ستجد عنوان IP وكلمة مرور root الخاصة بالـ VPS في منطقة العميل.
• يوصي Kasm بنواتين على الأقل من المعالج و4 غيغابايت من الذاكرة و50 غيغابايت من تخزين SSD للتثبيت الأساسي، وتحتاج كل مساحة عمل قيد التشغيل إلى ذاكرة إضافية. خطّط لذاكرة أكبر إذا اتصل عدة مستخدمين في وقت واحد.
• نطاق مثل kasm.example.com يشير إلى VPS_IP إذا أردت شهادة HTTPS موثوقة.

🔄 1. تجهيز الخادم

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl

يثبّت Kasm برنامج Docker بنفسه، لذلك لا تضبط بيئة حاويات أخرى مسبقاً. أعد التشغيل إذا ثُبّتت نواة جديدة.

⬇️ 2. تنزيل أحدث إصدار

يتغير رقم الإصدار بانتظام، فلا تنسخه من شرح قديم. افتح صفحة التنزيل الرسمية (https://kasmweb.com/downloads) أو دليل تثبيت single server (https://kasmweb.com/docs/latest/install/single_server_install.html)، وانسخ رابط أرشيف الإصدار الحالي الخاص بمثبّت single server واستخدمه بدلاً من RELEASE_URL أدناه.

Bash
1cd /tmp
2curl -O RELEASE_URL
3tar -xf kasm_release_*.tar.gz

يُفك الأرشيف في مجلد kasm_release الذي يحتوي على install.sh.

⚙️ 3. التثبيت مع مساحة swap كافية

تستهلك مساحات العمل ذاكرة كبيرة، ويحمي swap الخادم من إنهاء العمليات المفاجئ بسبب نفاد الذاكرة. يستطيع المثبّت إنشاء ملف swap لك بالخيار --swap-size (بالميغابايت):

Bash
1sudo bash /tmp/kasm_release/install.sh --swap-size 4096

إذا كان المنفذ 443 مشغولاً فأضف -L 8443 لتقديم واجهة الويب على المنفذ 8443. ينزّل التثبيت عدة صور Docker ويستغرق من 10 إلى 20 دقيقة. في النهاية يعرض السكربت كلمات المرور المولّدة للحسابين الافتراضيين admin@kasm.local وuser@kasm.local. احفظها فوراً؛ فهي تظهر مرة واحدة فقط.

🌐 4. فتح لوحة الويب

افتح https://VPS_IP (أو https://VPS_IP:8443 إذا غيّرت المنفذ). اقبل تحذير الشهادة الموقّعة ذاتياً في الوقت الحالي. سجّل الدخول بحساب admin@kasm.local للوصول إلى منطقة الإدارة، وغيّر كلمات المرور المولّدة من قائمة المستخدم.

إذا كنت تستخدم جدار حماية فاسمح بمنفذ الويب:

Bash
1ufw allow 22/tcp
2ufw allow 443/tcp
3ufw enable

اسمح بـ SSH قبل تفعيل UFW حتى لا تحبس نفسك خارج الخادم.

🔒 5. إضافة شهادة Let's Encrypt

يقدّم Kasm شهادته الخاصة عبر وكيل Nginx داخلي. اطلب شهادة بواسطة Certbot في وضع standalone، وهو يتطلب أن يكون المنفذ 80 فارغاً (لا يستخدمه Kasm)، ثم انسخها إلى المكان الذي يتوقعه Kasm:

Bash
1apt -y install certbot
2certbot certonly --standalone -d kasm.example.com
3cp /etc/letsencrypt/live/kasm.example.com/fullchain.pem /opt/kasm/current/certs/kasm_nginx.crt
4cp /etc/letsencrypt/live/kasm.example.com/privkey.pem /opt/kasm/current/certs/kasm_nginx.key
5/opt/kasm/bin/stop
6/opt/kasm/bin/start

مدة الشهادات 90 يوماً، لذا كرّر النسخ وإعادة التشغيل بعد كل تجديد، مثلاً عبر deploy hook لـ Certbot في /etc/letsencrypt/renewal-hooks/deploy/.

🚀 6. تشغيل متصفح معزول

سجّل الدخول بحساب مستخدم عادي (user@kasm.local) فتعرض صفحة Workspaces الصور المتاحة. إذا كانت القائمة فارغة فادخل كمدير وافتح Workspaces > Registry وثبّت الصور التي تريدها، مثل Chrome أو Firefox أو سطح مكتب Ubuntu. ثم انقر على مساحة عمل لتشغيلها: تفتح علامة تبويب جديدة تعرض سطح مكتب كاملاً أو متصفحاً مبثوثاً إليك، مع عناصر تحكم في الحافظة ونقل الملفات في اللوحة الجانبية. عند إغلاق الجلسة تُدمَّر الحاوية.

✅ 7. التحقق

Bash
1docker ps --format '{{.Names}}: {{.Status}}'
2ss -tlnp | grep -E ':(443|8443)\b'
3free -h

يجب أن ترى حاويات kasm_* قيد التشغيل ومنفذ الويب في وضع الاستماع ووجود swap في مخرجات free -h.

🧰 استكشاف الأخطاء

• يتوقف المثبّت بخطأ في الذاكرة أو القرص: افحص free -h وdf -h. أضف swap بالخيار --swap-size وحرّر مساحة على القرص ثم أعد تشغيل المثبّت.
• تبقى مساحة العمل على شاشة التحميل: غالباً ينقص الخادم ذاكرة أو أن الصورة لم تُنزَّل كاملة. افحص docker ps -a والسجلات في /opt/kasm/current/log/ وأغلق الجلسات الأخرى.
• يحذّر المتصفح من الشهادة: لم تُستبدل الملفات في /opt/kasm/current/certs/ أو لم تُعد الخدمات التشغيل. كرّر الخطوة 5 واستخدم اسم النطاق وليس عنوان IP في شريط العنوان.
• ضياع كلمة مرور المدير: أعد تعيينها من منطقة الإدارة بحساب مدير آخر، أو أعد التثبيت على VPS نظيف إذا لم يبقَ أي مدير.

---

🎉 Kasm Workspaces يعمل الآن: شغّل المتصفحات وأسطح المكتب عند الطلب، معزولة بأمان عن جهازك.