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
- Activeer de Provisioning Module en installeer en activeer daarna Pterodactyl in Admin > Extensies.
- Sla
panel_urlop alshttp- ofhttps-paneelroot zonder inloggegevens of API-pad, bijvoorbeeldhttps://panel.example.com, samen met de Application API-key. De key wordt versleuteld opgeslagen en nooit opnieuw getoond. - Zet
user_idop de Pterodactyl-gebruiker die de aangemaakte servers bezit. Dit is een paneelgebruikers-ID, geen Agovena-klant-ID. - Sla desgewenst
client_api_keyop om starten, stoppen en herstarten door klanten mogelijk te maken. De Application- en Client-key zijn niet uitwisselbaar. - Laat
verify_tlsaan. Zet die alleen uit voor een bekend paneel met self-signed certificaat. - Voer Test connection uit.
- Kies op elk provisionable product Pterodactyl en stel
location_id,nest_id,egg_iden de limieten in:memory,swap,disk,io,cpu,databases,allocations,backupsendedicated_ip. Legedocker_imageenstartupvallen terug op de egg-waarden.environmentbevat egg-variabelen alsKEY=valueper 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 inpterodactyl_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,
installingenrestoring_backupblijven provisioning,install_failedwordt 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.