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.

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
- O que o cpanel3-skel copia e o que ele nunca faz sozinho
- Montando o diretório modelo da agência com acesso root
- Domínio fixo, credencial e WordPress: o que nunca entra no skeleton
- Por que o arquivo chega com dono root e como corrigir
- Validar numa conta de teste antes de criar a primeira conta real
- Aplicar o mesmo modelo em contas que já existem sem derrubar site
- A mensagem pronta para o cliente que viu a página provisória
- 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:
- Não retroage. A cópia acontece na criação da conta. Contas que já existem não recebem nada, nem quando você edita o skeleton depois.
- Não atualiza. Se você trocar o
index.htmlmodelo amanhã, as contas criadas hoje ficam com a versão de hoje. Não há sincronização. - Não é um sistema de templates. Nada é substituído dinamicamente. Não existe variável de domínio, de usuário ou de data. O que está lá é copiado literalmente.
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.
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:
- O dono e o grupo dos arquivos devem ser os do usuário cPanel da conta, não root.
- Arquivos:
644. Diretórios:755. .htaccessprecisa ser legível pelo Apache e editável pelo usuário.
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.
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
- [ ] Acesso root ao servidor confirmado (em revenda sem root, falar com o provedor)
- [ ]
/root/cpanel3-skel/public_htmlcriado - [ ]
index.htmlgenérico, comnoindex, sem domínio e sem dado de cliente - [ ]
favicon.icoda agência - [ ]
404.htmlneutro (não.shtml, que exige SSI habilitado) - [ ]
robots.txtcomDisallow: /e anotação de que precisa sair na publicação - [ ]
.htaccesssó com diretivas válidas em qualquer conta - [ ] Nenhuma credencial, chave, token ou
wp-config.phpno diretório - [ ]
findrodado para listar tudo que está no skeleton - [ ] Conta de teste criada, página aberta no navegador, 404 verificado
- [ ] Propriedade e permissão conferidas dentro da conta de teste
- [ ] Conta de teste terminada
- [ ] Contas antigas separadas entre publicadas e vazias
- [ ] Cópia com
cp -rnsó nas vazias, comchowndepois - [ ] Lista das contas padronizadas registrada
- [ ] Remoção do
index.htmle dorobots.txtincluída no roteiro de publicação de cada site
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
- Documentação oficial (cpanel) — Skeleton Directory. Consultado em 2026-10-02.