Saltar al contenido
Verificada

External VPS

Conecta un servidor Linux que ya tienes y gestiona sus archivos, el acceso SSH y los servicios.

External VPS conecta a Xuda por SSH un servidor Linux que ya tienes y luego te permite automatizarlo en lugar de hacer clic en el panel: leer sus métricas en vivo, gestionar a distancia su sistema de archivos y sus servicios, publicarlo en una URL HTTPS pública y crear accesos SSH de desarrollador con token. Treinta y cuatro de sus métodos son accesibles con una clave de API de cuenta, y toda la superficie está disponible también para un agente de IA por MCP.

Trabajar con el sistema de archivos

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 y vps_fs_tail se ejecutan por SFTP contra la máquina conectada. Todas las rutas son absolutas y una escritura sobrescribe, no añade, así que llama primero a vps_fs_mkdir cuando el directorio padre pueda no existir.

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

vps_fs_write_batch escribe hasta 128 archivos en una sola llamada con una única sesión SFTP, creando los directorios padre según haga falta, el camino rápido para subir una carpeta. No es atómico: un archivo fallido no aborta el resto, así que lee su recuento failed y el array results por ruta en lugar de fiarte solo de un sobre code: 1.

Publicación y acceso

vps_enable_web_url / vps_disable_web_url y vps_set_web_port ponen la máquina en una URL HTTPS pública. vps_ssh_access_create crea una credencial SSH de desarrollador con token cada vez, _list, _update, _rotate, _set_status y _delete la gestionan después, y vps_ssh_session_events / vps_ssh_command_log leen lo que ocurrió con ella. agent_firewall_list / _open / _close gestionan los puertos abiertos de la máquina, y agent_domain_connect (consulta Dominios) apunta uno de tus dominios a ella.

Métodos

La tabla de abajo es el catálogo completo de app_module, el mismo que enlaza Plataforma de desarrollo: todos los métodos de archivos, SSH y firewall de VPS anteriores están en ella, junto con el resto de lo que hace ese microservicio.

agent_domain_list / agent_domain_connect están en la tabla de Domains y get_deploy_info está en la tabla de Deploy, consulta Dominios y Cloud Hosting. save_deploy_settings sigue en esta misma tabla de arriba, junto con el resto de app_module.