Ga naar de inhoud
agovena.
agovena.
Aan de slag
Community

Providerhandleidingen

Pterodactyl: instellen en beheren

Lever gameservers op een Pterodactyl-paneel vanuit betaalde producten, met levenscyclusacties, planwijzigingen, statussync en poweracties voor klanten.

Op deze pagina

Status en werkwijze

De Pterodactyl-extension maakt via de Pterodactyl Application API één panelserver per Agovena-dienst. De extension ondersteunt aanmaken, opschorten, hervatten, beëindigen, planwijzigingen, statussynchronisatie en een klantpaneel. Met een optionele Client API-key kunnen klanten hun server ook starten, stoppen en herstarten. Locatie, nest, egg en resourcelimieten zijn productinstellingen van de Provisioning Module, geen Core-productkolommen.

Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Pterodactyl Application- en Client-API en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Pterodactyl-account blijft de verantwoordelijkheid van de beheerder: doorloop één betaalde dienst van aanmaken en installeren tot opschorten, hervatten en beëindigen op een wegwerpserver voordat je het product verkoopt. Bewerkingen onder Niet ondersteund worden niet aangeboden.

Vereisten

  • Agovena Core ^0.0.1.
  • De Provisioning Module, geactiveerd vóór deze extension.
  • Een Pterodactyl-paneel dat de Agovena-server kan bereiken, een Application API-key en het paneelgebruikers-ID dat de aangemaakte servers bezit.
  • Optioneel: een Client API-key voor poweracties door klanten.

Het pakket instellen

  1. Activeer de Provisioning Module en installeer en activeer daarna Pterodactyl in Admin > Extensies.
  2. Sla panel_url op als http- of https-paneelroot zonder inloggegevens of API-pad, bijvoorbeeld https://panel.example.com, samen met de Application API-key. De key wordt versleuteld opgeslagen en nooit opnieuw getoond.
  3. Zet user_id op de Pterodactyl-gebruiker die de aangemaakte servers bezit. Dit is een paneelgebruikers-ID, geen Agovena-klant-ID.
  4. Sla desgewenst client_api_key op om starten, stoppen en herstarten door klanten mogelijk te maken. De Application- en Client-key zijn niet uitwisselbaar.
  5. Laat verify_tls aan. Zet die alleen uit voor een bekend paneel met self-signed certificaat.
  6. Voer Test connection uit.
  7. Kies op elk provisionable product Pterodactyl en stel location_id, nest_id, egg_id en de limieten in: memory, swap, disk, io, cpu, databases, allocations, backups en dedicated_ip. Lege docker_image en startup vallen terug op de egg-waarden. environment bevat egg-variabelen als KEY=value per regel en wordt als secret bewaard.

Ondersteunde bewerkingen

  • Aanmaken van een server met extern ID agovena-{serviceInstanceId} voor de ingestelde eigenaar, locatie, nest, egg en limieten. De koppeling staat in pterodactyl_servers.
  • Opschorten, hervatten en beëindigen van de gekoppelde server.
  • Plan wijzigen door de nieuwe productlimieten en egg-instellingen op de gekoppelde server toe te passen.
  • Statussync: een opgeschorte server wordt opgeschort, een actieve server wordt actief, installing en restoring_backup blijven provisioning, install_failed wordt mislukt en elke andere of onjuiste status gaat naar handmatige controle.
  • Klantpaneel voor de gekoppelde server.
  • Poweracties starten, stoppen en herstarten, alleen met een ingestelde Client API-key. Stoppen en herstarten zijn gemarkeerd als gevaarlijke acties.

Niet ondersteund

  • Poweracties zonder Client API-key, en powersignalen anders dan starten, stoppen en herstarten.
  • Een Agovena-klant als paneeleigenaar gebruiken. Servers worden altijd aangemaakt voor het ingestelde user_id.

Foutafhandeling en eigendom

  • Aanmaakverzoeken sturen het vaste externe ID agovena-{serviceInstanceId} mee. Een nieuwe poging zoekt dat ID eerst op voordat er een andere server wordt gemaakt, dus een onderbroken aanmaak leidt niet tot een dubbele server.
  • Eigendom en configuratie worden gecontroleerd voordat een opgeslagen koppeling wordt gebruikt. Een onjuiste koppeling, ontbrekende allocatie of afwijkende eigenaar moet je onderzoeken, niet omzeilen door een extern ID te wijzigen.
  • Uitschakelen van de extension bewaart de dienstrecords en de koppeltabel pterodactyl_servers.
  • Redirects staan uit en providercalls worden geweigerd in de demo-omgeving. De Application API-key wordt nooit aan klanten getoond.
  • Paneelhosts in een privénetwerk zijn toegestaan, omdat self-hosted panelen vaak in een LAN draaien. Een Admin die de extension mag instellen, kan Agovena daardoor naar een interne URL laten wijzen. Dat is een bewuste mogelijkheid voor beheerders, geen klantinvoer.
  • Een gestopt gameserverproces is niet hetzelfde als een opgeschorte dienst. Laat queue workers en statussynchronisatie draaien, zodat lange installaties worden bijgewerkt.

Configuratiecontract

Veld Type Verplicht Geheim Standaard
panel_url string Ja Nee Leeg
application_api_key string Ja Ja Leeg
client_api_key string Nee Ja Leeg
user_id string Ja Nee Leeg
verify_tls boolean Nee Nee true
timeout string Nee Nee "15"

client_api_key is optioneel in het manifest, maar nodig voor poweracties door klanten. Productinstellingen zoals location_id, nest_id en egg_id stel je per product in, niet in deze tabel. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie