Săriți la conținut

Documentație

cPanel și WHM

cPanel este panoul în care se conectează clienții dumneavoastră; WHM este panoul de deasupra, iar acolo se conectează Provibr. Nu există niciun sistem de operare de instalat și nicio mașină de pornit. Un cont este creat pe un server care rulează deja, primește un pachet și, ulterior, este suspendat, mutat pe alt pachet sau șters.

De ce aveți nevoie

Un token API WHM, nu o parolă și nu un cont de cPanel. Îl creați chiar în WHM și circulă ca un antet obișnuit la fiecare apel pe care îl face agentul.

  • Gazdă: adresa WHM, inclusiv https. Dacă omiteți portul, Provibr completează 2087.
  • Utilizator WHM: contul căruia îi aparține tokenul, de regulă root.
  • Token API: creat în Manage API Tokens din WHM și afișat o singură dată.
  • Amprentă TLS: opțională, iar pe un server cPanel o lăsați de regulă goală. Secțiunea de mai jos explică de ce.
shell
openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Comenzile și ieșirea din terminal sunt în engleză peste tot, în panou și în aceste pagini. Un singur text, un singur adevăr: ce citiți aici este literalmente ce va afișa gazda dumneavoastră.
Adresa trebuie să fie https, spre deosebire de DirectAdmin și Pterodactyl, unde un panou necriptat este acceptat cu un avertisment. WHM răspunde pe 2086 fără criptare și pe 2087 cu criptare, iar Provibr îl acceptă doar pe al doilea. Pe acea conexiune nu circulă cheia unui singur cont, ci un token care poate crea și șterge orice cont de pe mașină.

Crearea tokenului

Tokenul se creează în WHM, de către utilizatorul căruia îi va aparține. Provibr nu îl mai vede niciodată după salvare: este trimis o singură dată către agent și sigilat în seiful acelui agent, iar platforma păstrează doar numele câmpurilor.

  1. Conectați-vă la WHM ca utilizatorul căruia trebuie să îi aparțină tokenul, de regulă root.
  2. Deschideți Development și apoi Manage API Tokens.
  3. Generați un token și dați-i un nume din care să reiasă că aparține Provibr, ca să îl recunoașteți mai târziu, atunci când vreți să îl revocați.
  4. Copiați tokenul înainte de a părăsi pagina. WHM îl afișează o singură dată și nu îl mai poate afișa; dacă îl pierdeți, trebuie să creați altul.
Un token cu toate funcțiile bifate înseamnă root pe acea mașină. Limitați-l la ceea ce apelează cu adevărat integrarea: citirea versiunii, a conturilor, a pachetelor, a traficului și a domeniilor, precum și crearea, suspendarea, reluarea, schimbarea pachetului și ștergerea conturilor. Un apel pe care tokenul nu are voie să îl facă eșuează cu motivul returnat de WHM, iar acest deznodământ este mai bun decât un token care poate face orice.

Certificatul

Portul 2087 este cel criptat, iar un server cPanel poartă de obicei un certificat emis de o autoritate publică, pe care panoul îl reînnoiește singur, aproximativ la fiecare nouăzeci de zile. În acest caz obișnuit, câmpul amprentei rămâne gol, iar agentul verifică certificatul așa cum ar face-o un browser.

A fixa un certificat care se reînnoiește la fiecare nouăzeci de zile înseamnă a-l fixa din nou la fiecare nouăzeci de zile. O integrare care se oprește de patru ori pe an este mai rea decât problema pe care trebuia să o rezolve, așa că lăsați câmpul gol dacă nu aveți un motiv contrar.

Completați-l numai când serverul prezintă un certificat pentru care nu garantează nicio autoritate publică, ceea ce în practică înseamnă o autoritate de certificare internă proprie. Luați amprenta de pe gazda agentului, ca să fixați exact ceea ce va vedea agentul, și luați-o din nou ori de câte ori acel certificat este înlocuit.

Setări

Nu există niciuna. Un WHM decide singur pe ce mașină ajunge un cont și ce adresă primește, așa că nu vă rămâne nimic de ales. Fila Setări există totuși, pentru că tot acolo retrimiteți datele de autentificare.

Pachete de găzduire

Un pachet WHM este descrierea pe care panoul însuși o dă unui cont: cotă de disc, trafic lunar, câte subdomenii și cutii poștale, ce listă de funcționalități. Nu este un plan Provibr și nu este un sistem de operare, ci un nume la care facem referire, iar conținutul lui se poate schimba pe serverul dumneavoastră fără ca noi să observăm.

Pagina integrării poate citi lista pachetelor împreună cu conținutul lor, astfel încât alegeți dintre cele pe care serverul le are cu adevărat, în loc să tastați un nume din memorie. Pachetele se creează în WHM; Provibr nu le creează.

Un plan web fixează un pachet pe o integrare și îi dă un nume ales de dumneavoastră. Comanda cu un plan are prioritate față de alegerea unui pachet separat, iar alegerea separată rămâne disponibilă pentru cazurile pe care un plan nu le acoperă.

