دليل

الاتصال عبر SSH

الوصول إلى جهاز Mac المستأجر عبر الطرفية من Windows أو Mac أو Linux: مفتاح SSH، وأول تسجيل دخول، ونقل الملفات، وtmux، وVS Code. دون برامج إضافية.

تتصل بجهاز Mac المستأجر عبر SSH العادي من خلال بوابتنا gate.bohemiansilicon.com. لا تثبّت أي شيء إضافي ولا تضبط أي إعدادات للشبكة. يستغرق الإعداد كله نحو 10 دقائق، والساعة الأولى من كل إيجار مجانية، لتجهّز كل شيء بهدوء.

في رسالتنا التي تحتوي على بيانات الدخول ستجد اسم المستخدم ورقم المنفذ (يبدو مثل 2201) وبصمة جهاز Mac، وكلمة مرور لسطح المكتب البعيد. أينما ذُكر USERNAME وPORT في هذا الدليل، استخدم القيم الواردة في الرسالة.

لاتصال SSH ترسل إلينا مفتاح SSH العام فقط. تسجيل الدخول بكلمة المرور معطّل في SSH، وتسجّل الدخول بالمفتاح فقط.

Windows

يتضمن Windows 10 و11 عميل SSH، ولا حاجة لتثبيت أي شيء آخر.

1. أنشئ مفتاح SSH

ننصح بمفتاح مستقل خاص بـ Bohemian Silicon. تحفظ الأوامر أدناه المفتاح باسم خاص، فلا تكتب فوق مفتاح تستخدمه في مكان آخر (مثل id_ed25519 الخاص بـ GitHub).

1. افتح PowerShell (انقر على ابدأ، واكتب PowerShell، ثم افتحه).
2. شغّل هذه الأوامر. عند طلب عبارة المرور (passphrase)، اكتب واحدة وأكّدها (لا يظهر شيء أثناء الكتابة). تحمي عبارة المرور المفتاح إذا نسخ أحدهم الملف. يمكنك تركها فارغة، لكن ذلك أقل أمانًا.

mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon

ينشئ الأمر ملفين. bohemian_ed25519 هو مفتاحك الخاص: يبقى على جهازك ولا ترسله لأحد أبدًا. أما bohemian_ed25519.pub فهو المفتاح العام: وهو ما ترسله إلينا. يمكن إرساله بأمان عبر بريد إلكتروني عادي، لأنه وحده لا يكفي لتسجيل الدخول.

هل تريد استخدام مفتاح لديك بالفعل؟ أرسل إلينا ملف .pub الخاص به، واستخدم اسم ملفه بدلًا من bohemian_ed25519 في الأوامر أدناه.

3. اعرض المفتاح العام:

Get-Content $HOME\.ssh\bohemian_ed25519.pub

انسخ السطر كاملًا الذي يبدأ بـ ssh-ed25519.

4. أرسل المفتاح إلينا بالبريد الإلكتروني. لا ترسل أبدًا الملف الذي لا ينتهي بـ .pub: فهو مفتاحك الخاص ويجب أن يبقى على جهازك فقط.

ستكتب عبارة مرور المفتاح في كل مرة تتصل فيها.

2. اتصل

ssh -i $HOME\.ssh\bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

1. في المرة الأولى يعرض SSH بصمة جهاز Mac (ED25519 key fingerprint is SHA256:…) ويسأل Are you sure you want to continue connecting?. قارنها بالبصمة الواردة في رسالتنا. اكتب yes فقط إذا تطابقتا تمامًا. وإن لم تتطابقا، فاكتب no وراسلنا.
2. تكون قد سجّلت الدخول عندما ترى سطرًا ينتهي بـ %. اكتب exit لقطع الاتصال.

Mac

1. أنشئ مفتاح SSH

ننصح بمفتاح مستقل خاص بـ Bohemian Silicon. تحفظ الأوامر أدناه المفتاح باسم خاص، فلا تكتب فوق مفتاح تستخدمه في مكان آخر (مثل id_ed25519 الخاص بـ GitHub).

1. افتح Terminal (التطبيقات ← الأدوات المساعدة ← Terminal).
2. شغّل هذه الأوامر. عند طلب عبارة المرور (passphrase)، اكتب واحدة وأكّدها (لا يظهر شيء أثناء الكتابة). تحمي عبارة المرور المفتاح إذا نسخ أحدهم الملف. يمكنك تركها فارغة، لكن ذلك أقل أمانًا.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

