Přeskočit na obsah
Koncept

Full-stack VPS

VPS, který se zřizuje s vlastním omezeným klíčem API, připravený pro váš kód, CLI a AI agenty.

Full-stack VPS je běžný server hostovaný u Xuda s předinstalovaným xuda-cli, codex a vlastním automaticky vydaným omezeným klíčem API, takže se stroj sám, váš kód na něm běžící, CLI nebo AI agent mohou ve chvíli startu obrátit zpět na ekosystém Xuda. Zřizování se spouští z dashboardu: deploy_full_stack_vps je metoda jen pro relaci. Zajímavé pro tuto stránku je to, co vám to zřizovací volání předá.

Co zřizování vydá

Vytvoří se omezený klíč

Vlastní klíč API stroje se vytvoří před zřízením, omezený skupinami schopností full_stack_tools zvolenými při vytvoření: přístup k souborům, přístup SSH, pravidla firewallu, připojení domény a další. Každá skupina se rozbalí na sadu stejných metod platformy, které popisuje celá tato sekce API.

Klíč a endpoint se zapíšou do aplikace

full_stack_vps.api_key_id, full_stack_vps.tools a full_stack_vps.mcp_url skončí v dokumentu aplikace, takže nástroje stroje je při startu mohou přečíst, aniž by klíč ručně kopíroval člověk.

Stroj se připojí sám

Cloud-init zapíše klíč do /root/xuda.config.js a /etc/profile.d/xuda.sh, takže shell na stroji, CLI nebo codex už mají XUDA_API_KEY a XUDA_AGENT_KEY ve svém prostředí.

Schopnosti se nastavují při vytvoření

Skupiny nástrojů, které klíč stroje nese, se nastavují při zřízení stroje, proto v tu chvíli zvolte skupiny, které potřebuje.

Co může klíč stroje volat

Metody, ke kterým má klíč Full-stack VPS přístup, jsou stejné rozhraní pro soubory, SSH a firewall popsané na stránce Externí VPS: vps_fs_list, vps_fs_read, vps_fs_write a zbytek rodiny 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 a get_app_server_usage pro čtení vlastního stavu stroje.

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

Přes MCP

full_stack_vps.mcp_url ukazuje na stejný endpoint MCP, který používá každý klíč. Stroj, jehož klíč nese rozsah full_stack_vps, má vedle metod ekosystému zpřístupněné i nástroje nainstalovaných pluginů z vlastní aplikace stroje, takže agent připojený ke stroji dosáhne obojí v jedné relaci.

Metody

Stejná úplná tabulka app_module, na kterou odkazují Externí VPS a Vývojová platforma. Klíč stroje dosáhne jen na řádky pro soubory, SSH, firewall a domény uvedené výše, ne na každý řádek, který tato tabulka uvádí.