Servidores VPS
Servidor Linux Ubuntu próprio com root, recursos do plano e controle total pelo painel ou via MCP.
- Categoria: Servidores e infraestrutura
- Estado: Disponível
- Requisitos: Uma empresa na ArduMaker sem cobranças vencidas; Ser admin da empresa para criar, mudar de plano, ligar, desligar ou mover o VPS; Um plano disponível para a empresa (o bloco
elegibilidadinforma) - Ferramentas MCP (Só leem):
listar_vps,listar_todos_los_vps,ver_vps,ver_estado_vps,listar_planes_vps,ver_opciones_vps,ver_funciones_vps,ver_funciones_por_sistema - Ferramentas MCP (Escrevem ou modificam):
crear_vps,editar_vps,cambiar_plan_vps - Ferramentas MCP (Destrutivas):
controlar_vps
O que permite fazer?
Um VPS da ArduMaker é um servidor Linux da própria empresa: um contêiner de sistema isolado com Ubuntu 22.04, acesso root e os recursos do plano escolhido. Tudo o resto é instalado sobre ele: apps, bancos de dados, deploys de Git, serviços e tarefas.
- Criar um servidor escolhendo plano, localização e tipo de disco (
nvme,ssdouhdd, conforme o que a localização oferecer). - Entrar por SSH como
rootou comoadmin(com sudo), com senhas aleatórias próprias desse VPS. - Ligar, desligar e reiniciar o servidor, e mudá-lo de plano (CPU, RAM e disco).
- Renomeá-lo, transferi-lo para outra empresa e decidir quais membros o veem (listas de permitidos e excluídos).
- Ver o estado ao vivo: CPU, memória, disco, tempo ligado e serviços em execução.
- Saber quais funções ele suporta conforme o sistema operacional informado pelo agente.
Quando convém usar?
- Você precisa de um servidor com
rootpara publicar uma aplicação, uma API ou um site. - Você quer instalar PostgreSQL, MySQL, Redis, n8n ou WordPress sem manter a máquina manualmente.
- Você quer que um agente de IA opere a infraestrutura via MCP com as mesmas permissões que você tem no painel.
Como funciona na ArduMaker?
Criar um VPS responde na hora com o estado creating. O provisionamento roda em segundo plano por alguns minutos e pode ser retomado: se algo for interrompido, continua do último estado salvo.
creating: o contêiner é lançado com Ubuntu 22.04 e os limites de CPU e memória do plano; depois o tamanho de disco do plano é aplicado ao disco raiz.create_api: o agente da ArduMaker é instalado dentro; por ele a plataforma lê o estado e executa as operações.assigning_port: o VPS recebe seu próprio nome DNS e o caminho privado até o agente é montado.updating_system:apt-get update,upgradeeautoremove, e um reinício do contêiner.installing_base_tools:sudo,curl,openssh-server,ca-certificates,python3-venv,python3-pip, Node.js LTS com npm enginx; senha aleatória pararoote a política de SSH.creating_user: o usuárioadmincom sudo e senha aleatória, que pede para ser trocada no primeiro acesso.active: o VPS fica pronto. A ArduMaker abre o SSH por 6 horas e envia o e-mail de boas-vindas com o servidor, a porta, o usuário, a senha inicial e o comandosshpronto para colar.
A plataforma também pode criar o VPS a partir de uma imagem base já atualizada. Nesse caminho os estados intermediários são importing_base, customizing (novas chaves SSH de host, senhas aleatórias próprias, hostname) e verifying. Se a verificação falhar, o contêiner é destruído e criado pelo caminho normal: um VPS pela metade nunca é entregue.
Todo VPS novo nasce com as permissões de contêiner que o Docker precisa (aninhamento e interceptação de chamadas de sistema), sem ser privilegiado. O daemon do Docker não é instalado sozinho: é instalado quando você pede ou quando um app precisa. Se o host não aceitar essas permissões, o VPS é criado assim mesmo, mais restrito, e o Docker aparece como não suportado.
O que muda realmente?
| O quê | Onde / como |
|---|---|
| Sistema | Ubuntu 22.04 atualizado com apt-get upgrade |
| Ferramentas | sudo, curl, openssh-server, python3-venv, python3-pip, Node.js LTS, npm e nginx |
Usuário root | Senha aleatória guardada criptografada; no primeiro acesso interativo por SSH pede uma nova |
Usuário admin | Com sudo e senha aleatória já vencida (chage -d 0) |
| SSH | Senha e chaves habilitadas; root pode entrar com senha conforme a política da plataforma |
| Mensagem de boas-vindas | MOTD da ArduMaker; o MOTD padrão do Ubuntu é desativado |
| Web | nginx instalado com a configuração padrão: é o servidor web interno ao qual chegam os domínios |
Estados do VPS
| Estado | Significado |
|---|---|
creating … creating_user | Criação em andamento (ver os passos) |
active | Pronto para usar |
stopped | Desligado |
migrating | Sendo movido para outra máquina |
errored | A criação não pôde terminar |
deleting / dead | Exclusão em andamento ou concluída |
Exclusão e cópia final
Ao excluir um VPS é guardada uma cópia final, que só os admins da empresa veem e podem baixar. O prazo depende do motivo: 90 dias se foi excluído por falta de pagamento; enquanto a conta estiver aberta se o cliente o excluiu (que pode pedir que seja apagada); 30 dias se a empresa foi encerrada. Os admins recebem um e-mail 7 dias antes da exclusão.
Esquema
- Pedido: painel ou
crear_vps; respondecreating - Backend da ArduMaker: fila de criação retomável
- Host: contêiner Ubuntu 22.04 com CPU, RAM e disco do plano
- Agente da ArduMaker: instalado dentro do VPS
- Atualização e ferramentas: apt, Node.js, nginx, SSH
- Usuários:
rooteadmincom senhas aleatórias - active: SSH aberto por 6 h e e-mail de boas-vindas
Resultado esperado
O VPS aparece como active no painel e em listar_vps. ver_estado_vps devolve em system_status a CPU, memória, disco, tempo ligado e serviços, lidos do próprio servidor.
- Para entrar, use o comando
sshdo e-mail de boas-vindas enquanto a janela de 6 horas estiver aberta. Depois ela é reaberta pela gestão de portas do VPS. ver_funciones_vpsconfirma quais funções estão disponíveis nesse sistema antes de instalar algo.
Erros e resolução
| Sintoma | Causa e o que fazer |
|---|---|
crear_vps responde 409 | A localização escolhida lotou entre a consulta e a criação. Escolha outra com ver_opciones_vps; não repita a mesma. |
| O plano aparece mas não pode ser criado | elegibilidad.puede é false e elegibilidad.codigo diz por quê (servidor gratuito já usado, escola sem vagas). Criar assim mesmo falha com esse código. |
empresa_en_mora | A empresa tem uma cobrança vencida: nada novo é criado até regularizar. |
funcion_no_disponible | A função não roda no sistema desse VPS (por exemplo, Docker no Ubuntu 16.04). Tentar de novo não adianta. |
| O agente não vê o VPS novo | A conexão MCP está limitada a certos VPS: o dono precisa adicioná-lo ao escopo da conexão. |
O progresso da criação é acompanhado com ver_vps (campo de estado). Se uma chamada de criação foi interrompida e você não sabe se chegou, repita com o mesmo idempotency_key e os mesmos argumentos: devolve o VPS original em vez de criar outro.
Relação com MCP
Todo o ciclo do VPS, exceto a exclusão, é operado via MCP com as permissões da pessoa que autorizou o agente. Referência completa em /mcp/docs e no domínio /mcp/vps.
| Tipo | Ferramentas |
|---|---|
| Leitura | listar_vps, listar_todos_los_vps, ver_vps, ver_estado_vps, listar_planes_vps, ver_opciones_vps, ver_funciones_vps, ver_funciones_por_sistema |
| Modificam (só admin) | crear_vps, editar_vps, cambiar_plan_vps |
| Destrutivas (só admin) | controlar_vps com stop ou restart |
Um agente autorizado como somente leitura vê as leituras, mas não as ferramentas que modificam. Antes de crear_vps, o agente deve conferir elegibilidad em listar_planes_vps e, se a localização importar, ver_opciones_vps.