ينشئ الأمر ملفين. bohemian_ed25519 هو مفتاحك الخاص: يبقى على جهازك ولا ترسله لأحد أبدًا. أما bohemian_ed25519.pub فهو المفتاح العام: وهو ما ترسله إلينا. يمكن إرساله بأمان عبر بريد إلكتروني عادي، لأنه وحده لا يكفي لتسجيل الدخول.

هل تريد استخدام مفتاح لديك بالفعل؟ أرسل إلينا ملف .pub الخاص به، واستخدم اسم ملفه بدلًا من bohemian_ed25519 في الأوامر أدناه.

3. اعرض المفتاح العام:

pbcopy < ~/.ssh/bohemian_ed25519.pub

المفتاح الآن في الحافظة؛ الصقه باستخدام ⌘V.

4. أرسل المفتاح إلينا بالبريد الإلكتروني. لا ترسل أبدًا الملف الذي لا ينتهي بـ .pub: فهو مفتاحك الخاص ويجب أن يبقى على جهازك فقط.

نصيحة: لتجنّب كتابة عبارة المرور في كل مرة، احفظها في سلسلة مفاتيح macOS:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. اتصل

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

1. في المرة الأولى يعرض SSH بصمة جهاز Mac (ED25519 key fingerprint is SHA256:…) ويسأل Are you sure you want to continue connecting?. قارنها بالبصمة الواردة في رسالتنا. اكتب yes فقط إذا تطابقتا تمامًا. وإن لم تتطابقا، فاكتب no وراسلنا.
2. تكون قد سجّلت الدخول عندما ترى سطرًا ينتهي بـ %. اكتب exit لقطع الاتصال.

Linux

1. أنشئ مفتاح SSH

ننصح بمفتاح مستقل خاص بـ Bohemian Silicon. تحفظ الأوامر أدناه المفتاح باسم خاص، فلا تكتب فوق مفتاح تستخدمه في مكان آخر (مثل id_ed25519 الخاص بـ GitHub).

1. افتح طرفية.
2. شغّل هذه الأوامر. عند طلب عبارة المرور (passphrase)، اكتب واحدة وأكّدها (لا يظهر شيء أثناء الكتابة). تحمي عبارة المرور المفتاح إذا نسخ أحدهم الملف. يمكنك تركها فارغة، لكن ذلك أقل أمانًا.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

ينشئ الأمر ملفين. bohemian_ed25519 هو مفتاحك الخاص: يبقى على جهازك ولا ترسله لأحد أبدًا. أما bohemian_ed25519.pub فهو المفتاح العام: وهو ما ترسله إلينا. يمكن إرساله بأمان عبر بريد إلكتروني عادي، لأنه وحده لا يكفي لتسجيل الدخول.

هل تريد استخدام مفتاح لديك بالفعل؟ أرسل إلينا ملف .pub الخاص به، واستخدم اسم ملفه بدلًا من bohemian_ed25519 في الأوامر أدناه.

3. اعرض المفتاح العام:

cat ~/.ssh/bohemian_ed25519.pub

انسخ السطر كاملًا الذي يبدأ بـ ssh-ed25519.

4. أرسل المفتاح إلينا بالبريد الإلكتروني. لا ترسل أبدًا الملف الذي لا ينتهي بـ .pub: فهو مفتاحك الخاص ويجب أن يبقى على جهازك فقط.

نصيحة: تشغّل معظم بيئات سطح المكتب في Linux وكيل SSH مسبقًا، فيمكنك إدخال عبارة المرور مرة واحدة في كل جلسة:

ssh-add ~/.ssh/bohemian_ed25519

2. اتصل

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

1. في المرة الأولى يعرض SSH بصمة جهاز Mac (ED25519 key fingerprint is SHA256:…) ويسأل Are you sure you want to continue connecting?. قارنها بالبصمة الواردة في رسالتنا. اكتب yes فقط إذا تطابقتا تمامًا. وإن لم تتطابقا، فاكتب no وراسلنا.
2. تكون قد سجّلت الدخول عندما ترى سطرًا ينتهي بـ %. اكتب exit لقطع الاتصال.

