Aller au contenu
Vérifié

VPS externe

Connectez un serveur Linux que vous possédez déjà, et pilotez ses fichiers, son accès SSH et ses services.

Un VPS externe connecte à Xuda, via SSH, un serveur Linux que vous possédez déjà, puis vous permet de le scripter plutôt que de cliquer dans le tableau de bord : lire ses métriques en direct, piloter son système de fichiers et ses services à distance, le publier sur une URL HTTPS publique et créer un accès SSH développeur par jeton. Trente-quatre de ses méthodes sont accessibles avec une clé API de compte, et toute la surface est disponible aussi pour un agent IA via MCP.

Travailler avec le système de fichiers

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 et vps_fs_tail s'exécutent via SFTP sur la machine connectée. Chaque chemin est absolu, et une écriture remplace le contenu au lieu de l'ajouter, donc appelez d'abord vps_fs_mkdir quand le dossier parent peut ne pas exister.

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

vps_fs_write_batch écrit jusqu'à 128 fichiers en un seul appel sur une seule session SFTP, en créant les dossiers parents au besoin : la voie rapide pour envoyer un dossier. Il n'est pas atomique : un fichier en échec n'interrompt pas les autres, donc lisez son compteur failed et le tableau results par chemin plutôt que de vous fier à la seule enveloppe code: 1.

Publication et accès

vps_enable_web_url / vps_disable_web_url et vps_set_web_port placent la machine sur une URL HTTPS publique. vps_ssh_access_create crée un identifiant SSH développeur par jeton à la fois, _list, _update, _rotate, _set_status et _delete le gèrent ensuite, et vps_ssh_session_events / vps_ssh_command_log relisent ce qui s'est passé dessus. agent_firewall_list / _open / _close gèrent les ports ouverts de la machine, et agent_domain_connect (voir Domaines) y fait pointer l'un de vos domaines.

Méthodes

Le tableau ci-dessous est le catalogue complet d'app_module, le même que celui vers lequel renvoie Plateforme de développement : chaque méthode de fichiers, SSH et pare-feu de VPS ci-dessus y figure, avec le reste de ce que fait ce microservice.

agent_domain_list / agent_domain_connect figurent dans le tableau Domains et get_deploy_info dans le tableau Deploy, voir Domaines et Hébergement cloud. save_deploy_settings reste dans ce même tableau ci-dessus, avec le reste d'app_module.