Săriți la conținut

Documentație

WISP

Conectați un panou WISP și Provibr construiește, rulează și șterge servere de jocuri pe el. WISP este o bifurcație a lui Pterodactyl, așa că modelul este același; pagina de față acoperă locurile în care diferă.

Un panou găzduit, propriul dumneavoastră nod

WISP se vinde ca serviciu găzduit: wisp.gg rulează panoul, iar nodul care vă poartă serverele de jocuri rulează pe propriul dumneavoastră hardware. Agentul vorbește cu panoul prin API-ul lui și cu daemonul nodului pentru consolă, amândouă spre exterior, așa că nu trebuie deschis nimic către internet.

Pentru că panoul nu este al dumneavoastră, nu aveți nimic de actualizat și nimic de fixat: WISP își poate schimba API-ul fără o lansare pe care s-o controlați. Provibr este testat pe v3.7.5 și citește chiar din panou versiunea care rulează, așa că o abatere apare în testul de conexiune, nu într-o comandă eșuată.

Două chei API

WISP păstrează împărțirea din Pterodactyl în două API-uri, iar nicio cheie nu ajunge la amândouă. Creați-le pe un cont de administrator și lipiți-le pe amândouă, împreună cu adresa panoului.

  • Adresa panoului: adresa completă, de exemplu https://panel.example.com. Adăugați un port doar dacă panoul chiar rulează pe unul; un panou aflat în spatele unui reverse proxy răspunde pe portul implicit al schemei sale.
  • Cheia API de aplicație: folosită pentru a construi, suspenda, reinstala și șterge servere.
  • Cheia API de client: folosită pentru comenzile de alimentare, statisticile live și consolă.
  • Amprentă TLS (opțional): lăsați-o goală pe un panou WISP găzduit; certificatul lui vine de la o autoritate publică și nu există nimic de fixat.
Cheile WISP nu au niciun prefix, spre deosebire de ptla_ al lui Pterodactyl și papp_ al lui Pelican. Nimic nu vă poate spune că le-ați inversat pe cele două: Provibr nu poate verifica asta, iar panoul răspunde la o cheie greșită cu un 403 gol, care se citește ca „permisiuni insuficiente”. Dacă testul de conexiune eșuează, încercați cele două chei invers, înainte de a schimba ceva în panou.
Cheia de aplicație înseamnă mai mult decât administrarea serverelor: aceeași listă de noduri pe care o citește Provibr expune și cheia de licență și tokenul de daemon ale nodului dumneavoastră. Tratați-o ca pe o acreditare pentru întregul panou și revocați-o în WISP dacă deconectați vreodată integrarea.

Transport

Un panou WISP găzduit este accesibil prin https cu un certificat de încredere publică, așa că acel câmp de amprentă rămâne gol. Completați-l doar când rulați dumneavoastră înșivă WISP în spatele unui certificat autosemnat; agentul are atunci încredere în acel singur certificat, în loc să dezactiveze verificarea. Citiți-o cu:

shell
openssl s_client -connect <host>:443 </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ă.

Lăsați câmpul gol pentru un certificat de la o autoritate publică, precum și atunci când panoul este accesibil doar prin http: o amprentă alături de o adresă http este refuzată, pentru că nu există niciun certificat de fixat. Un panou pe http simplu funcționează, dar ambele chei circulă atunci necriptate.

Egg-uri

Un server este construit dintr-un egg, exact ca pe Pterodactyl. WISP își enumeră toate egg-urile împreună cu variabilele lor într-un singur apel, așa că lista de alegere se completează singură, iar un plan poate înlocui orice variabilă pe care egg-ul o marchează ca fiind editabilă.

Lăsați goală o variabilă obligatorie și WISP nu refuză comanda: completează în tăcere valoarea implicită a egg-ului. Primiți un server care funcționează, doar că nu este cel pe care l-ați comandat. Provibr verifică variabilele obligatorii înainte de a trimite, așa că în schimb comanda se oprește cu un mesaj care numește variabila.

Planuri

Un plan de jocuri poartă egg-ul, limitele de resurse și eventualele valori care înlocuiesc variabilele. Comanda trece printr-un plan: planul decide ce egg este folosit și ce poate consuma serverul, iar un singur plan poate fi legat de mai multe panouri.

Plasare

Un nod WISP își raportează nucleele, memoria și discul, dar nu și cât din acestea este deja distribuit. Provibr adună asta din serverele aflate pe nod, exact ce face și pentru un hipervizor.

Nodul în sine este ales de agent, nu de motorul de plasare: acesta alege nodul cu cea mai multă memorie liberă și prima alocare de port liberă de pe el. Clasarea nodurilor unui panou WISP din Provibr nu există încă.

Ciclu de viață

Crearea, pornirea, oprirea, repornirea, oprirea forțată, suspendarea, ridicarea suspendării, reinstalarea și ștergerea funcționează toate. Un server suspendat poate fi totuși șters, iar ștergerea lui eliberează din nou alocarea lui de port.

WISP nu raportează o instalare eșuată. Un server este fie marcat ca instalat, fie nu, iar „încă se lucrează la el” și „ceva a mers prost” arată identic din afară. Dacă un server nou rămâne neinstalat mult mai mult decât durează în mod obișnuit un egg, deschideți-i consola în WISP și citiți acolo ieșirea instalării.

Consolă și metrici

Consola este un terminal în timp real pe daemonul nodului, în același panou ca restul infrastructurii dumneavoastră, iar graficele de utilizare vin din măsurătorile proprii ale panoului. Procesorul, memoria, discul și rețeaua sunt citite la fiecare rundă de interogare; WISP nu raportează timpul de funcționare, așa că un container care repornește între două runde nu este întotdeauna recunoscut ca o repornire.

Ce nu face Provibr

Provibr nu administrează panoul, nodurile lui, fișierele, backupurile, bazele de date sau utilizatorii, iar niciunul dintre adaosurile proprii ale WISP (splitterul, subdomeniile, programările de wipe, magazinele de moduri) nu face parte din integrare. Un server de jocuri pe panou este ceea ce Provibr creează, socotește și tarifează; serverele pe care nu le-ați creat prin Provibr sunt lăsate în pace.