Hopp til innholdet
Utkast

Full stack-VPS

En VPS som klargjøres med sin egen avgrensede API-nøkkel, klar for koden din, CLI-et og AI-agenter.

En Full stack-VPS er en vanlig Xuda-hostet server som er forhåndslastet med xuda-cli, codex og sin egen automatisk utstedte, avgrensede API-nøkkel, slik at selve boksen, koden din som kjører på den, CLI-et eller en AI-agent kan kalle tilbake til Xuda-økosystemet i det øyeblikket den starter. Klargjøringen kjøres fra dashbordet: deploy_full_stack_vps er en metode som kun er for økter. Det klargjøringskallet gir deg, er den interessante delen på denne siden.

Hva klargjøringen utsteder

En avgrenset nøkkel opprettes

Boksens egen API-nøkkel opprettes før klargjøringen, avgrenset av gruppene med full_stack_tools-egenskaper som ble valgt ved opprettelsen: filtilgang, SSH-tilgang, brannmurregler, domenetilkobling og mer. Hver gruppe utvides til et sett av de samme plattformmetodene som er dokumentert i hele denne API-delen.

Nøkkelen og endepunktet stemples på appen

full_stack_vps.api_key_id, full_stack_vps.tools og full_stack_vps.mcp_url havner i app-dokumentet, slik at boksens eget verktøy kan lese dem ved oppstart uten at en person kopierer en nøkkel for hånd.

Boksen kobler seg selv til

Cloud-init skriver nøkkelen inn i /root/xuda.config.js og /etc/profile.d/xuda.sh, slik at et skall på boksen, CLI-et eller codex allerede har XUDA_API_KEY og XUDA_AGENT_KEY i miljøet sitt.

Egenskapene settes ved opprettelsen

Verktøygruppene en boks' nøkkel har, settes når boksen klargjøres, så velg gruppene den trenger på det tidspunktet.

Hva boksens nøkkel kan kalle

Metodene en Full stack-VPS-nøkkel når, er den samme fil-, SSH- og brannmurflaten som er dokumentert under Ekstern VPS: vps_fs_list, vps_fs_read, vps_fs_write og resten av vps_fs_*-familien, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, pluss get_platform_regions, get_account_vps, get_deploy_info og get_app_server_usage for å lese boksens egen tilstand.

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

Over MCP

full_stack_vps.mcp_url peker på det samme MCP-endepunktet alle nøkler bruker. En boks hvis nøkkel har full_stack_vps-omfanget, får også eventuelle installerte plugin-verktøy fra boksens egen app eksponert ved siden av økosystemmetodene, slik at en agent som er koblet til boksen, når begge i én økt.

Metoder

Den samme fullstendige app_module-tabellen som Ekstern VPS og Utviklingsplattform lenker til. En boks' egen nøkkel når bare fil-, SSH-, brannmur- og domeneradene som er nevnt ovenfor, ikke hver rad denne tabellen lister.