الاتصال عبر SFTP: FileZilla و Cyberduck وسطر الأوامر

SFTP (Secure File Transfer Protocol) يمنحك الوصول المباشر إلى ملفات موقعك على الخادم. يغطي هذا الدليل كل ما تحتاجه للاتصال بنجاح، من العثور على بيانات اعتمادك إلى استكشاف الأخطاء وإصلاحها.

ما هو SFTP ومتى تستخدمه

مدير الملفات المدمج في KPanel مناسب للتعديلات السريعة: إعادة تسمية ملف أو عرض ملف إعدادات أو تحميل أصل واحد. SFTP هو الأداة المناسبة عندما تحتاج إلى أكثر من ذلك:

• تحميل أو تنزيل أعداد كبيرة من الملفات في المرة الواحدة (ترحيل موقع أو تحميل الصور بكميات كبيرة).
• نقل ملفات كبيرة قد تنتهي مهلتها الزمنية في عملية تحميل قائمة على المتصفح.
• العمل كجزء من سير عمل تطويري حيث تقوم بتعديل الملفات محليًا ودفع التغييرات.
• استخدام عميل واجهة رسومية يتيح لك مزامنة مجلد محلي وآخر بعيد.
• الوصول إلى السجلات أو ملفات الإعدادات التي لا يتم فتحها من خلال مدير الملفات في KPanel.

SFTP تشفر جميع البيانات أثناء النقل، مما يجعلها أكثر أماناً من FTP العادي. KapsuleHost لا توفر اتصالات FTP غير مشفرة.

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

قبل أن تتمكن من الاتصال، تحتاج إلى توفر شيئين.

1. مفتاح SSH مضاف إلى موقعك في KPanel.

SFTP على KapsuleHost تستخدم مصادقة مفتاح SSH. مصادقة كلمة المرور معطلة لأسباب أمنية. إذا لم تضف مفتاح SSH العام الخاص بك بعد، اتبع أولاً دليل إضافة مفاتيح SSH إلى موقعك، ثم عد هنا.

2. اسم مستخدم موقعك.

لكل موقع على KapsuleHost مستخدم نظام مخصص. هذا ليس عنوان بريد KPanel الإلكتروني الخاص بك. إنه اسم مستخدم قصير مرتبط بشكل خاص بذلك الموقع.

للعثور عليه:

1. قم بتسجيل الدخول إلى KPanel على kpanel.kapsulehost.com.
2. انقر فوق Websites في الشريط الجانبي الأيسر.
3. انقر فوق الموقع الذي تريد الاتصال به.
4. انتقل إلى صفحة SSH / SFTP.
5. اسم مستخدم موقعك معروض في أعلى هذه التبويبة. يبدو عادةً مثل mysite_com أو myexamplesite_net.

تفاصيل الاتصال في لمحة:

---

الاتصال باستخدام FileZilla

FileZilla هو عميل SFTP مجاني ومتعدد المنصات متاح لأنظمة التشغيل Windows و macOS و Linux. قم بتنزيله من filezilla-project.org إذا لم يكن لديك بالفعل.

الإعداد خطوة بخطوة

1. افتح FileZilla.

2. انتقل إلى File > Site Manager (أو اضغط Ctrl+S على Windows / Cmd+S على Mac).

3. انقر فوق Add Website وأعطه اسماً (على سبيل المثال، "My Kapsule Site").

4. في التبويبة General، قم بتكوين الحقول التالية:

   الحقل	القيمة
   البروتوكول	SFTP - SSH File Transfer Protocol
   المضيف	cp1-kapsule.kapsulehost.com
   المنفذ	22
   نوع تسجيل الدخول	ملف المفتاح
   المستخدم	اسم مستخدم موقعك (على سبيل المثال، mysite_com)
   ملف المفتاح	انقر فوق Browse وانتقل إلى ملف المفتاح الخاص بك

