blog
Revenda

Página padrão em conta nova do WHM com cpanel3-skel

O WHM já copia um diretório modelo para cada conta criada. Falta montar o seu, e tratar o parque antigo sem derrubar site publicado.

JR · · 8 min de leitura · 1 tabela · 9 blocos de código

Resposta curta: o WHM copia o conteúdo de `/root/cpanel3-skel` para o diretório home de toda conta nova, segundo a documentação do cPanel. Monte lá o index.html provisório, favicon, 404 e .htaccess da agência. Ele não retroage: contas já criadas precisam de cópia manual com `cp -rn`.

Neste artigo
  1. O que o cpanel3-skel copia e o que ele nunca faz sozinho
  2. Montando o diretório modelo da agência com acesso root
  3. Domínio fixo, credencial e WordPress: o que nunca entra no skeleton
  4. Por que o arquivo chega com dono root e como corrigir
  5. Validar numa conta de teste antes de criar a primeira conta real
  6. Aplicar o mesmo modelo em contas que já existem sem derrubar site
  7. A mensagem pronta para o cliente que viu a página provisória
  8. Checklist de implantação do skeleton directory

Cada conta nova criada no WHM entrega um public_html vazio. O navegador do cliente mostra um índice de diretório, um 404 do servidor ou a página genérica da hospedagem, e o cliente pergunta se o domínio dele quebrou. A correção manual é subir um index.html, um favicon e um .htaccess em toda conta. Repetida em cada cliente novo, é trabalho que o WHM já faz sozinho.

O mecanismo é o skeleton directory. Segundo a documentação oficial do cPanel, o conteúdo de /root/cpanel3-skel é copiado para o diretório home de cada conta nova no momento da criação. Você monta o diretório uma vez, no servidor, e toda conta criada depois nasce com ele.

O que o cpanel3-skel copia e o que ele nunca faz sozinho

A documentação do cPanel descreve o recurso de forma direta: os arquivos colocados em /root/cpanel3-skel são copiados para o diretório inicial de contas novas. Na prática, isso significa que a estrutura que você criar dentro de /root/cpanel3-skel/public_html/ aparece dentro de /home/usuario/public_html/ da conta recém-criada.

Três limites que valem mais do que o recurso em si:

Esse último ponto define todo o resto do artigo. Qualquer arquivo com domínio fixo dentro do skeleton vai parar, idêntico, na conta de todos os clientes seguintes.

Montando o diretório modelo da agência com acesso root

O acesso a /root exige root por SSH. Em revenda sem acesso root, o skeleton é configurado pelo provedor do servidor, não pelo revendedor.

Criar a estrutura em /root/cpanel3-skel/public_html

mkdir -p /root/cpanel3-skel/public_html
cd /root/cpanel3-skel/public_html

Quais arquivos valem a pena: index.html, robots.txt e .htaccess

Exemplo de index.html provisório, neutro, sem nome de domínio:

<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="robots" content="noindex">
<title>Site em preparacao</title>
<link rel="icon" href="/favicon.ico">
</head>
<body>
<h1>Site em preparacao</h1>
<p>Este endereco esta hospedado e configurado. O site sera publicado em breve.</p>
<p>Suporte: [email protected]</p>
</body>
</html>

O noindex é deliberado: o domínio pode ficar semanas apontado para essa página, e você não quer que ela entre no índice de busca como conteúdo do cliente.

Exemplo de robots.txt para a fase de preparação:

User-agent: *
Disallow: /

Esse arquivo precisa estar na sua lista de remoção na hora de publicar. Um Disallow: / esquecido no lançamento é o tipo de erro que só aparece três semanas depois, quando o cliente pergunta por que o site não aparece no Google.

Exemplo de .htaccess base, só com o que é seguro em qualquer site:

ErrorDocument 404 /404.html
Options -Indexes

Options -Indexes impede a listagem de diretório quando falta o arquivo de índice, que é exatamente o cenário de uma conta parcialmente configurada.

Conferir com find tudo que vai parar na conta do cliente

find /root/cpanel3-skel -type f -exec ls -l {} \;

Leia o resultado item por item. Tudo que estiver nessa lista vai para o public_html de todos os clientes que você criar daqui em diante.

Do skeleton pronto à conta de teste validadaMontar skeletonArquivos em /root/cpanel3-skel/public_htmlListar com findConfere tudo que será copiadoCriar conta de testeSubdomínio próprio, pacote pequenoValidar no navegadorPágina, favicon, 404 e permissõesTerminar a contaConta de teste não fica viva
O skeleton só é copiado na criação da conta, então o teste precisa acontecer antes da primeira conta real.

Domínio fixo, credencial e WordPress: o que nunca entra no skeleton

Item Entra? Motivo
index.html genérico, sem domínio Sim Mesma mensagem serve para qualquer cliente
favicon.ico da agência Sim Evita o 404 de favicon no log durante a preparação
404.html neutro Sim Preenche o erro padrão sem revelar stack do servidor. Evite .shtml: sem Options +Includes e handler SSI ativo, o navegador recebe o arquivo como texto cru ou download
robots.txt com Disallow: / Sim, com ressalva Tem que sair na publicação
.htaccess com regras básicas Sim Só diretivas válidas em qualquer conta
.htaccess com RewriteBase ou redirect de domínio Não Domínio fixo quebra o site do próximo cliente
wp-config.php ou qualquer credencial Não Usuário e senha de banco não são reaproveitáveis, e viram vazamento
Chave SSH, token de API, .env Não Copiado para o home de todos os clientes seguintes
Instalação completa do WordPress Não Versão congela, e a atualização de segurança fica por sua conta
Arquivo com e-mail ou CNPJ de um cliente específico Não Mesmo problema do domínio fixo
Sitemap, verificação do Search Console, tag de analytics Não São por propriedade, nunca por servidor