O limită pe care un pachet o omite nu este o limită egală cu zero, ci absența oricărei limite. Pachetul implicit livrat cu WHM nu are nici cotă de disc, nici limită de trafic, iar acesta este un pachet nelimitat, nu unul stricat.

Dacă o cotă de disc este aplicată cu adevărat

Un server cPanel aplică cotele de disc numai dacă sistemul de fișiere pe care se află conturile acceptă cote. Fără asta, WHM acceptă pachetul, acceptă cifra și nu aplică nimic.

Simptomul este tăcut. Mutați un cont pe un pachet cu o cotă de doi gigaocți și contul continuă să își raporteze limita ca nelimitată: nimic nu a eșuat, nimic nu a fost refuzat, iar cifra din acel pachet nu înseamnă nimic pe acea mașină.

Testul de conexiune semnalează acest lucru. Citește conturile de pe server și spune dacă cotele lor sunt aplicate cu adevărat, alături de versiunea WHM și de numărători. Pe un server fără conturi nu există nimic de măsurat, iar testul spune asta în loc să ghicească.

Acesta este și motivul pentru care Provibr citește limita de disc din cont, nu din pachet. Ceea ce raportează contul este ceea ce se aplică; cifra din pachet este ceea ce a intenționat cineva.

Activarea cotelor este o operațiune pe server, nu în Provibr: sistemul de fișiere trebuie montat cu cote de utilizator, iar conturile trebuie rescanate. Ce anume presupune asta depinde de sistemul de fișiere și de modul în care a fost instalată mașina, așa că furnizorul dumneavoastră de găzduire sau documentația cPanel este locul potrivit.

Cum arată un cont în Provibr

Un cont de găzduire este un rând de server obișnuit, de tip server web. Identificatorul lui este numele de utilizator cPanel, iar domeniul principal, pachetul, spațiul ocupat și traficul sosesc la fiecare interogare.

  • Crearea unui cont necesită un nume de utilizator, un domeniu principal, o adresă de contact, un pachet și o parolă.
  • Numele de utilizator respectă regula proprie a WHM: încep cu o literă, apoi litere și cifre, cel mult șaisprezece caractere. Fără cratime și fără linii de subliniere.
  • Parola nu este consemnată nicăieri. Rămâne doar faptul că ați furnizat una; valoarea circulă separat.
  • După aceea puteți suspenda, relua, schimba pachetul și șterge. Nu există consolă: un cont de găzduire nu are așa ceva.
  • Niciun rezultat nu este crezut pe cuvânt. WHM confirmă o modificare printr-o pagină de ieșire a procesului, nu prin starea nouă, așa că fiecare modificare se încheie cu recitirea contului.
Majusculele sunt punctul de urmărit. Tastați ClientulMeu și WHM creează clientulmeu, raportează succes și nu pomenește nimic. Un identificator care nu mai corespunde serverului ar face contul să dispară din panou la următoarea interogare completă, așa că Provibr trece numele la litere mici înainte de a-l trimite și reține numele returnat de server.

Preluarea conturilor care există deja

Fila de import listează conturile de pe panou și vă permite să le preluați în Provibr pe cele dorite. Conturile deja cunoscute sunt afișate, dar nu pot fi selectate din nou, astfel încât vedeți tabloul întreg, nu unul filtrat.

Conturile importate se socotesc în capacitatea dumneavoastră exact ca și conturile comandate. Dacă importați mai multe decât aveți loc, se deschide o depășire, cu perioada de grație obișnuită.

Consum

Spațiul ocupat și traficul sosesc odată cu interogarea obișnuită, așa că un cont primește un grafic de consum fără să fie activat nimic în plus. Traficul este un total lunar pe care serverul îl resetează singur, așa că apare ca număr la cont și nu ca linie în grafic.

Imediat după o schimbare de pachet, contul își raportează noul pachet pe loc, iar noua limită de trafic câteva minute mai târziu. Numele contează imediat, iar cifra se aliniază la o interogare ulterioară; faptul că cele două diferă pentru o clipă nu este o defecțiune.

Bine de știut

  • Administrarea serverului însuși nu există. Provibr creează, modifică și șterge conturi pe un WHM pe care îl operați dumneavoastră; serviciile, zonele DNS, dirijarea poștei și setările panoului rămân unde sunt.
  • Nu există consolă. Un cont de găzduire nu este o mașină, așa că nu există nimic de care să se atașeze un terminal.
  • Cutiile poștale, bazele de date și DNS-ul din interiorul unui cont aparțin cPanel. Provibr creează contul și îl predă; ce se întâmplă în interior privește clientul dumneavoastră și panoul.
  • Conturile de revânzător nu sunt modelate. Provibr vorbește cu WHM ca un singur operator, iar un token al unui revânzător vede o lume mai mică decât root. Acel caz nu a fost măsurat și nu este descris aici.