راهنمای Git — تنظیم دسترسی به مخازن خصوصی

1. مقدمه

این راهنما نحوه تنظیم دسترسی SSH را توضیح می‌دهد تا بتوانید یک مخزن Git میزبانی‌شده در cPanel را به یک مخزن خصوصی ریموت کلون یا متصل کنید. قبل از کلون یا push کردن کد، باید کلیدهای SSH را تولید کرده و در میزبان مخزن خصوصی ثبت کنید.

نکته مهم: در این آموزش از GitHub به‌عنوان مثال استفاده شده است، اما مراحل برای اکثر میزبان‌های مخازن خصوصی مشابه است. برای اجرای این مراحل، ویژگی‌های SSH Access و Terminal باید فعال باشند.

2. تنظیم دسترسی SSH به مخازن خصوصی

2.1 اتصال به سرور از طریق SSH یا Terminal

از SSH یا Terminal در cPanel برای اتصال به حساب خود استفاده کنید. پس از اتصال، تمام دستورات را در محیط ترمینال اجرا کنید.

3. تولید کلید SSH

برای تولید یک کلید SSH جدید، دستور زیر را اجرا کنید:

ssh-keygen -t rsa -f ~/.ssh/repo -b 4096 -C "[email protected]"

جایگزین کنید:

• repo → نام مخزن
• username → نام کاربری cPanel
• example.com → دامنه cPanel

مثال:

ssh-keygen -t rsa -f ~/.ssh/testing -b 4096 -C "[email protected]"

هشدار:

• -t نوع کلید را مشخص می‌کند.
• -f نام فایل کلید را تعیین می‌کند (کلید عمومی = همان نام + .pub).
• -b اندازه کلید را مشخص می‌کند.
• -C یک توضیح (معمولاً ایمیل) به کلید اضافه می‌کند.

هنگام درخواست passphrase، فقط Enter بزنید و آن را خالی بگذارید.

4. ساخت فایل تنظیمات SSH

مراحل:

touch ~/.ssh/config
chmod 0600 ~/.ssh/config
chown cpanelusername:cpanelusername ~/.ssh/config

فایل را باز کرده و خطوط زیر را اضافه کنید:

Host remote-git-repo-domain.tld
    IdentityFile ~/.ssh/testing

نکات:

• می‌توانید از * برای اعمال کلید روی تمام اتصالات SSH استفاده کنید.
• مسیر کلید خصوصی باید دقیقاً همان کلیدی باشد که تولید کرده‌اید.

5. ثبت کلید SSH در میزبان مخزن خصوصی

مثال GitHub:

1. ورود به GitHub
2. باز کردن مخزن خصوصی
3. رفتن به Settings
4. انتخاب Deploy keys
5. کلیک روی Add deploy key
6. وارد کردن عنوان
7. چسباندن کلید عمومی (مثلاً ~/.ssh/testing.pub)
8. فعال کردن Allow write access در صورت نیاز به push
9. کلیک روی Add key

نکته: برخی میزبان‌ها مانند Bitbucket اجازه write access برای deploy key نمی‌دهند.

6. تست کلید SSH

دستور زیر را اجرا کنید:

ssh -i ~/.ssh/repo -T [email protected]

مثال:

ssh -i ~/.ssh/testing -T [email protected]

7. تنظیم دسترسی برای چند مخزن

برای هر مخزن یک کلید جداگانه بسازید و فایل ~/.ssh/config را مانند زیر تنظیم کنید:

Host github.com-testing
        Hostname github.com
        IdentityFile=/home/cptest/.ssh/testing

Host github.com-testing2
        Hostname github.com
        IdentityFile=/home/cptest/.ssh/testing2

8. کلون مخزن — یک مخزن روی میزبان ریموت

git clone [email protected]:username/repo.git

مثال:

git clone [email protected]:cptest/testing.git

9. کلون مخزن — چند مخزن روی میزبان ریموت

git clone git@Host:username/repo.git

مثال:

git clone [email protected]:cptest/testing2.git

نتیجه‌گیری

با اجرای این مراحل می‌توانید حساب cPanel خود را به‌صورت امن به مخازن خصوصی Git متصل کنید، چندین کلید SSH مدیریت کنید و مخازن را با امنیت کامل کلون یا push کنید. این روش برای توسعه خصوصی و استقرار خودکار ضروری است.