# 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.

> 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`.

João Rizzon · 2026-10-03 · Revenda

---

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](https://docs.cpanel.net/whm/account-functions/skeleton-directory/), 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.html` modelo 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

```bash
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:

```html
<!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: contato@suaagencia.com.br</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:

```apache
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

```bash
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`.
- `.htaccess` precisa ser legível pelo Apache e editável pelo usuário.

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

```bash
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

```bash
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:

```bash
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:

```bash
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:

> **** O seu domínio já está apontando corretamente para a hospedagem. Essa página provisória é o que mostramos enquanto o site está em construção: ela confirma que o domínio e o certificado estão funcionando e não é indexada pelos buscadores. No momento da publicação, nós removemos essa página e o site do cliente passa a responder no lugar dela.

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_html` criado
- [ ] `index.html` genérico, com `noindex`, sem domínio e sem dado de cliente
- [ ] `favicon.ico` da agência
- [ ] `404.html` neutro (não `.shtml`, que exige SSI habilitado)
- [ ] `robots.txt` com `Disallow: /` e anotação de que precisa sair na publicação
- [ ] `.htaccess` só com diretivas válidas em qualquer conta
- [ ] Nenhuma credencial, chave, token ou `wp-config.php` no diretório
- [ ] `find` rodado 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 -rn` só nas vazias, com `chown` depois
- [ ] Lista das contas padronizadas registrada
- [ ] Remoção do `index.html` e do `robots.txt` incluí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.

