الدليل: إصلاح مشكلات الوصول إلى Git SSH على Windows Server

Temp mail SuperHeros
الدليل: إصلاح مشكلات الوصول إلى Git SSH على Windows Server
الدليل: إصلاح مشكلات الوصول إلى Git SSH على Windows Server
Lucas Simon
السبت، ٢٥ مايو ٢٠٢٤ ٧:٣١:٤٧ م

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

قد يكون إنشاء اتصال Git موثوقًا عبر SSH بخادم داخلي أمرًا صعبًا، خاصة عندما يكون الخادم جزءًا من الشبكة المحلية للشركة. يواجه العديد من المستخدمين مشكلات حيث يفشل Git في الوصول إلى المستودع البعيد، على الرغم من قدرته على الاتصال بالخادم نفسه عبر SSH.

في هذا الدليل، سنستكشف المشكلات والحلول الشائعة لحل مشكلات الوصول إلى Git SSH على جهاز يعمل بنظام Windows. سواء كانت عناوين URL غير صحيحة للمستودع أو حقوق وصول تم تكوينها بشكل خاطئ، فسنساعدك على استكشاف مشكلات الاتصال هذه وإصلاحها لضمان سلاسة عمليات Git.

يأمر وصف
git init --bare تهيئة مستودع Git العاري، المناسب للعمل كمستودع بعيد.
icacls . /grant everyone:F يضبط أذونات الملفات على نظام Windows للسماح بالتحكم الكامل لجميع المستخدمين، مما يضمن الوصول إلى المستودع.
git remote remove origin إزالة تكوين المستودع البعيد الموجود من المستودع المحلي.
git remote add origin إضافة مستودع بعيد جديد بعنوان URL المحدد إلى المستودع المحلي.
Get-WindowsCapability يسرد ميزات Windows، بما في ذلك OpenSSH، التي يمكن تثبيتها أو تثبيتها.
Start-Service sshd بدء تشغيل خدمة خادم SSH على نظام التشغيل Windows، وتمكين اتصالات SSH.
Set-Service -StartupType 'Automatic' يقوم بتكوين خدمة لتبدأ تلقائيًا مع Windows، مما يضمن تشغيل خادم SSH دائمًا.

فهم الحل لمشكلات الوصول إلى Git SSH

يقوم البرنامج النصي الأول بتهيئة مستودع Git العاري على خادم Windows باستخدام git init --bare يأمر. يعد هذا أمرًا ضروريًا لأن المستودع المجرد مصمم ليكون مستودعًا مركزيًا يمكن للمستخدمين الآخرين الدفع والسحب منه. يقوم البرنامج النصي أيضًا بتغيير الدليل إلى الموقع المطلوب ويعين أذونات الملف باستخدام الملف icacls . /grant everyone:F الأمر للتأكد من أن كافة المستخدمين لديهم السيطرة الكاملة على المستودع. يعد هذا أمرًا بالغ الأهمية لتجنب مشكلات الأذونات التي يمكن أن تمنع Git من الوصول إلى المستودع بشكل صحيح.

يقوم البرنامج النصي الثاني بتكوين جهاز التحكم عن بعد Git على جهاز العميل باستخدام Git Bash. يبدأ بإزالة أي جهاز تحكم عن بعد موجود باستخدام git remote remove origin الأمر، مما يضمن عدم وجود تعارض مع التكوينات السابقة. ثم يضيف المستودع البعيد الجديد بامتداد git remote add origin الأمر، مع تحديد تنسيق URL الصحيح للوصول إلى مستودع خادم Windows. وأخيرًا، يتحقق من عنوان URL البعيد ويدفع التغييرات إلى المستودع البعيد، مع التأكد من أن الاتصال يعمل كما هو متوقع.

تكوين SSH وضمان الاتصال

يركز البرنامج النصي الثالث على إعداد خادم SSH على جهاز يعمل بنظام Windows باستخدام PowerShell. يقوم بتثبيت ميزة خادم OpenSSH مع Get-WindowsCapability الأمر، يبدأ خدمة خادم SSH باستخدام Start-Service sshd، ويقوم بتكوينه ليبدأ تلقائيًا باستخدام ملف Set-Service -StartupType 'Automatic' يأمر. تعتبر هذه الخطوات ضرورية لضمان تشغيل خادم SSH دائمًا وجاهزيته لقبول الاتصالات.

باتباع هذه البرامج النصية، يمكنك التأكد من إعداد مستودع Git بشكل صحيح وإمكانية الوصول إليه، ومن تكوين خادم SSH بشكل صحيح للسماح بالاتصالات الآمنة. تعالج هذه الحلول المشكلات الشائعة التي تمنع Git من الوصول إلى مستودع بعيد عبر SSH، مما يوفر طريقة موثوقة لدفع التغييرات وسحبها داخل الشبكة المحلية للشركة.

إعداد مستودع مكشوف على خادم Windows

استخدام موجه الأوامر (CMD) على نظام التشغيل Windows

REM Change directory to the desired location
cd C:\path\to\desired\location

REM Initialize a bare repository
git init --bare gitTest.git

REM Verify the repository
cd gitTest.git
dir

REM Ensure the correct permissions
icacls . /grant everyone:F

تحديث تكوين Git على جهاز العميل

استخدام Git Bash على جهاز العميل

# Remove any existing remote
git remote remove origin

