Vai al contenuto
Verificata

VPS esterno

Collega un server Linux che già possiedi e gestisci i suoi file, l'accesso SSH e i servizi.

Il VPS esterno collega a Xuda tramite SSH un server Linux che già possiedi, poi ti permette di automatizzarlo con script invece di cliccare nella dashboard: leggere le sue metriche in tempo reale, gestire da remoto il suo filesystem e i suoi servizi, pubblicarlo su un URL HTTPS pubblico e creare un accesso SSH per sviluppatori basato su token. Trentaquattro dei suoi metodi sono raggiungibili con una chiave API dell'account, e l'intera superficie è disponibile anche a un agente AI tramite MCP.

Lavorare con il filesystem

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 e vps_fs_tail passano tramite SFTP sulla macchina collegata. Ogni percorso è assoluto e una scrittura è una sovrascrittura, non una aggiunta, quindi chiama prima vps_fs_mkdir quando la cartella padre potrebbe non esistere.

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

vps_fs_write_batch scrive fino a 128 file in una sola chiamata su un'unica sessione SFTP, creando le cartelle padre se necessario: il percorso rapido per caricare una cartella. Non è atomico: un file fallito non interrompe gli altri, quindi leggi il suo conteggio failed e l'array results per percorso invece di fidarti solo di un formato con code: 1.

Pubblicazione e accesso

vps_enable_web_url / vps_disable_web_url e vps_set_web_port mettono la macchina su un URL HTTPS pubblico. vps_ssh_access_create crea una credenziale SSH per sviluppatori basata su token alla volta, _list, _update, _rotate, _set_status e _delete la gestiscono in seguito, e vps_ssh_session_events / vps_ssh_command_log rileggono ciò che è successo tramite essa. agent_firewall_list / _open / _close gestiscono le porte aperte della macchina, e agent_domain_connect (vedi Domini) punta uno dei tuoi domini verso di essa.

Metodi

La tabella qui sotto è il catalogo completo di app_module, lo stesso a cui rimanda Piattaforma di sviluppo: ogni metodo VPS di file, SSH e firewall qui sopra è presente, insieme al resto di ciò che fa quel microservizio.

agent_domain_list / agent_domain_connect sono nella tabella Domini e get_deploy_info è nella tabella Deploy, vedi Domini e Cloud Hosting. save_deploy_settings resta in questa stessa tabella qui sopra, insieme al resto di app_module.