5. لملف المفتاح، حدد المفتاح الخاص الذي يتوافق مع المفتاح العام الذي أضفته في KPanel. على macOS و Linux، يتم تخزين المفاتيح الخاصة عادةً في ~/.ssh/ (على سبيل المثال، ~/.ssh/id_ed25519 أو ~/.ssh/id_rsa). على Windows، يكونون غالباً في C:\Users\YourName\.ssh\.

1. انقر فوق Connect لاختبار الاتصال، أو انقر فوق OK للحفظ والاتصال لاحقاً.

الحفظ وإعادة الاتصال

بمجرد حفظه في Site Manager، يمكنك إعادة الاتصال في أي وقت بالذهاب إلى File > Site Manager والنقر فوق Connect. يعرض FileZilla أيضاً مواقعك المحفوظة في القائمة المنسدلة على شريط الأدوات للوصول السريع.

---

الاتصال باستخدام Cyberduck

Cyberduck هو عميل SFTP مجاني لأنظمة التشغيل macOS و Windows. قم بتنزيله من cyberduck.io.

الإعداد خطوة بخطوة

1. افتح Cyberduck.

2. انقر فوق Open Connection (أيقونة الكرة الأرضية في شريط الأدوات).

3. من القائمة المنسدلة للبروتوكول في أعلى مربع الحوار، حدد SFTP (SSH File Transfer Protocol).

4. ملء حقول الاتصال:

   الحقل	القيمة
   الخادم	cp1-kapsule.kapsulehost.com
   المنفذ	22
   اسم المستخدم	اسم مستخدم موقعك (على سبيل المثال، mysite_com)
   كلمة المرور	اترك فارغاً
   مفتاح SSH الخاص	انقر فوق Choose وحدد ملف المفتاح الخاص بك

5. انقر فوق Connect.

عند الاتصال الأول، سيطلب منك Cyberduck التحقق من بصمة مفتاح المضيف الخاص بالخادم. انقر فوق Allow للمتابعة. إذا رأيت هذه المطالبة عند اتصال لاحق ببصمة مختلفة، فلا تقبلها واتصل بالدعم، لأنها قد تشير إلى تغيير في الإعدادات.

الحفظ كعلامة مرجعية

لحفظ الاتصال للاستخدام في المستقبل:

1. بعد الاتصال بنجاح، انتقل إلى Bookmark > New Bookmark (أو اضغط Cmd+Shift+B على Mac).
2. أعط العلامة المرجعية اسماً وأغلق مربع الحوار. تظهر العلامة المرجعية في قائمة العلامات المرجعية الخاصة بك في Cyberduck.

---

الاتصال من Terminal (Mac أو Linux أو WSL)

إذا كنت تفضل سطر الأوامر، فإن أمر sftp متاح على macOS و Linux و Windows Subsystem for Linux (WSL).

الاتصال الأساسي

sftp mysite_com@cp1-kapsule.kapsulehost.com

استبدل mysite_com باسم مستخدم موقعك الفعلي. إذا لم يكن المفتاح الخاص الخاص بك في الموقع الافتراضي (~/.ssh/id_rsa أو ~/.ssh/id_ed25519)، حدده باستخدام علم -i:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

عند الاتصال الأول، سيطلب منك تأكيد بصمة المضيف الخاص بالخادم. اكتب yes واضغط Enter. هذا يحدث مرة واحدة فقط لكل مفتاح لكل جهاز.

أوامر SFTP المفيدة

بمجرد الاتصال، ستشاهد موجه sftp>. استخدم هذه الأوامر للتنقل ونقل الملفات:

مثال: تنزيل ملف

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

مثال: تحميل ملف

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

مكان وجود ملفاتك

بعد الاتصال، ستصل إلى دليل الصفحة الرئيسية لمستخدم موقعك: /home/[siteuser]/.

هيكل الدليل يبدو كالتالي:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

