Receitas no Virtualizor: como automatizar a instalação da sua VPS

Toda vez que você reinstala uma VPS, repete a mesma sequência: atualizar o sistema, instalar o que usa, criar usuário, ajustar firewall. É trabalho manual que dá no mesmo resultado sempre — exatamente o tipo de coisa que dá para automatizar.

No painel Virtualizor isso se chama receita (recipe): um script que o painel executa sozinho quando a VPS sobe. Você escolhe a receita, o sistema é instalado, e quando você entra pela primeira vez o ambiente já está pronto.

Como funciona, em uma frase

Uma receita é um script guardado no painel. Você a seleciona ao instalar ou reinstalar a VPS, e ela é executada automaticamente no boot do sistema novo. Não é um comando que você roda depois — é parte do provisionamento.

Isso tem uma consequência prática que confunde muita gente na primeira vez: selecionar a receita numa VPS que já está rodando não faz nada sozinho. A execução acontece no ciclo de inicialização. Se você aplicar a receita com a máquina ligada, precisa desligar e ligar de novo para ela rodar.

Onde ficam as receitas

No painel do cliente (o Virtualizor, não a área do cliente da Vitt Host), procure a seção Recipes no menu lateral. Você vai ver duas coisas ali:

• As receitas publicadas por nós. São as que já estão prontas e ativadas para uso. Aparecem na lista sem que você precise fazer nada.
• As suas próprias receitas. Você pode criar quantas quiser. Elas ficam visíveis só para você e para a administração do painel — nenhum outro cliente enxerga o que você escreveu.

Usando uma receita pronta

O caminho curto, para quem só quer o ambiente montado:

1. Entre no painel Virtualizor com os acessos que você recebeu por e-mail na ativação.
2. Abra a VPS e vá em OS Re-Install (ou escolha a receita já na criação, se a VPS ainda não existe).
3. Selecione a distribuição e a versão do sistema.
4. Escolha a receita na lista.
5. Defina a senha de root e confirme a reinstalação.

A partir daí é esperar. O sistema é instalado, a receita roda no primeiro boot e a VPS fica pronta.

Antes de reinstalar, tenha backup. A reinstalação cria uma VPS nova e apaga os dados do disco. Não existe desfazer. A responsabilidade pela cópia de segurança é sua, conforme a cláusula 14 dos Termos de Uso — e vale montar uma rotina automatizada mesmo fora desse momento.

Criando a sua própria receita

Se o que você precisa não está na lista, escreva. Em Recipes → Add Recipes você preenche:

Exemplo em Linux

Uma receita que prepara uma VPS Ubuntu com Docker e firewall básico:

#!/bin/bash
set -e
exec > /var/log/receita-vitt.log 2>&1   # guarda tudo num log seu

apt-get update -y
apt-get upgrade -y
apt-get install -y curl ufw fail2ban

# Docker pelo script oficial
curl -fsSL https://get.docker.com | sh
systemctl enable --now docker

# Firewall: SSH liberado, resto fechado
ufw allow OpenSSH
ufw --force enable

echo "Receita concluída em $(date)"

A segunda linha é o truque que mais poupa tempo: exec > arquivo 2>&1 manda toda a saída do script para um arquivo. Sem isso, quando algo falha você fica sem pista nenhuma.

Exemplo em Windows

Receita para Windows tem uma regra diferente: o script precisa estar em formato Batch ou PowerShell. E há um detalhe que derruba muita gente — coloque os comandos direto, sem cabeçalho e sem código de inicialização. O painel detecta o formato pela receita selecionada.

Batch, direto:

mkdir C:\dados
net user suporte SenhaForte123! /add
net localgroup "Remote Desktop Users" suporte /add

Para rodar PowerShell, chame o PowerShell a partir do comando:

powershell -Command "Set-ExecutionPolicy RemoteSigned -Force; Install-WindowsFeature Web-Server -IncludeManagementTools"

Onde está o log

Quando a receita não faz o que você esperava, o log responde.

Em Windows, o Virtualizor grava os logs de execução na pasta virt_scripts, na unidade C:. Abra, procure o arquivo da sua receita e leia de baixo para cima — o erro costuma estar nas últimas linhas.

Em Linux, o caminho depende do que o seu script faz. É por isso que a linha exec > /var/log/receita-vitt.log 2>&1 do exemplo acima vale tanto: você decide onde o log fica e não depende de procurar.

Cinco coisas que evitam dor de cabeça

1. Teste antes de depender. Rode a receita numa VPS de teste antes de usá-la em produção. Reinstalar é barato; perder um ambiente que já estava funcionando, não.
2. Escreva script que pode rodar duas vezes. Use mkdir -p em vez de mkdir, cheque se o pacote já existe antes de instalar. Um script que quebra quando roda de novo é um script que você não pode reexecutar quando precisar.
3. Não deixe senha em texto puro. A receita fica guardada no painel. Prefira gerar a senha dentro do script, ou criar o usuário sem senha e definir depois via SSH.
4. Cuidado com o apt-get upgrade interativo. Em script, use -y; sem isso o processo trava esperando uma resposta que nunca vem, e a receita fica pendurada.
5. Comente o que não é óbvio. Você vai reler isso daqui a meses, provavelmente às duas da manhã.

Quando a receita não roda

Uma sequência curta de checagem, na ordem:

• A receita estava selecionada na reinstalação? É o esquecimento mais comum.
• A VPS passou por um boot depois de aplicar a receita? Se você aplicou com a máquina ligada, desligue e ligue.
• O formato bate com o sistema? Bash em Linux; Batch ou PowerShell em Windows. Script bash numa VPS Windows não roda.
• O log diz alguma coisa? Em Windows, C:\virt_scripts. Em Linux, o arquivo que o seu script gravou.
• Ainda assim não foi? Abra um ticket com o nome da receita e o trecho do log. A gente olha.

Receita ou painel pronto?

Se o que você quer é um painel de controle — cPanel, Plesk, CyberPanel, Webuzo — o Virtualizor tem instalação dedicada para vários deles, separada das receitas. Nesse caso use a instalação própria do painel, que já trata as particularidades de cada um, em vez de escrever receita na mão. Os nossos planos de VPS no Brasil e da linha VPS NVMe BR incluem esses instaladores.

Fontes: Virtualizor — Recipes (painel do cliente) · Virtualizor — Recipes e receitas para Windows · Virtualizor — Re-Install OS