💻 تثبيت Sshwifty — عميل الطرفية والاتصال بـ SSH وTelnet عبر المتصفح على Docker

نشر منصة Sshwifty على Ubuntu باستخدام Docker — عميل الويب مفتوح المصدر فائق الخفة للاتصال بخوادم SSH وشبكات Telnet مباشرة من المتصفح عبر WebSockets على المنفذ 8141.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Sshwifty على المنفذ 8141 مع بث WebSockets وتخزين إعدادات الاتصال جاهزاً.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/remote-access/sshwifty/sshwifty-ubuntu.sh
chmod +x sshwifty-ubuntu.sh
sudo bash sshwifty-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/remote-access/sshwifty/sshwifty-ubuntu.sh

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

chmod +x sshwifty-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للإعدادات (`./config`) وتشغيل حاوية Sshwifty الرسمية على المنفذ 8141 (المحول من 8182 الداخلي).

sudo bash sshwifty-ubuntu.sh

4 الاتصال وفتح الطرفية بالمتصفح

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8141. اتصل بأي سيرفر أو راوتر عبر SSH أو Telnet، واستخدم المفاتيح المشفرة أو كلمات المرور لإدارة الخوادم من أي جهاز دون برامج طرفية محلية.

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

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

المنفذالغرض
8141Web Terminal + WebSocket (host → container 8182)

نظرة عامة

تعد Sshwifty بوابة وعميلاً طرفياً حديثاً ومفتوح المصدر للاتصال ببروتوكولات SSH وTelnet عبر المتصفح مباشرة. تم بناؤها بلغة Go وVue.js لتصل المتصفحات بالخوادم البعيدة وسويتشات الشبكات عبر بروتوكول WebSocket منخفض التأخير. تعمل المنصة عبر المنفذ 8141 (المحول من 8182 الداخلي)، وتوفر محاكي طرفية متكاملاً يدعم ألوان ANSI، ومحاكاة xterm-256color، والمصادقة بمفاتيح SSH الخاصة، والوساطة عبر بروكسيات SOCKS5، مع حفظ اختصارات الاتصال بالخوادم دون تثبيت أي برامج أو إضافات بالمتصفح.

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

عند السفر أو العمل من أجهزة لوحية (iPads) أو حواسيب Chromebook أو شبكات الشركات الصارمة التي تحظر منفذ SSH 22 الصادر، يصبح الوصول للخوادم مستحيلاً. تقوم Sshwifty بتحويل اتصالات SSH التفاعلية إلى حركة مرور ويب عادية عبر HTTPS: مما يتيح لك إدارة خوادم لينكس من أي متصفح عبر منفذ الويب 443، دون تخزين أي كلمات مرور أو مفاتيح خاصة على السيرفر الوسيط.

متى تحتاجه

  • تحتاج إلى الدخول بسيرفراتك عبر SSH من متصفحات الهواتف، والأجهزة اللوحية (iPad)، وحواسيب Chromebook
  • تعمل خلف جدران حماية صارمة أو شبكات فنادق تحظر منفذ SSH 22 الصادر
  • تبحث عن طرفية ويب مفتوحة المصدر وخفيفة جداً تعالج مفاتيح التشفير محلياً بمتصفحك
  • تريد إدارة سويتشات الشبكات القديمة وأجهزة الراوتر عبر بروتوكول Telnet من واجهة ويب عصرية
  • تحتاج إلى بوابة طرفية مركزية آمنة تتيح توجيه جلسات SSH عبر بروكسيات SOCKS5 الداخلية