نقل الملفات

شغّل scp على جهازك أنت، لا على جهاز Mac المستأجر.

Windows

scp -i $HOME\.ssh\bohemian_ed25519 -P PORT data.zip USERNAME@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P PORT USERNAME@gate.bohemiansilicon.com:~/results.zip .

Mac, Linux

scp -i ~/.ssh/bohemian_ed25519 -P PORT data.zip USERNAME@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P PORT USERNAME@gate.bohemiansilicon.com:~/results.zip .

يرفع السطر الأول ملفًا إلى جهاز Mac المستأجر، وينزّل السطر الثاني ملفًا إلى المجلد الحالي. أضف -r لنسخ مجلد كامل.

المهام الطويلة (tmux)

عند إغلاق الطرفية أو انقطاع الاتصال تتوقف البرامج التي شُغّلت فيها أيضًا. شغّل المهام الطويلة، مثل تنزيل النماذج أو التدريب، داخل tmux: تستمر الجلسة في العمل على جهاز Mac بعد قطع الاتصال. بعد تسجيل الدخول إلى Mac، ابدأ جلسة:

tmux new -s work

شغّل مهمتك داخلها. لتتركها تعمل وتقطع الاتصال، اضغط Ctrl+B، ثم حرّر المفتاحين واضغط D. بعد إعادة الاتصال عُد إلى الجلسة بالأمر:

tmux attach -t work

يعرض tmux ls جلساتك؛ وكتابة exit داخل الجلسة تنهيها. تنتهي جميع الجلسات على أبعد تقدير عند انتهاء الإيجار وحذف حسابك.

Visual Studio Code (Remote-SSH)

1. في VS Code، ثبّت إضافة Remote - SSH من Microsoft.
2. اضغط F1، واختر Remote-SSH: Add New SSH Host… وأدخل هذا الأمر (هو نفسه على Windows وMac وLinux):

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

3. احفظه في ملف إعدادات SSH المقترح. ثم اضغط F1 مجددًا، واختر Remote-SSH: Connect to Host… ثم عنوان جهاز Mac. إذا سُئلت عن المنصة، فاختر macOS.
4. عند الاتصال الأول يثبّت VS Code جزء الخادم الخاص به في حسابك على جهاز Mac، ويستغرق ذلك دقيقة أو دقيقتين. بعدها يمكنك فتح مجلدات جهاز Mac واستخدام طرفيته مباشرة في VS Code.

حل المشكلات

• انتهت مهلة الاتصال أو رُفض: تحقّق من العنوان gate.bohemiansilicon.com ومن رقم المنفذ بعد -p. بعض شبكات الشركات أو الفنادق تحظر الاتصالات الصادرة إلى منافذ غير معتادة؛ جرّب شبكة أخرى، مثل نقطة اتصال الهاتف، أو راسلنا.
• Permission denied (publickey) أو طلب كلمة مرور: لم يُستخدم مفتاحك. اتصل من الجهاز الذي أنشأت عليه المفتاح، وأضف -i مع مسار المفتاح، وتحقق من اسم المستخدم.
• REMOTE HOST IDENTIFICATION HAS CHANGED: توقف ولا تتصل. راسلنا أولًا. سنخبرك إن كان جهاز Mac قد أُعيد تثبيته ونرسل إليك بصمته الجديدة. وبعدها فقط شغّل ssh-keygen -R "[gate.bohemiansilicon.com]:PORT" واتصل مجددًا مع التحقق من البصمة الجديدة.

عند انتهاء الإيجار

عند انتهاء الإيجار نحذف حسابك في macOS مع مجلد المنزل، ونزيل ملفاتك من المجلدات المؤقتة المشتركة (/tmp و/Users/Shared). نزّل كل ما تريد الاحتفاظ به قبل انتهاء الإيجار. بعد ذلك يمكنك أيضًا حذف المفتاح من حاسوبك: الملفان bohemian_ed25519 وbohemian_ed25519.pub في مجلد .ssh.

هل واجهتك مشكلة؟ راسلنا على hello@bohemiansilicon.com وأرفق لقطة شاشة أو نص الخطأ. عادةً نرد خلال دقائق.

→ كل الأدلة