# الاتصال عبر SSH
Source: https://docs.webgee.com/ar/development/connect-via-ssh







افتح سطر أوامر على حساب استضافتك عبر SSH، لتشغّل `wp-cli` و`composer` و`git`
وغيرها مباشرة على الخادم. ينطبق على الاستضافة المشتركة والموزِّعة حيث يكون SSH
مشمولًا، وعلى كل خوادم VPS والمخصّصة.

## قبل أن تبدأ [#قبل-أن-تبدأ]

<img alt="صفحة SSH Access في cPanel" src="__img0" />

SSH ليس مفعَّلًا في كل باقة مشتركة. راجع **cPanel ← SSH Access**؛ فإن كان
غائبًا، فافتح تذكرة من منطقة العملاء واطلب تفعيل SSH على حسابك.

وستحتاج:

* **اسم مستخدم cPanel** و**كلمة المرور**.
* **اسم نطاقك** أو اسم مضيف الخادم.
* **منفذ SSH**. وخوادم WebGee تستخدم المنفذ القياسي **22**. فإن رُفض الاتصال،
  فتأكّد من المنفذ في صفحة **SSH Access** قبل افتراض أن شيئًا آخر خاطئ.

## الاتصال بكلمة مرور [#الاتصال-بكلمة-مرور]

على macOS ولينكس، استخدم العميل المدمج:

```bash
ssh cpaneluser@example.com -p 22
```

وفي أول اتصال، يُطلب منك تأكيد بصمة الخادم — اكتب `yes`.

وعلى ويندوز، يعمل الأمر نفسه في PowerShell وWindows Terminal. وإن كنت تفضّل
عميلًا رسوميًا، فراجع
[الاتصال بـ PuTTY](/ar/development/accessing-a-linux-server-using-ssh-keys-with-putty).

## استخدم مفتاحًا بدل كلمة المرور [#استخدم-مفتاحًا-بدل-كلمة-المرور]

المصادقة بالمفاتيح أيسر وأأمن بكثير — فلا كلمة مرور تُخمَّن، والمفتاح الخاص لا
يغادر جهازك أبدًا.

### ولّد مفتاحًا على جهازك [#ولّد-مفتاحًا-على-جهازك]

وهذا الخيار الأفضل: فالمفتاح الخاص يُنشأ محليًا ولا يُنقَل أبدًا.

```bash
ssh-keygen -t ed25519 -C "you@example.com"
```

اقبل الموقع الافتراضي واضبط عبارة مرور عند الطلب. وهذا يكتب ملفين:
`~/.ssh/id_ed25519` (الخاص — لا تشاركه أبدًا) و`~/.ssh/id_ed25519.pub` (العام).

ثم صرّح للمفتاح العام على حسابك:

1. اعرض المفتاح العام: `cat ~/.ssh/id_ed25519.pub`
2. في cPanel، افتح **SSH Access ← Manage SSH Keys**.

   <img alt="إدارة مفاتيح SSH، وفيها Generate a New Key وImport Key" src="__img1" />
3. اختر **Import Key**.
4. اترك خانة المفتاح الخاص فارغة، والصق المفتاح العام في خانة المفتاح العام،
   واختر **Import**.
5. بجوار المفتاح المستورَد، اختر **Manage**، ثم **Authorize**.

<Callout type="warn">
  المفتاح غير قابل للاستخدام حتى يُصرَّح له. فالاستيراد وحده لا يفعل شيئًا —
  وهذه هي الخطوة التي يغفلها الناس.
</Callout>

### أو ولّد مفتاحًا في cPanel [#أو-ولّد-مفتاحًا-في-cpanel]

يستطيع cPanel توليد الزوج لك ضمن
**SSH Access ← Manage SSH Keys ← Generate a New Key**. اختر **ed25519**، أو
**RSA** بـ 4096 بت إن كانت أداة تستخدمها لا تدعم ed25519. صرّح للمفتاح بعد ذلك،
ثم نزّل المفتاح الخاص واحفظه في `~/.ssh` على جهازك.

وهذا أيسر لكنه أضعف قليلًا: فالمفتاح الخاص يُولَّد على الخادم وعليه أن ينتقل
إليك.

## تأكّد أنه نجح [#تأكّد-أنه-نجح]

```bash
ssh cpaneluser@example.com -p 22 "whoami && pwd"
```

ينبغي أن يطبع اسم مستخدم cPanel ومجلدك الرئيسي دون أن يطلب كلمة مرور.

## إن رُفض الاتصال [#إن-رُفض-الاتصال]

* **`Connection refused`** — SSH غير مفعَّل على الحساب، أو جدار حماية صادر عندك
  يحجب المنفذ 22.
* **`Permission denied (publickey)`** — المفتاح مستورَد لكن غير مصرَّح له. عد
  وصرّح له.
* **`Permission denied (password)`** — SSH غير مفعَّل على الحساب، أو كلمة المرور
  خاطئة. تأكّد من كلمة المرور بتسجيل الدخول إلى cPanel.
* **يتوقف بلا استجابة** — شبكتك تحجب SSH الصادر. اختبر بـ
  `nc -vz example.com 22`.

## اقرأ أيضًا [#اقرأ-أيضًا]

* [استخدام مفاتيح SSH مع PuTTY](/ar/development/accessing-a-linux-server-using-ssh-keys-with-putty)
* [استخدام Git عبر SSH](/ar/development/using-git-via-ssh)