# Servidores VPS

Servidor Linux Ubuntu próprio com root, recursos do plano e controle total pelo painel ou via MCP.

Fonte: https://ardumaker.com/pt/docs/vps/

- 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 `elegibilidad` informa)
- 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`, `ssd` ou `hdd`, conforme o que a localização oferecer).
- Entrar por SSH como `root` ou como `admin` (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 `root` para publicar uma aplicação, uma API ou um site.
- Você quer instalar [PostgreSQL](https://ardumaker.com/pt/docs/postgresql), [MySQL](https://ardumaker.com/pt/docs/mysql), [Redis](https://ardumaker.com/pt/docs/redis), [n8n](https://ardumaker.com/pt/docs/n8n) ou [WordPress](https://ardumaker.com/pt/docs/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.

1. `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.
2. `create_api`: o agente da ArduMaker é instalado dentro; por ele a plataforma lê o estado e executa as operações.
3. `assigning_port`: o VPS recebe seu próprio nome DNS e o caminho privado até o agente é montado.
4. `updating_system`: `apt-get update`, `upgrade` e `autoremove`, e um reinício do contêiner.
5. `installing_base_tools`: `sudo`, `curl`, `openssh-server`, `ca-certificates`, `python3-venv`, `python3-pip`, Node.js LTS com npm e `nginx`; senha aleatória para `root` e a política de SSH.
6. `creating_user`: o usuário `admin` com sudo e senha aleatória, que pede para ser trocada no primeiro acesso.
7. `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 comando `ssh` pronto 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 |

> **INFO:** As senhas de criação não ficam em nenhum log. Só viajam no e-mail de boas-vindas, que serve para o primeiro acesso.

## 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.

> **PELIGRO:** Excluir o VPS remove todos os seus apps, repos e terminais. Não é feito via MCP.

## Esquema

**Criação de um VPS**

```text
Pedido (painel ou `crear_vps`; responde `creating`)
  ↓
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 (`root` e `admin` com 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 `ssh` do 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_vps` confirma 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.

> **PRECAUCION:** `stop` e `restart` interrompem tudo o que roda na máquina, inclusive os terminais web abertos, que ficam marcados como perdidos por reinício.

## 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](https://ardumaker.com/pt/mcp/docs) e no domínio [/mcp/vps](https://ardumaker.com/pt/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` |

> **INFO:** Excluir um VPS inteiro não existe via MCP, qualquer que seja o escopo do agente: só é feito pelo painel.

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`.

## Funcionalidades relacionadas

- [Planos de VPS](https://ardumaker.com/pt/docs/planes-vps/)
- [Terminal web](https://ardumaker.com/pt/docs/terminal-web/)
- [Usuários Linux](https://ardumaker.com/pt/docs/usuarios-linux/)
- [Firewall e portas](https://ardumaker.com/pt/docs/firewall-y-puertos/)
- [Cópias de segurança](https://ardumaker.com/pt/docs/backups/)
- [Monitoramento](https://ardumaker.com/pt/docs/monitorizacion/)