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

Source: https://support.kapsulehost.com/ar-ae/sftp-access

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

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

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

- رفع أو تنزيل أعداد كبيرة من الملفات دفعة واحدة (نقل موقع، رفع صور بالجملة).
- نقل ملفات كبيرة قد تتجاوز المهلة الزمنية عند الرفع عبر المتصفح.
- العمل ضمن سير عمل تطويري حيث تُعدّل الملفات محليًا ثم تدفع التغييرات.
- استخدام برنامج ذي واجهة رسومية يتيح لك إبقاء مجلد محلي ومجلد بعيد متزامنين.
- الوصول إلى السجلات أو ملفات الإعداد غير المتاحة عبر مدير الملفات في KPanel.

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

![تفاصيل اتصال SSH و SFTP لموقع في KPanel](https://support.kapsulehost.com/help/screenshots/sftp-access.df4a2e3e.webp)

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

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

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

يستخدم SFTP على KapsuleHost المصادقة عبر مفتاح SSH. المصادقة بكلمة المرور معطّلة لأسباب أمنية. إذا لم تكن قد أضفت مفتاح SSH العام الخاص بك بعد، فاتبع دليل [إضافة مفاتيح SSH إلى موقعك](https://support.kapsulehost.com/ar-ae/adding-ssh-keys) أولًا، ثم عُد إلى هنا.

**2. اسم المستخدم الخاص بموقعك.**

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

لإيجاده:
1. سجّل الدخول إلى KPanel على [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com).
2. انقر على **المواقع** في الشريط الجانبي الأيسر.
3. انقر على الموقع الذي تريد الاتصال به.
4. انتقل إلى صفحة **SSH / SFTP**.
5. يظهر اسم مستخدم موقعك في أعلى هذا التبويب. وعادة ما يكون على شكل `mysite_com` أو `myexamplesite_net`.

**تفاصيل الاتصال بنظرة سريعة:**

| الحقل | القيمة |
|---|---|
| المضيف | `cp1-kapsule.kapsulehost.com` |
| المنفذ | `22` |
| البروتوكول | SFTP (وليس FTP ولا FTPS) |
| المصادقة | مفتاح SSH فقط |
| اسم المستخدم | اسم مستخدم موقعك (من KPanel > المواقع > [الموقع] > الإعدادات > SFTP) |

---

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

FileZilla هو برنامج اتصال SFTP مجاني ومتعدد الأنظمة، متاح لأنظمة Windows وmacOS وLinux. نزّله من [filezilla-project.org](https://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\`.

> **Note:** إذا كان لمفتاحك الخاص عبارة مرور، فسيطلب منك FileZilla إدخالها عند الاتصال. هذا أمر طبيعي. عبارة المرور تحمي ملف مفتاحك الخاص وهي منفصلة تمامًا عن أي كلمة مرور لدى KapsuleHost.

6. انقر على **Connect** لاختبار الاتصال، أو انقر على **OK** للحفظ والاتصال لاحقًا.

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

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

> **Tip:** في Site Manager الخاص بـ FileZilla، فعّل خانة الاختيار **Always trust this host** في أول مرة تتصل فيها لتجنّب ظهور طلب مفتاح المضيف في الاتصالات المستقبلية.

---

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

Cyberduck هو برنامج اتصال SFTP مجاني لأنظمة macOS وWindows. نزّله من [cyberduck.io](https://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).

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

```bash
sftp mysite_com@cp1-kapsule.kapsulehost.com
```

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

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

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

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

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

| الأمر | ما يقوم به |
|---|---|
| `ls` | عرض الملفات في الدليل البعيد الحالي |
| `lls` | عرض الملفات في الدليل المحلي الحالي |
| `cd [dir]` | تغيير الدليل على الخادم البعيد |
| `lcd [dir]` | تغيير الدليل على جهازك المحلي |
| `pwd` | عرض مسار الدليل البعيد الحالي |
| `lpwd` | عرض مسار الدليل المحلي الحالي |
| `get [file]` | تنزيل ملف من البعيد إلى المحلي |
| `get -r [dir]` | تنزيل دليل بالكامل بشكل متكرر |
| `put [file]` | رفع ملف من المحلي إلى البعيد |
| `put -r [dir]` | رفع دليل بالكامل بشكل متكرر |
| `rm [file]` | حذف ملف على الخادم البعيد |
| `mkdir [dir]` | إنشاء دليل على الخادم البعيد |
| `quit` | إغلاق اتصال SFTP |

**مثال: تنزيل ملف**
```bash
sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip
```

**مثال: رفع ملف**
```bash
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/`، فاستخدم ذلك.

> **Note:** لا يمكنك الوصول إلا إلى الملفات الخاصة بمستخدم موقعك. لا يمكنك التنقل إلى ما هو أعلى من `/home/[siteuser]/` أو الوصول إلى أدلة عملاء آخرين. هذا مقصود بالتصميم.

---

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

### "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](mailto: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](mailto:support@kapsulehost.com) واطلب منهم فحص سجل جدار الحماية.
- قد يحظر جدار حماية محلي أو VPN على شبكتك الاتصالات الصادرة على المنفذ 22. جرّب من شبكة مختلفة (مثل نقطة اتصال الهاتف المحمول) لاستبعاد هذا الاحتمال.

---

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

- [إضافة مفاتيح SSH إلى موقعك](https://support.kapsulehost.com/ar-ae/adding-ssh-keys)
- [استخدام مدير الملفات في KPanel](https://support.kapsulehost.com/ar-ae/file-manager)
- [الاتصال بقاعدة بياناتك عبر نفق SSH](https://support.kapsulehost.com/ar-ae/database-ssh-tunnel)