A regra de corte é simples: se o arquivo responde "depende do cliente", ele não pertence ao skeleton. O skeleton é só o que é verdade para qualquer conta do servidor.

Por que o arquivo chega com dono root e como corrigir

Arquivo com dono root dentro de public_html é a falha mais provável desse procedimento. Os arquivos que você cria em /root/cpanel3-skel nascem pertencendo ao root. Confira a propriedade e o modo dentro da conta recém-criada antes de considerar o modelo pronto, porque arquivo com dono errado dentro de public_html resulta em erro 500 ou em arquivo que o cliente não consegue editar pelo Gerenciador de Arquivos.

O que validar na conta de teste, com ls -l dentro do public_html da conta:

Se algo vier com dono errado, o ajuste é na conta afetada:

chown -R usuario:usuario /home/usuario/public_html
find /home/usuario/public_html -type f -exec chmod 644 {} \;
find /home/usuario/public_html -type d -exec chmod 755 {} \;

Troque usuario pelo usuário cPanel real. Não rode isso em conta com site publicado sem antes conferir se o site depende de alguma permissão específica.

Validar numa conta de teste antes de criar a primeira conta real

Não descubra o erro no cliente. O teste leva poucos minutos.

Criar a conta descartável num subdomínio seu

No WHM, em *Create a New Account*, use um domínio de teste que você controla, por exemplo um subdomínio seu do tipo skeltest.suaagencia.com.br. Pacote pequeno, sem e-mail.

Conferir o conteúdo copiado com ls -la

ls -la /home/skeltest/public_html

Você deve ver exatamente os arquivos do skeleton, nada a mais. Se aparecer algo que você não colocou, o arquivo veio de outro lugar e precisa ser rastreado antes de seguir.

Abrir no navegador e forçar um 404

Acesse o domínio de teste. Verifique três coisas: a página carrega, o favicon aparece, e uma URL inexistente cai no seu 404.html e não no erro padrão do Apache.

Terminar a conta de teste e por que não deixá-la viva

No WHM, em *Terminate an Account*, remova a conta de teste. Mantenha o hábito de apagar: conta de teste esquecida consome cota, aparece em relatório e, se tiver senha fraca, é superfície de ataque.

Aplicar o mesmo modelo em contas que já existem sem derrubar site

O skeleton não retroage, então o parque antigo precisa de um procedimento separado. O risco aqui é sobrescrever site publicado, e ele é real: um cp descuidado troca o index.php do WordPress de um cliente em produção por uma página de "em preparação".

A regra de segurança é tratar separadamente dois grupos: conta com site publicado e conta vazia ou só com a página padrão.

Separar as contas com site publicado das contas vazias

Liste o conteúdo do public_html de cada conta antes de tocar em qualquer coisa:

for d in /home/*/public_html; do
  echo "== $d"
  ls -A "$d" | head -n 5
done

Conta com wp-config.php, index.php ou dezenas de arquivos é conta com site. Ela não recebe index.html nenhum, porque em muitos servidores o index.html tem precedência sobre o index.php na ordem do DirectoryIndex, e o site do cliente simplesmente some do ar enquanto os arquivos continuam lá.

Copiar com cp -rn nas contas vazias e ajustar o dono

Para as contas que estão vazias ou só com a página padrão do servidor, use cópia que não substitui arquivo existente:

cp -rn /root/cpanel3-skel/public_html/. /home/usuario/public_html/
chown -R usuario:usuario /home/usuario/public_html

A flag -n em cp não sobrescreve arquivo de destino já existente. Rode conta a conta, não em laço, até ter confiança no resultado. A linha de chown não é opcional: sem ela, os arquivos ficam com dono root dentro da conta do cliente.

Registrar quais contas já foram padronizadas

Mantenha uma planilha ou arquivo com a lista de contas já padronizadas e a data. Quando outra pessoa da equipe assumir o servidor, ela precisa saber quais contas foram tratadas e quais ainda estão no estado antigo.

Decisão antes de copiar o skeleton em conta antigaListar o public_html da contals -A em cada homeTem wp-config.php ou index.php?Então é site publicadoSite publicado: não copiar nadaindex.html derruba o index.phpConta vazia: cp -rn do skeletonNão sobrescreve arquivo existentechown para o usuário cPanelSem isso, dono fica rootRegistrar a conta na listaData e responsável pela padronização
Caminho para padronizar contas antigas sem tirar site do ar.

A mensagem pronta para o cliente que viu a página provisória

O cliente aponta o DNS, abre o domínio e vê uma página que não é dele. A mensagem padrão que evita o chamado, pronta para copiar:

A página provisória não sai sozinha. Enquanto o index.html existir no public_html, ele tem precedência sobre o index.php na ordem padrão do DirectoryIndex, então o CMS instalado continua invisível. Publicar é, na prática, um passo manual: apagar o index.html e o robots.txt com Disallow: / antes de anunciar o lançamento. Se o cliente for revendedor ou tiver equipe própria, diga isso com todas as letras, porque é essa dupla de arquivos que explica tanto o site que "não subiu" quanto o site que não aparece no Google três semanas depois.

Checklist de implantação do skeleton directory

Montado uma vez, o skeleton elimina o passo manual em toda conta criada a partir dali. O custo de manutenção é lembrar de revisar o conteúdo quando o e-mail de suporte da agência mudar, porque o arquivo antigo continua nas contas que já foram criadas com ele.

Referências

  1. Documentação oficial (cpanel) — Skeleton Directory. Consultado em 2026-10-02.
Leia também