Gå til indhold
Kladde

Full Stack VPS

En VPS, der klargøres med sin egen afgrænsede API-nøgle, klar til din kode, CLI'en og AI-agenter.

En Full Stack VPS er en almindelig Xuda-hostet server, der er forudinstalleret med xuda-cli, codex og sin egen automatisk udstedte, afgrænsede API-nøgle, så selve maskinen, din kode på den, CLI'en eller en AI-agent kan kalde tilbage ind i Xuda-økosystemet i det øjeblik, den starter. Klargøringen kører fra dashboardet: deploy_full_stack_vps er en metode kun til sessioner. Det interessante for denne side er, hvad det klargøringskald giver dig.

Hvad klargøringen udsteder

En afgrænset nøgle oprettes

Maskinens egen API-nøgle oprettes før klargøringen, afgrænset af de full_stack_tools-kapacitetsgrupper, der blev valgt ved oprettelsen: filadgang, SSH-adgang, firewallregler, domæneforbindelse og mere. Hver gruppe udvides til et sæt af de samme platformmetoder, der er beskrevet i hele denne API-sektion.

Nøglen og endpointet stemples på appen

full_stack_vps.api_key_id, full_stack_vps.tools og full_stack_vps.mcp_url havner på app-dokumentet, så maskinens eget værktøj kan læse dem ved opstart, uden at en person kopierer en nøgle i hånden.

Maskinen forbinder sig selv

Cloud-init skriver nøglen i /root/xuda.config.js og /etc/profile.d/xuda.sh, så et shell på maskinen, CLI'en eller codex allerede har XUDA_API_KEY og XUDA_AGENT_KEY i sit miljø.

Kapaciteter sættes ved oprettelsen

De værktøjsgrupper, en maskines nøgle har, sættes, når maskinen klargøres, så vælg de grupper, den har brug for, på det tidspunkt.

Hvad maskinens nøgle kan kalde

De metoder, en Full Stack VPS-nøgle når, er den samme fil-, SSH- og firewallflade, der er beskrevet under Ekstern VPS: vps_fs_list, vps_fs_read, vps_fs_write og resten af vps_fs_*-familien, 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 og get_app_server_usage til at læse maskinens 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'},
)

Via MCP

full_stack_vps.mcp_url peger på det samme MCP-endpoint, som hver nøgle bruger. En maskine, hvis nøgle har full_stack_vps-omfanget, får også alle installerede plugin-værktøjer fra maskinens egen app udstillet ved siden af økosystemmetoderne, så en agent, der er forbundet til maskinen, når begge i én session.

Metoder

Den samme fulde app_module-tabel, som Ekstern VPS og Udviklingsplatform linker til. En maskines egen nøgle når kun fil-, SSH-, firewall- og domænerækkerne nævnt ovenfor, ikke hver række, denne tabel viser.