من يحتاجه

  • مديرو الأنظمة ومهندسو الـ DevOps لإدارة البنية التحتية السحابية أثناء التنقل من الهواتف والأجهزة اللوحية
  • مهندسو الشبكات لتهيئة راوترات Cisco وMikrotik وJuniper عبر بروتوكولات Telnet وSSH من المتصفح
  • مهندسو الاستجابة للطوارئ (SRE) لحل أعطال السيرفرات العاجلة من أي حاسوب غير مخصص للعمل
  • الطلاب والباحثون للدخول على السيرفرات والمعامل الجامعية من حواسيب المدارس المقفلة
  • أصحاب السيرفرات المنزلية لتوفير وصول طرفي آمن وسريع لسيرفرات المنزل عبر أنفاق Cloudflare

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

  • فتح طرفية طارئة لصلاحية Root بسيرفر Ubuntu من متصفح سفاري على الآيباد أثناء السفر
  • تجاوز حظر منافذ الـ SSH بشبكات العمل بتمرير الجلسات كحركة مرور WebSockets عبر منفذ HTTPS
  • الاتصال بأجهزة وسويتشات الشبكة القديمة ببروتوكول Telnet عبر بوابة Docker المركزية
  • حفظ خوادمك وعناوين السيرفرات في ملف `sshwifty.conf.json` للدخول عليها بنقرة زر واحدة
  • توفير وصول طرفي مؤقت للمطورين الجدد دون الحاجة لتزويدهم ببيانات شبكة الـ VPN الخاصة

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

  • طرفية متكاملة داخل المتصفح: محاكاة xterm.js مع دعم 256 لوناً وتمرير الفأرة والنسخ واللصق
  • دعم متعدد البروتوكولات: الاتصال بالسيرفرات ببروتوكول SSH (منفذ 22) أو بروتوكول Telnet الكلاسيكي (منفذ 23)
  • انعدام تخزين المفاتيح بالسيرفر: تتم معالجة المفاتيح الخاصة وكلمات المرور داخل المتصفح ولا تحفظ بالقرص نهائياً
  • بث فوري عبر WebSockets: استجابة فائقة السرعة للأوامر ونقل فوري للنصوص بدون أي تأخير
  • حفظ اختصارات الخوادم: إمكانية تهيئة قائمة بالخوادم وأسماء المستخدمين في ملف `sshwifty.conf.json`
  • توجيه عبر بروكسي SOCKS5: إمكانية تمرير اتصالات الـ SSH عبر خوادم وسيطة لعزل الشبكات
  • ملف تنفيذي فائق الخفة بـ Go: إقلاع فوري واستهلاك ضئيل جداً للذاكرة العشوائية
  • معمارية Docker Compose تجمع Sshwifty مع ربط مجلد `./config` لحفظ إعدادات الخوادم والسياسات

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8141 لعرض واجهة Sshwifty
  • اضغط على زر '+' واختر 'SSH'، واكتب IP السيرفر المستهدف (مثل `192.168.1.50`)، والمنفذ `22`، واسم المستخدم
  • الصق مفتاح SSH الخاص أو اكتب كلمة المرور، واضغط 'Connect' لتفتح الطرفية مباشرة بالمتصفح
  • عدل ملف `./config/sshwifty.conf.json` لإضافة اختصارات سيرفراتك أو تقييد نطاقات العناوين المسموحة
  • ضع Sshwifty خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع دعم WebSockets ومصادقة بكلمة مرور
  • أعد تشغيل الحاوية: `docker restart sshwifty` لتطبيق تعديلات ملف الإعدادات

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

  • تنبيه أمني حاسم: استخدم تشفير HTTPS دائماً في الإنتاج — لتشفير كلمات مرور SSH والمفاتيح الخاصة المنقولة بالمتصفح
  • احمِ واجهة الويب بوضع كلمة مرور عبر Nginx Basic Auth؛ حيث لا يحتوي Sshwifty على شاشة تسجيل دخول متعددة المستخدمين
  • اضبط قيود الاتصال في `sshwifty.conf.json` لمنع استغلال السيرفر كوسيط اختراق مفتوح للإنترنت
  • لا تكشف المنفذ 8141 للإنترنت العام مباشرة دون حماية الوكيل العكسي
  • احمِ مجلد الإعدادات `./config` بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات محاكي الطرفية

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

