Zum Inhalt springen
Entwurf

Full Stack VPS

Ein VPS, der mit eigenem eingeschränktem API-Schlüssel bereitgestellt wird, bereit für deinen Code, die CLI und KI-Agents.

Ein Full Stack VPS ist ein normaler, von Xuda gehosteter Server, vorinstalliert mit der xuda-cli, mit codex und einem eigenen, automatisch ausgestellten, eingeschränkten API-Schlüssel, sodass die Box selbst, dein darauf laufender Code, die CLI oder ein KI-Agent im Moment des Starts das Xuda-Ökosystem zurückrufen kann. Die Bereitstellung läuft über das Dashboard: deploy_full_stack_vps ist eine Methode nur für Sitzungen. Was dieser Bereitstellungsaufruf dir mitgibt, ist der interessante Teil dieser Seite.

Was die Bereitstellung ausstellt

Ein eingeschränkter Schlüssel wird erstellt

Der eigene API-Schlüssel der Box wird vor der Bereitstellung erstellt, eingeschränkt durch die beim Erstellen gewählten Fähigkeitsgruppen full_stack_tools, Dateizugriff, SSH-Zugang, Firewall-Regeln, Domain-Verbindung und mehr, wobei sich jede Gruppe zu einem Satz derselben Plattformmethoden erweitert, die in diesem API-Abschnitt dokumentiert sind.

Schlüssel und Endpunkt werden auf der App vermerkt

full_stack_vps.api_key_id, full_stack_vps.tools und full_stack_vps.mcp_url landen im App-Dokument, damit das eigene Tooling der Box sie beim Start lesen kann, ohne dass eine Person einen Schlüssel von Hand kopiert.

Die Box verbindet sich selbst

Cloud-init schreibt den Schlüssel in /root/xuda.config.js und /etc/profile.d/xuda.sh, sodass eine Shell auf der Box, die CLI oder codex XUDA_API_KEY und XUDA_AGENT_KEY bereits in ihrer Umgebung haben.

Fähigkeiten werden beim Erstellen festgelegt

Die Tool-Gruppen, die der Schlüssel einer Box trägt, werden bei der Bereitstellung der Box festgelegt, wähle die Gruppen, die sie braucht, also zu diesem Zeitpunkt.

Was der Schlüssel der Box aufrufen kann

Die Methoden, die ein Full-Stack-VPS-Schlüssel erreicht, sind dieselbe Datei-, SSH- und Firewall-Oberfläche, die unter External VPS dokumentiert ist: vps_fs_list, vps_fs_read, vps_fs_write und der Rest der Familie vps_fs_*, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, dazu get_platform_regions, get_account_vps, get_deploy_info und get_app_server_usage, um den eigenen Zustand der Box zu lesen.

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'},
)

Über MCP

full_stack_vps.mcp_url zeigt auf denselben MCP-Endpunkt, den jeder Schlüssel nutzt. Eine Box, deren Schlüssel den Geltungsbereich full_stack_vps trägt, stellt außerdem alle installierten Plugin-Tools aus der eigenen App der Box neben den Ökosystem-Methoden bereit, sodass ein mit der Box verbundener Agent beides in einer Sitzung erreicht.

Methoden

Dieselbe vollständige Tabelle von app_module, die External VPS und Entwicklungsplattform verlinken. Der eigene Schlüssel einer Box erreicht nur die oben genannten Zeilen für Dateien, SSH, Firewall und Domains, nicht jede Zeile, die diese Tabelle auflistet.