Depozit GitHub privat pe găzduirea cPanel: configurarea unui deploy key doar pentru citire (ed25519)
TipărirePe scurt: cPanel poate clona un proiect GitHub privat doar dacă deține o cheie în care GitHub are încredere. Generați pe calculatorul dvs. o pereche de chei ed25519 fără frază de acces, înregistrați jumătatea publică pe GitHub ca deploy key doar pentru citire, importați jumătatea privată în cPanel cu numele id_ed25519 și clonați cu adresa git@github.com:.... Pentru nimic din toate acestea nu este nevoie de acces shell la găzduire.
Când codul este public, cPanel îl descarcă pur și simplu prin HTTPS. Un depozit privat este închis pentru oricine nu își poate dovedi identitatea, inclusiv pentru contul dvs. de găzduire. Deploy key-ul este această dovadă: o cheie legată de un singur depozit, care îi permite lui cPanel să citească codul și nimic mai mult.
Elementele implicate
| Element | Numele fișierului în acest ghid | Unde ajunge |
|---|---|---|
| Cheia publică | cheie-site.pub | Pe GitHub, în setările depozitului |
| Cheia privată | cheie-site | Doar în cPanel, importată ca id_ed25519 |
| Adresa de clonare SSH | git@github.com:utilizator/site.git | Câmpul Clone URL din cPanel |
Partea 1. Generați perechea de chei
Folosiți PowerShell pe Windows 10 sau 11 ori Terminal pe macOS și Linux:
ssh-keygen -t ed25519 -C "cpanel-site" -f cheie-site
Programul cere de două ori o frază de acces (passphrase). Lăsați-o goală de ambele dăți, apăsând Enter. În folderul curent apar două fișiere: cheie-site.pub și cheie-site.
Partea 2. Înregistrați cheia publică pe GitHub
- În depozitul de pe GitHub, mergeți la Settings, alegeți Deploy keys, apoi Add deploy key.
- Dați-i un Title pe care îl veți recunoaște mai târziu, de exemplu „cPanel TopHost”.
- Deschideți
cheie-site.pubîn Notepad sau în alt editor de text simplu, copiați tot conținutul și lipiți-l la Key. - Asigurați-vă că Allow write access rămâne nebifat, apoi confirmați cu Add key.
Partea 3. Predați cheia privată către cPanel
- În cPanel, deschideți SSH Access din grupul Security și mergeți la Manage SSH Keys.
- Alegeți Import Key. Ca nume, scrieți
id_ed25519și nimic altceva: Git caută exact acest nume de fișier și ignoră cheile numite altfel. - Lipiți tot conținutul fișierului
cheie-siteîn caseta pentru cheia privată. Rândurile care deschid și închid cheia trebuie incluse. - Lăsați goală caseta pentru fraza de acces și apăsați Import.
Butonul Authorize poate fi ignorat. El privește autentificarea dvs. pe server prin SSH și nu are niciun rol în comunicarea cu GitHub.
Partea 4. Clonați prin SSH
Pe GitHub, apăsați butonul Code și copiați adresa din fila SSH. Apoi, în cPanel, deschideți Git Version Control din Files, apăsați Create, lipiți adresa la Clone URL, alegeți un folder precum repositories/site și apăsați din nou Create. De aici înainte, actualizarea și publicarea site-ului se fac exact ca la un proiect public, vedeți Publicarea prin Git pe găzduirea cPanel: clonarea unui depozit GitHub și .cpanel.yml.
Este riscantă o cheie fără frază de acces?
O frază de acces ar trebui introdusă de fiecare dată când cPanel contactează GitHub, iar cPanel face aceste preluări fără ca cineva să fie de față, așa că o cheie protejată pur și simplu nu ar funcționa. Expunerea este mică: cheia dă acces la un singur depozit și, cât timp dreptul de scriere a rămas oprit, poate citi, dar nu poate modifica nimic.
Mesaje de eroare și soluții
| Vedeți | Motivul probabil și ce faceți |
|---|---|
Permission denied (publickey) | Verificați trei lucruri: cheia din cPanel se numește id_ed25519, ați lipit fișierul privat, nu pe cel .pub, iar deploy key-ul a fost adăugat chiar la acest depozit. |
Repository not found | Adresa are o greșeală de scriere sau cheia a fost înregistrată la alt depozit. |
Key is already in use pe GitHub | GitHub acceptă un deploy key la un singur depozit. Generați o pereche nouă pentru fiecare depozit. |
| Totul pare corect, dar clonarea tot eșuează | Contactați-ne printr-un tichet și verificăm configurarea din contul dvs. |
Întrebări pe care le primim des
Poate o singură cheie să servească două sau mai multe depozite private?
Nu, o cheie id_ed25519 acoperă un singur depozit. Dacă aveți nevoie de mai multe, scrieți-ne într-un tichet și vă ajutăm să le configurați.
De ce să nu lipesc un token GitHub în adresa de clonare?
Tokenul ar rămâne scris în setările depozitului din contul dvs. și ar da acces la tot ce permite acel token. Un deploy key doar pentru citire este alegerea mai sigură.
Ce fac cu fișierele cheii de pe calculator?
După import nu le mai folosiți. Ștergeți cheie-site sau păstrați-l într-un loc sigur. Nu dați niciodată cheia privată nimănui, nici echipei noastre de suport.
Cum opresc accesul mai târziu?
Eliminați cheia din Deploy keys pe GitHub și din Manage SSH Keys în cPanel. Accesul încetează în acel moment.
Articole utile
- Publicarea prin Git pe găzduirea cPanel: clonarea unui depozit GitHub și .cpanel.yml
- Cum publicați automat un site din GitHub: GitHub Actions cu FTPS pe găzduire sau rsync pe VPS
- Protecția cheilor API în aplicațiile din cPanel și în WordPress: păstrare sigură și reacția la scurgeri
- Acces SSH pe găzduirea cPanel: activare, Terminal și conectare din program