A integração com a Cloudflare permite criar zonas e registros DNS direto pelo miniCP. Com ela ligada, o painel também cria o registro do site no momento em que você cria o domínio.
Criar o token na Cloudflare
- No painel da Cloudflare, abra My Profile → API Tokens.
- Crie um token com as permissões mínimas:
| Permissão | Para quê |
|---|---|
| Zone:Read | Listar as zonas |
| DNS:Edit | Criar, alterar e remover registros |
| Zone:Edit | Só se for criar zonas novas pelo painel |
- Copie o token. Ele só aparece uma vez.
- Anote também o Account ID da conta, necessário para criar zonas.
Atenção: trate o token como senha. Quem tem o token pode alterar o DNS dos seus domínios.
Ligar a integração no miniCP
- Vá em Configuracoes e abra a aba Cloudflare.
- Ligue Habilitado.
- Cole o token em API Token. Para manter um token já salvo, deixe o campo vazio.
- Preencha o Account ID.
- Clique em Testar token e confira a mensagem ao lado do botão.
- Clique em Salvar Configuracoes.
Depois, em Configuracoes → Geral, confira o Endereco IP do servidor. É o IP usado nos registros A criados pelo painel.
Com a integração ligada, aparece o item Cloudflare DNS em Rede & SSL.
Tela Cloudflare DNS
Adicionar dominio (zona)
- Digite o domínio em Dominio, por exemplo
exemplo.com.br. - Clique em Criar zona.
- Na tabela Zonas, copie os Nameservers da zona nova.
- No registrador do domínio, troque os nameservers pelos da Cloudflare.
A zona fica com status pendente até o registrador apontar para a Cloudflare.
Zonas
A tabela mostra cada zona com o Status e os Nameservers. Clique em Registros para abrir os registros DNS daquela zona.
Registros DNS
Para adicionar um registro, preencha a linha do formulário e clique no botão de adicionar:
| Campo | Uso |
|---|---|
| Tipo | A, AAAA, CNAME, TXT, MX, NS, SRV ou CAA |
| Nome | @ para o domínio raiz, ou o subdomínio (ex.: loja) |
| Conteudo | IP ou destino do registro |
| Prio | Prioridade. Só vale para MX |
| TTL | 1 = automático |
| Proxy | Liga o proxy da Cloudflare (nuvem laranja). Só vale para A, AAAA e CNAME |
A tabela de registros mostra tipo, nome, conteúdo, se o proxy está ligado e o TTL. Para remover, clique na lixeira da linha e confirme.
Atenção: remover um registro A ou CNAME tira o site do ar para quem ainda não tem a resposta em cache.
Criar o registro ao criar um domínio
Com a Cloudflare ligada, o formulário Novo Dominio (menu Dominios) mostra a opção Criar registro DNS na Cloudflare (A → IP do servidor).
- Marque a opção.
- Se quiser, marque Ativar proxy (nuvem laranja).
- Crie o domínio normalmente.
O painel:
- Descobre sozinho a zona certa na Cloudflare. Para
loja.exemplo.com.br, usa a zonaexemplo.com.br. - Cria um registro A com o nome do domínio apontando para o IP definido em Configuracoes → Geral.
- Se já existir um registro A com esse nome, atualiza o conteúdo para o IP do servidor.
Se também marcar Provisionar no HAProxy, o registro DNS é criado primeiro e o HAProxy + SSL é provisionado cerca de 1 minuto depois. Veja Publicar um site novo com SSL.
A mesma opção existe em HAProxy → Provisionar Dominio e HAProxy → Adicionar.
Dica: a zona do domínio precisa existir na Cloudflare antes. Se não existir, o painel avisa que não encontrou a zona e o registro não é criado.
Proxy ligado ou desligado
| Situação | Recomendação |
|---|---|
| Site comum, atrás do HAProxy | Proxy desligado é o caminho mais simples. O certificado é emitido no HAProxy |
| Quer o cache e a proteção da Cloudflare | Proxy ligado. Na Cloudflare, use o modo SSL Full (strict), já que o HAProxy tem certificado válido |
| Registros de e-mail, FTP ou SSH | Sempre sem proxy |
Problemas comuns
| Mensagem ou sintoma | O que fazer |
|---|---|
| Cloudflare nao esta habilitado/configurado | Ligue a integração e salve o token em Configuracoes → Cloudflare |
| Erro ao criar zona | Falta a permissão Zone:Edit no token ou o Account ID |
| Não foi possível determinar o IP do servidor | Preencha o Endereco IP do servidor em Configuracoes → Geral |
| Zona não aparece na lista | Confira se o token tem acesso a essa zona. A tela lista até 50 zonas |