يقدم Sshwifty واجهة الويب ونفق WebSocket عبر منفذ TCP 8141 (المحول من 8182 الداخلي). يجب السماح بالمنفذ 8141 في جدار الحماية للشبكة المحلية (`ufw allow 8141/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترويسات WebSocket ووجهه لمنفذ 8141، مع إبقاء المنفذ 8141 مغلقاً خارجياً.

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

  • انسخ مجلد `./config` احتياطياً، والذي يحتوي على ملف `sshwifty.conf.json` (الخوادم المحفوظة وإعدادات البروكسي)
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على المنافذ ومسارات التخزين
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد الإعدادات بحاوية تجريبية للتأكد من استرجاع اختصارات الخوادم بنجاح

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

  • التشغيل في الإنتاج عبر بروتوكول HTTP غير المشفر مما يسرب كلمات المرور والمفاتيح الخاصة عبر الشبكة
  • نسيان تفعيل ترويسات WebSocket في Nginx مما يسبب انقطاع الطرفية فور محاولة الاتصال
  • ترك سياسة الاتصال مفتوحة لكافة العناوين (`Any`) على منفذ ويب متاح للعامة
  • عدم ربط مجلد التخزين الدائم `./config`، مما يسبب فقدان الخوادم المحفوظة عند تحديث الحاوية
  • كشف المنفذ 8141 مباشرة للإنترنت العام بدون كلمة مرور لحماية الواجهة

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

  • الطرفية تنقطع فور فتحها — تأكد من إضافة ترويسة `proxy_set_header Upgrade $http_upgrade;` في إعدادات Nginx
  • فشل الاتصال بـ SSH — تأكد من تشغيل خادم SSH بالسيرفر المستهدف وإمكانية الوصول إليه من شبكة Docker
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs sshwifty -f`
  • فشل الدخول بالمفتاح الخاص — تأكد من أن المفتاح بصيغة OpenSSH أو PEM القياسية وبدون خوارزميات غير مدعومة
  • تعذر الاتصال بالسيرفر المضيف — استخدم IP شبكة الدوكر (مثل `172.17.0.1`) أو IP السيرفر بالشبكة بدلاً من `localhost`

البدائل

بوابة Apache Guacamole الشاملة لـ RDP وVNC وSSH. أداة Wetty للطرفية المحلية. منصة Teleport المؤسسية للأمان الصفري. خدمة Cloudflare Access SSH السحابية. برامج PuTTY وOpenSSH المكتبية.

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

تجنب استخدام Sshwifty إذا كنت تحتاج للوصول إلى واجهات سطح مكتب رسومية كاملة عبر RDP أو VNC لأنظمة Windows أو macOS (حيث صُممت Apache Guacamole أو RustDesk للواجهات الرسومية). وإذا كنت تحتاج لمنظومة أمان مؤسسية عملاقة تسجل جلسات الفيديو للموظفين وتتحكم بالشهادات لآلاف الخوادم، فإن Teleport أكثر تخصصاً.

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

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

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

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

هل يقوم Sshwifty بحفظ مفاتيح SSH الخاصة أو كلمات المرور بالسيرفر؟

لا! تم تصميم Sshwifty بأعلى معايير الأمان المحلية. وتتم معالجة المفاتيح وكلمات المرور داخل ذاكرة المتصفح النشطة أثناء الجلسة فقط ولا تُكتب أو تُحفظ على قرص السيرفر نهائياً.

لماذا يتطلب Sshwifty تفعيل دعم WebSockets في الوكيل العكسي؟

ينقل Sshwifty ضغطات المفاتيح ونصوص الطرفية ومخرجات الشاشة الحية عبر مقابس WebSockets. ويجب أن يقوم الوكيل العكسي (مثل Nginx) بتمرير ترويسات `Upgrade` لتعمل الطرفية بسلاسة.

هل يمكن حفظ خوادم محددة مسبقاً في Sshwifty؟

نعم! يمكنك تهيئة قائمة بالخوادم المفضلة في ملف `./config/sshwifty.conf.json` بعناوينها وأرقام المنافذ وأسماء المستخدمين لتظهر كأزرار اتصال سريعة بنقرة واحدة.

هل يدعم Sshwifty الاتصال براوترات وسويتشات الشبكات القديمة عبر Telnet؟

نعم! بالإضافة إلى SSH، يدعم Sshwifty بروتوكول Telnet التقليدي (منفذ 23)، مما يتيح لك إدارة سويتشات الشبكات القديمة وسيرفرات المنافذ التسلسلية من المتصفح.

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

تم تطوير Sshwifty بلغة Go وهو فائق الخفة، حيث يستهلك عادة ما بين 15 إلى 40 ميجابايت فقط من الذاكرة العشوائية داخل Docker.