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

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

ما هو 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. انقر على المواقع في الشريط الجانبي الأيسر.
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. انقر على إضافة موقع وأعطه اسمًا (على سبيل المثال، "موقعي على KapsuleHost").

4. في تبويب General، اضبط الحقول التالية:

   الحقل	القيمة
   البروتوكول	SFTP - SSH File Transfer Protocol
   المضيف	cp1-kapsule.kapsulehost.com
   المنفذ	22
   نوع تسجيل الدخول	Key file
   المستخدم	اسم مستخدم موقعك (على سبيل المثال، 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.

---

الاتصال من الطرفية (Mac أو Linux أو WSL)

إذا كنت تفضّل سطر الأوامر، فإن أمر sftp متاح على macOS وLinux ونظام فرعي لـ Windows (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/، فاستخدم ذلك.

---

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

"Connection refused"

تم رفض الاتصال بشكل فعّال قبل أن يُنشأ.

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

"Permission denied (publickey)"

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

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

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

"Host key verification failed"

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

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

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

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

"Could not read from remote repository" أو دليل خاطئ

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

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

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

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

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

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

---

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

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