Przejdź do treści
Zweryfikowano

Zewnętrzne VPS

Połącz Linuksowy serwer, który już masz, i steruj jego plikami, dostępem SSH i usługami.

Zewnętrzne VPS łączy z Xuda przez SSH Linuksowy serwer, który już masz, a potem pozwala Ci skryptować jego obsługę zamiast klikać w panelu: czytać jego metryki na żywo, zdalnie sterować jego systemem plików i usługami, publikować go pod publicznym adresem HTTPS i wystawiać tokenizowany dostęp SSH dla deweloperów. Trzydzieści cztery z jego metod są dostępne z kluczem API konta, a cała powierzchnia jest dostępna także dla agenta AI przez MCP.

Praca z systemem plików

vps_fs_list, vps_fs_read, vps_fs_write, vps_fs_write_batch, vps_fs_mkdir, vps_fs_rename, vps_fs_delete, vps_fs_search, vps_fs_disk_usage i vps_fs_tail działają przez SFTP na podłączonej maszynie. Każda ścieżka jest bezwzględna, a zapis nadpisuje, a nie dopisuje, więc wywołaj najpierw vps_fs_mkdir, gdy katalog nadrzędny może nie istnieć.

curl -s https://xuda.ai/cpi/vps_fs_write \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","path":"/var/www/site/index.html","content":"<h1>Hello</h1>"}'
const res = await fetch('https://xuda.ai/cpi/vps_fs_write', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    path: '/var/www/site/index.html',
    content: '<h1>Hello</h1>',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/vps_fs_write',
    json={
        'api_key': 'YOUR_API_KEY',
        'app_id': 'YOUR_APP_ID',
        'path': '/var/www/site/index.html',
        'content': '<h1>Hello</h1>',
    },
)
Przesyłanie folderu

vps_fs_write_batch zapisuje do 128 plików jednym wywołaniem w jednej sesji SFTP, tworząc w razie potrzeby katalogi nadrzędne, to szybka ścieżka do przesłania folderu. Nie jest atomowe: jeden nieudany plik nie przerywa reszty, więc czytaj jego licznik failed i tablicę results dla każdej ścieżki, a nie polegaj samej kopercie code: 1.

Publikowanie i dostęp

vps_enable_web_url / vps_disable_web_url i vps_set_web_port wystawiają maszynę pod publicznym adresem HTTPS. vps_ssh_access_create wystawia po jednym tokenizowanym poświadczeniu SSH dla dewelopera naraz, a _list, _update, _rotate, _set_status i _delete zarządzają nim potem, a vps_ssh_session_events / vps_ssh_command_log odczytują, co się przez nie działo. agent_firewall_list / _open / _close zarządzają otwartymi portami maszyny, a agent_domain_connect (zobacz Domeny) kieruje na nią jedną z Twoich domen.

Metody

Poniższa tabela to pełny katalog app_module, ten sam, do którego prowadzi Platforma deweloperska: znajduje się w niej każda z powyższych metod VPS, SSH i zapory, obok reszty tego, co robi ten mikroserwis.

agent_domain_list / agent_domain_connect są w tabeli Domen, a get_deploy_info w tabeli Deploy, zobacz Domeny i Cloud Hosting. save_deploy_settings zostaje w tej samej tabeli powyżej, obok reszty app_module.