Saltar para o conteúdo
Verificado

VPS externo

Ligue um servidor Linux que já possui e controle os seus ficheiros, o acesso SSH e os serviços.

O VPS externo liga à Xuda, por SSH, um servidor Linux que já possui, e depois permite-lhe automatizá-lo em vez de clicar no painel: ler as suas métricas em direto, controlar remotamente o seu sistema de ficheiros e os serviços, publicá-lo num URL HTTPS público e criar acesso SSH de programador baseado em tokens. Trinta e quatro dos seus métodos são acessíveis com uma chave de API de conta, e toda a superfície está disponível para um agente de IA através de MCP também.

Trabalhar com o sistema de ficheiros

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 correm por SFTP na máquina ligada. Todos os caminhos são absolutos e uma escrita é uma substituição, não um acrescento, por isso chame primeiro vps_fs_mkdir quando o diretório pai possa não 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>',
    },
)
Carregar uma pasta

vps_fs_write_batch escreve até 128 ficheiros numa só chamada, numa única sessão SFTP, criando os diretórios pai conforme necessário, o caminho rápido para carregar uma pasta. Não é atómico: um ficheiro que falhe não aborta os restantes, por isso leia a sua contagem failed e o array results por caminho em vez de confiar apenas num envelope code: 1.

Publicação e acesso

vps_enable_web_url / vps_disable_web_url e vps_set_web_port colocam a máquina num URL HTTPS público. vps_ssh_access_create cria uma credencial SSH de programador baseada em token de cada vez, _list, _update, _rotate, _set_status e _delete gerem-na depois, e vps_ssh_session_events / vps_ssh_command_log leem o que aconteceu através dela. agent_firewall_list / _open / _close gerem as portas abertas da máquina, e agent_domain_connect (consulte Domains) aponta um dos seus domínios para ela.

Métodos

A tabela abaixo é o catálogo completo do app_module, o mesmo para que a Plataforma de desenvolvimento aponta: todos os métodos de ficheiros, SSH e firewall de VPS acima estão nela, a par do resto do que esse microserviço faz.

agent_domain_list / agent_domain_connect estão na tabela Domains e get_deploy_info está na tabela Deploy, consulte Domains e Cloud Hosting. save_deploy_settings continua nesta mesma tabela acima, a par do resto do app_module.