A janela Adicionar Dominio publica um site para uma conta de hospedagem. O painel cria o vhost, a pasta do site e, no caso de PHP, o pool PHP-FPM da conta.
Antes de começar, a conta precisa existir em Hospedagem > Usuários.
Passo a passo
- Acesse Hospedagem > Dominios.
- Clique em Novo Dominio.
- Preencha Dominio (ex.:
exemplo.com.br) e, se quiser, Aliases. - Escolha o Tipo de aplicacao: PHP, Node.js ou Redirecionamento.
- Selecione o Usuario dono do site.
- Preencha os campos do tipo escolhido (tabelas abaixo).
- Clique em Criar.
Se o servidor web recusar a configuração do novo domínio, nada fica gravado: o painel desfaz a criação e mostra "O servidor web recusou a configuracao do dominio; nada foi criado.", com o erro.
Campos comuns
| Campo | O que informar |
|---|---|
| Dominio | Nome principal do site, sem http://. |
| Aliases (opcional) | Outros nomes que abrem o mesmo site, separados por espaço ou vírgula. Ex.: www.exemplo.com.br. Aceita curinga: *.exemplo.com.br. |
| Usuario | Conta dona do site. |
| Document Root | Pasta do site, relativa à home do usuário. Padrão: public_html. |
O painel recusa um alias que já seja domínio ou alias de outro site, para não haver dois vhosts disputando o mesmo nome.
Exemplos de Document Root:
| Aplicação | Document Root |
|---|---|
| Site comum, WordPress | public_html |
| Laravel | public_html/public |
| Magento 2 | public_html/pub |
| Outra pasta | www, htdocs |
A pasta é criada se não existir e precisa ficar dentro de /home/usuario. O caminho aceita só letras, números, ., _, - e /, sem espaços nem ..; fora disso aparece "Document root invalido: use letras, numeros, . _ - e / (sem espacos nem ..).".
Tipo PHP
| Campo | O que informar |
|---|---|
| PHP | Versão do PHP. Só aparecem as versões instaladas. |
| Template da Aplicacao | Generico, Magento 2 ou Laravel. |
| Arquivos iniciais | Criar index.html de boas-vindas e Criar info.php (phpinfo). Os dois vêm marcados. |
O Template da Aplicacao define as regras de rewrite quando o servidor está no modo NGINX Only. Nos modos Apache Only e NGINX + Apache, quem cuida do rewrite é o .htaccess da aplicação.
O template Magento 2 também ajusta o pool PHP-FPM da conta: pastas temporárias dentro da loja e limites maiores de tempo de execução e de variáveis de entrada.
Dica: desmarque os Arquivos iniciais quando for publicar uma aplicação pronta (Laravel, Magento, WordPress). Assim o document root fica vazio para o deploy.
Atenção: apague o
info.phpassim que terminar os testes. Ele expõe a configuração do PHP do servidor.
Tipo Node.js
O painel cria um proxy (com WebSocket) do domínio para a app e um serviço que reinicia a app se ela cair.
| Campo | O que informar |
|---|---|
| Comando de start | Ex.: npm start, node dist/main.js, npx next start. Roda no document root, como o usuário. |
| Porta | De 3000 a 3999. Vazio = próxima porta livre. |
| NODE_ENV | Padrão production. |
| Binario do Node (opcional) | Caminho de outra versão do Node, ex.: um Node instalado com nvm na home do usuário. |
A app deve escutar na porta da variável PORT e no endereço HOST=127.0.0.1. Detalhes em Apps Node.js.
Tipo Redirecionamento
Use para domínio estacionado ou mudança de endereço. O vhost só redireciona; não usa PHP.
| Campo | O que informar |
|---|---|
| Redirecionar para | URL de destino com http:// ou https://. |
| Tipo | 301 (permanente) ou 302 (temporario). |
| Manter o caminho | Marcado: exemplo.com.br/x vai para destino/x. |
Publicar no HAProxy e na Cloudflare
Estas opções só aparecem quando a integração está ligada em Configurações.
| Opção | Efeito |
|---|---|
| Provisionar no HAProxy (dominio + certificado SSL) | Cadastra o domínio no balanceador e gera o certificado. Use Incluir www.dominio para cobrir o www. |
| Criar registro DNS na Cloudflare | Cria um registro A apontando para o IP do servidor definido em Configurações > Geral. A zona é detectada sozinha. |
| Ativar proxy (nuvem laranja) | Liga o proxy da Cloudflare no registro criado. |
O certificado usa o e-mail padrão de Configurações. Sem esse e-mail, o domínio entra no HAProxy sem SSL.
Se marcar Cloudflare e HAProxy juntos, o registro DNS é criado primeiro e o HAProxy é provisionado cerca de 1 minuto depois, para dar tempo de o DNS propagar. Com SSL, o provisionamento roda em segundo plano; acompanhe pela tela HAProxy.
Depois de criar
- Aponte o DNS do domínio (e dos aliases) para o servidor, se não usou a Cloudflare.
- Envie os arquivos para o document root (pelo cliente, FTP ou deploy).
- Os logs do site ficam em
/var/log/minicp/users/usuario/e o cliente os lê pelos atalhos em/home/usuario/logs/(somente leitura). - Ajustes posteriores estão em Gerenciar domínios.