Przejdź do treści
Wersja robocza

Full Stack VPS

VPS przydzielany z własnym kluczem API o ograniczonym zakresie, gotowy na Twój kod, CLI i agentów AI.

Full Stack VPS to standardowy serwer hostowany przez Xuda, z preinstalowanym xuda-cli, codex i własnym, automatycznie wystawionym kluczem API o ograniczonym zakresie, dzięki czemu sama maszyna, działający na niej Twój kod, CLI albo agent AI może wywołać ekosystem Xuda od momentu startu. Przydzielanie działa z panelu: deploy_full_stack_vps to metoda tylko dla sesji. Dla tej strony ciekawe jest to, co to wywołanie przydzielania Ci daje.

Co wystawia przydzielanie

Powstaje klucz o ograniczonym zakresie

Własny klucz API maszyny jest tworzony przed przydzieleniem, z zakresem określonym przez grupy uprawnień full_stack_tools wybrane przy tworzeniu: dostęp do plików, dostęp SSH, reguły zapory, łączenie domeny i więcej, a każda grupa rozwija się w zestaw tych samych metod platformy opisanych w tej sekcji API.

Klucz i punkt końcowy są wpisane do aplikacji

full_stack_vps.api_key_id, full_stack_vps.tools i full_stack_vps.mcp_url trafiają do dokumentu aplikacji, więc własne narzędzia maszyny mogą je odczytać przy starcie, bez ręcznego kopiowania klucza przez człowieka.

Maszyna łączy się sama

Cloud-init zapisuje klucz w /root/xuda.config.js i /etc/profile.d/xuda.sh, więc powłoka na maszynie, CLI albo codex ma już XUDA_API_KEY i XUDA_AGENT_KEY w swoim środowisku.

Uprawnienia ustawia się przy tworzeniu

Grupy narzędzi, które niesie klucz maszyny, są ustawiane w chwili jej przydzielania, więc wybierz w tym momencie grupy, których potrzebuje.

Co może wywołać klucz maszyny

Metody dostępne dla klucza Full Stack VPS to ta sama powierzchnia plików, SSH i zapory opisana w Zewnętrzne VPS: vps_fs_list, vps_fs_read, vps_fs_write i reszta rodziny vps_fs_*, vps_enable_ssh / vps_rotate_ssh_token / vps_disable_ssh, agent_firewall_list / _open / _close, agent_domain_list / agent_domain_connect, a także get_platform_regions, get_account_vps, get_deploy_info i get_app_server_usage do odczytu własnego stanu maszyny.

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

Przez MCP

full_stack_vps.mcp_url wskazuje ten sam punkt końcowy MCP, którego używa każdy klucz. Maszyna, której klucz niesie zakres full_stack_vps, dostaje też narzędzia z zainstalowanych wtyczek z własnej aplikacji maszyny, wystawione obok metod ekosystemu, więc agent połączony z maszyną sięga po jedne i drugie w jednej sesji.

Metody

Ta sama pełna tabela app_module, do której prowadzą Zewnętrzne VPS i Platforma deweloperska. Klucz maszyny dosięga tylko wymienionych wyżej wierszy plików, SSH, zapory i domen, a nie każdego wiersza tej tabeli.