Vai al contenuto
Bozza

VPS full stack

Un VPS che viene attivato con una propria chiave API limitata, pronto per il tuo codice, la CLI e gli agenti AI.

Un VPS full stack è un normale server ospitato da Xuda con preinstallati xuda-cli, codex e una propria chiave API limitata emessa automaticamente, così la macchina stessa, il tuo codice che vi gira, la CLI o un agente AI possono richiamare l'ecosistema Xuda nel momento in cui si avvia. L'attivazione avviene dalla dashboard: deploy_full_stack_vps è un metodo riservato alle sessioni. Ciò che quella chiamata di attivazione ti consegna è la parte interessante di questa pagina.

Cosa emette l'attivazione

Viene creata una chiave limitata

La chiave API della macchina viene creata prima dell'attivazione, limitata dai gruppi di funzionalità full_stack_tools scelti alla creazione: accesso ai file, accesso SSH, regole del firewall, collegamento dei domini e altro, e ogni gruppo si espande in un insieme degli stessi metodi della piattaforma documentati in questa sezione API.

La chiave e l'endpoint vengono registrati sull'app

full_stack_vps.api_key_id, full_stack_vps.tools e full_stack_vps.mcp_url finiscono nel documento dell'app, così gli strumenti della macchina possono leggerli all'avvio senza che una persona copi una chiave a mano.

La macchina si collega da sola

Cloud-init scrive la chiave in /root/xuda.config.js e /etc/profile.d/xuda.sh, così una shell sulla macchina, la CLI o codex hanno già XUDA_API_KEY e XUDA_AGENT_KEY nel proprio ambiente.

Le funzionalità si impostano alla creazione

I gruppi di strumenti che la chiave di una macchina porta vengono impostati quando la macchina viene attivata, quindi scegli in quel momento i gruppi che le servono.

Cosa può chiamare la chiave della macchina

I metodi che una chiave di VPS full stack raggiunge sono la stessa superficie di file, SSH e firewall documentata in VPS esterno: vps_fs_list, vps_fs_read, vps_fs_write e il resto della famiglia vps_fs_*, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, più get_platform_regions, get_account_vps, get_deploy_info e get_app_server_usage per leggere lo stato della macchina stessa.

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

Tramite MCP

full_stack_vps.mcp_url punta allo stesso endpoint MCP che usa ogni chiave. Una macchina la cui chiave porta l'ambito full_stack_vps espone anche gli strumenti dei plugin installati dall'app della macchina accanto ai metodi dell'ecosistema, così un agente collegato alla macchina raggiunge entrambi in un'unica sessione.

Metodi

La stessa tabella completa di app_module a cui rimandano VPS esterno e Piattaforma di sviluppo. La chiave di una macchina raggiunge solo le righe di file, SSH, firewall e domini indicate sopra, non ogni riga elencata da questa tabella.