# Add the remote repository using the correct URL format
git remote add origin ssh://admin@ipaddress/c/path/to/desired/location/gitTest.git

# Verify the remote URL
git remote -v

# Push changes to the remote repository
git push -u origin master

تكوين الوصول إلى SSH على خادم Windows

استخدام PowerShell على خادم Windows

# Install OpenSSH Server feature
Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'
Get-WindowsCapability -Online | Add-WindowsCapability -Online

# Start the SSH server service
Start-Service sshd

# Set SSH server to start automatically
Set-Service -Name sshd -StartupType 'Automatic'

# Verify SSH server status
Get-Service -Name sshd

معالجة مشكلات الشبكة والتكوين

عند التعامل مع مشكلات Git عبر SSH على خادم داخلي، فمن الضروري مراعاة تكوين الشبكة وإعدادات جدار الحماية. على الرغم من إيقاف تشغيل جدار حماية Windows Defender، فقد تكون هناك قيود أخرى على الشبكة. تأكد من السماح بحركة مرور SSH وأن المنافذ الضرورية مفتوحة على جانبي العميل والخادم. بالإضافة إلى ذلك، تحقق جيدًا من تكوين خادم SSH بشكل صحيح لقبول الاتصالات من شبكتك المحددة.

جانب آخر مهم هو تكوين مفاتيح SSH. قد ينجح استخدام المصادقة المستندة إلى كلمة المرور، ولكن للحصول على اتصال أكثر أمانًا وموثوقية، يوصى بإعداد مفاتيح SSH. تأكد من إضافة المفتاح العام إلى authorized_keys الملف على الخادم. لا يعمل هذا الإعداد على تحسين الأمان فحسب، بل يمنع أيضًا المشكلات المتعلقة بفشل مصادقة كلمة المرور، مما يحسن الاتصال العام وكفاءة عمليات Git الخاصة بك.

الأسئلة المتداولة حول مشكلات Git عبر SSH

  1. لماذا يقول Git "لم يتم العثور على المستودع"؟
  2. يحدث هذا عادةً إذا كان عنوان URL للمستودع غير صحيح أو لم يتم تحديد المسار إلى المستودع بشكل صحيح. تأكد من أن عنوان URL يتبع التنسيق ssh://user@ipaddress/path/to/repo.git.
  3. كيف يمكنني التحقق مما إذا كان SSH يعمل؟
  4. استخدم ال ssh user@ipaddress أمر للاتصال بالخادم. إذا كان بإمكانك تسجيل الدخول بدون أخطاء، فهذا يعني أن SSH يعمل بشكل صحيح.
  5. لماذا أحتاج إلى مستودع مكشوف لجهاز التحكم عن بعد؟
  6. تم تصميم المستودعات العارية لتكون مستودعًا مركزيًا يمكن للمستخدمين الدفع والسحب منه، بدون دليل عمل.
  7. ما هي المشكلات الشائعة المتعلقة بمفاتيح SSH؟
  8. تأكد من وجود مفتاحك العام في authorized_keys الملف الموجود على الخادم وأن المفتاح الخاص قد تم تكوينه بشكل صحيح على جهاز العميل.
  9. كيف يمكنني إعادة تشغيل خدمة SSH على نظام التشغيل Windows؟
  10. استخدم ال Get-Service sshd و Restart-Service sshd الأوامر في PowerShell لإعادة تشغيل خدمة SSH.
  11. كيف ينبغي أن يبدو عنوان URL للمستودع؟
  12. يجب أن يتبع التنسيق: ssh://user@ipaddress/path/to/repo.git.
  13. كيف يمكنني التأكد من صحة مسار المستودع الخاص بي؟
  14. تحقق مرة أخرى من مسار الدليل على الخادم وتأكد من مطابقته لعنوان URL المستخدم في ملف git remote add يأمر.
  15. كيف أقوم باستكشاف مشكلات اتصال SSH وإصلاحها؟
  16. تحقق من سجلات SSH على الخادم بحثًا عن الأخطاء، واستخدم الوضع المطول مع ssh -v user@ipaddress للحصول على إخراج مفصل.
  17. لماذا أحصل على أخطاء رفض الإذن؟
  18. تأكد من أن المستخدم لديه الأذونات الصحيحة للوصول إلى المستودع وأنه تم تعيين أذونات الملف بشكل صحيح باستخدام icacls على ويندوز.
  19. كيف أقوم بإعداد مفاتيح SSH؟
  20. إنشاء زوج مفاتيح باستخدام ssh-keygen، ثم انسخ المفتاح العام إلى الخادم authorized_keys ملف.

الأفكار النهائية حول حل مشكلات Git SSH

يتضمن حل مشكلات Git SSH على خادم Windows عدة خطوات مهمة، بدءًا من إعداد مستودع مجرد ووصولاً إلى تكوين وصول SSH بشكل صحيح. يعد التأكد من تشغيل خادم SSH وتكوينه بشكل صحيح، بالإضافة إلى استخدام مسارات وأذونات المستودع الصحيحة، أمرًا أساسيًا للتغلب على هذه التحديات. باتباع الإرشادات والبرامج النصية المتوفرة، يمكنك استكشاف هذه المشكلات وإصلاحها، مما يتيح عمليات Git بسلاسة داخل شبكتك المحلية. إن اتخاذ هذه الإجراءات لا يؤدي إلى تحسين سير عملك فحسب، بل يعزز أيضًا أمان وموثوقية بيئة التطوير الخاصة بك.