Naar de inhoud springen
Concept

Full Stack VPS

Een VPS die wordt ingericht met een eigen sleutel met beperkt bereik, klaar voor je code, de CLI en AI-agents.

Een Full Stack VPS is een standaardserver die door Xuda wordt gehost, vooraf geladen met de xuda-cli, codex en een eigen automatisch uitgegeven API-sleutel met beperkt bereik, zodat de machine zelf, je code die erop draait, de CLI of een AI-agent op het moment van opstarten terug kan bellen naar het Xuda-ecosysteem. Het inrichten gebeurt vanuit het dashboard: deploy_full_stack_vps is een methode die alleen voor sessies is. Wat die inrichtingsaanroep je geeft, is het interessante deel voor deze pagina.

Wat het inrichten uitgeeft

Er wordt een sleutel met beperkt bereik aangemaakt

De eigen API-sleutel van de machine wordt aangemaakt vóór het inrichten, begrensd door de capaciteitsgroepen full_stack_tools die bij het aanmaken zijn gekozen: bestandstoegang, SSH-toegang, firewallregels, domeinkoppeling en meer. Elke groep breidt uit tot een set van dezelfde platformmethoden die in dit hele API-gedeelte worden beschreven.

De sleutel en het endpoint worden op de app gezet

full_stack_vps.api_key_id, full_stack_vps.tools en full_stack_vps.mcp_url komen in het appdocument terecht, zodat de eigen tooling van de machine ze bij het opstarten kan lezen zonder dat iemand met de hand een sleutel kopieert.

De machine verbindt zichzelf

Cloud-init schrijft de sleutel naar /root/xuda.config.js en /etc/profile.d/xuda.sh, zodat een shell op de machine, de CLI of codex XUDA_API_KEY en XUDA_AGENT_KEY al in de omgeving heeft.

Capaciteiten worden bij het aanmaken ingesteld

De toolgroepen die de sleutel van een machine heeft, worden vastgelegd als de machine wordt ingericht, dus kies op dat moment de groepen die hij nodig heeft.

Wat de sleutel van de machine kan aanroepen

De methoden die een sleutel van een Full Stack VPS bereikt, zijn hetzelfde oppervlak voor bestanden, SSH en firewall als beschreven bij Externe VPS: vps_fs_list, vps_fs_read, vps_fs_write en de rest van de familie vps_fs_*, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, plus get_platform_regions, get_account_vps, get_deploy_info en get_app_server_usage om de eigen status van de machine te lezen.

curl -s https://xuda.ai/cpi/vps_fs_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_BOX_API_KEY","path":"/var/www"}'
const res = await fetch('https://xuda.ai/cpi/vps_fs_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_BOX_API_KEY', path: '/var/www' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/vps_fs_list',
    json={'api_key': 'YOUR_BOX_API_KEY', 'path': '/var/www'},
)

Via MCP

full_stack_vps.mcp_url wijst naar hetzelfde MCP-endpoint dat elke sleutel gebruikt. Een machine waarvan de sleutel het bereik full_stack_vps heeft, krijgt ook alle geïnstalleerde plugintools uit de eigen app van de machine naast de ecosysteemmethoden beschikbaar, zodat een agent die met de machine is verbonden beide in één sessie bereikt.

Methoden

Dezelfde volledige tabel van app_module waar Externe VPS en Ontwikkelplatform naar linken. De sleutel van een machine bereikt alleen de hierboven genoemde rijen voor bestanden, SSH, firewall en domeinen, niet elke rij die deze tabel toont.