جذر الويب حيث يعيش WordPress (أو تطبيق آخر) الخاص بك هو htdocs/. هذا هو الدليل الذي ستقضي فيه معظم وقتك. في بعض تكوينات الموقع، قد يسمى public_html/ بدلاً من ذلك. إذا قمت بالاتصال ورأيت public_html/ بدلاً من htdocs/، استخدم ذلك.

---

استكشاف مشاكل الاتصال وإصلاحها

"الاتصال مرفوض"

تم رفض الاتصال بنشاط قبل إنشاؤه.

تحقق: تأكد من أنك تستخدم المضيف cp1-kapsule.kapsulehost.com والمنفذ 22. الخطأ الشائع هو إدخال المنفذ 21 (وهو FTP وليس SFTP) أو خطأ إملائي في اسم المضيف.

"إذن مرفوض (publickey)"

قبل الخادم محاولة الاتصال لكنه رفض المصادقة الخاصة بك.

تحقق من كل مما يلي:

• تم إضافة مفتاح SSH العام الخاص بك في KPanel > Websites > [الموقع] > SSH / SFTP. إذا لم يكن مدرجاً هناك، فلا يوجد سجل له على الخادم.
• لقد حددت المفتاح الخاص الصحيح في FileZilla / Cyberduck، وبالتحديد المفتاح الخاص الذي يتزاوج مع المفتاح العام الذي أضفته إلى KPanel.
• إذا كان المفتاح الخاص بك يحتوي على عبارة مرور، فتأكد من أنك تدخلها بشكل صحيح.
• إذا كان لديك عدة مفاتيح، فتأكد من عدم تحديد المفتاح الخاطئ عن طريق الخطأ.

"فشل التحقق من مفتاح المضيف"

رأى عميل SFTP الخاص بك مفتاح مضيف مختلف لهذا اسم المضيف من قبل ويحذرك من عدم التطابق.

عند الاتصال الأول: سيطلب منك قبول البصمة. هذا طبيعي. انقر فوق Accept أو اكتب yes.

عند اتصال لاحق ببصمة جديدة: يمكن أن يشير هذا إلى تغيير في الإعدادات على الخادم. اتصل بالدعم على support@kapsulehost.com قبل القبول، واذكر ما شاهدته.

لحذف مفتاح مضيف قديم في terminal، عدّل ~/.ssh/known_hosts وأزل السطر الخاص به cp1-kapsule.kapsulehost.com.

"لم يتمكن من القراءة من المستودع البعيد" أو الدليل الخاطئ

قد تكون استخدمت عنوان بريد KPanel الخاص بك كاسم مستخدم بدلاً من اسم مستخدم موقعك.

تحقق: يجب أن يكون اسم المستخدم هو اسم مستخدم موقعك (على سبيل المثال، mysite_com)، وليس عنوان بريدك الإلكتروني. ابحث عن اسم المستخدم الصحيح في KPanel > Websites > [الموقع] > SSH / SFTP.

انتهاء مهلة الاتصال

محاولة الاتصال معلقة ثم انتهت المهلة الزمنية دون أي خطأ.

الأسباب المحتملة:

• قد يتم حظر عنوان IP الخاص بك مؤقتاً من قبل جدار حماية Kapsule بسبب محاولات تسجيل دخول متكررة فاشلة. اتصل بالدعم على support@kapsulehost.com واطلب منهم التحقق من سجل جدار الحماية.
• قد يكون جدار حماية محلي أو VPN على شبكتك يحظر الاتصالات الصادرة على المنفذ 22. جرب من شبكة مختلفة (على سبيل المثال، نقطة اتصال الهاتف المحمول) للقضاء على هذا.

---

المقالات ذات الصلة

• إضافة مفاتيح SSH إلى موقعك
• استخدام مدير الملفات في KPanel
• الاتصال بقاعدة البيانات الخاصة بك عبر نفق SSH