blog
WordPress

Site sem CSS no endereço temporário: 3 saídas

Como confirmar o diagnóstico em dois sinais na tela e resolver pelo arquivo hosts, por subdomínio de pré-visualização ou, em último caso, pelo wp-config.php.

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

Resposta curta: a página abre sem CSS e sem imagem porque o endereço `servidor/~usuario` entrega o HTML do servidor novo, mas o WordPress monta cada URL a partir de `siteurl` e `home`, que ainda guardam o domínio antigo. Há três saídas, da mais segura à mais invasiva.

Neste artigo
  1. O que o mod_userdir entrega e por que ele não reescreve o HTML
  2. Dois testes de dois minutos que confirmam o diagnóstico sem alterar nada
  3. A barra final depois do ~usuario só afeta caminho relativo
  4. Comparação das três saídas por risco e por para que servem
  5. Arquivo hosts: ver o site real pelo domínio sem tocar na instalação
  6. Subdomínio de pré-visualização no cPanel para mostrar o site a terceiros
  7. WP_HOME e WP_SITEURL sobrepõem o banco sem alterá-lo
  8. Checklist de seis itens antes de apontar o DNS

O endereço temporário funciona, o HTML chega, mas a página aparece como um texto cru empilhado, sem cores, sem menu e com retângulos de imagem quebrada. Nada disso é erro de permissão nem arquivo faltando. É o WordPress montando cada URL a partir de dois valores guardados no banco: siteurl e home. Enquanto o domínio antigo ainda apontar para o servidor anterior, o navegador pede o CSS e as imagens de lá, não do servidor novo.

O que o mod_userdir entrega e por que ele não reescreve o HTML

O ~usuario é um recurso do Apache chamado mod_userdir. Ele serve o conteúdo do diretório público de uma conta sem precisar de domínio apontado. Na documentação do cPanel, o mod_userdir Tweak é a tela onde o administrador habilita ou desabilita esse acesso conta a conta (cPanel, Apache mod_userdir Tweak). Na prática, é por isso que o endereço temporário funciona em algumas contas e dá erro em outras: depende de como o acesso está configurado no servidor.

O que ele faz: entrega os arquivos da sua conta pelo IP ou pelo hostname do servidor.

O que ele não faz: reescrever o conteúdo. Se o index.php do WordPress gera <link rel="stylesheet" href="https://seudominio.com.br/wp-content/...">, é esse endereço que vai para o navegador. O mod_userdir não troca nada dentro do HTML.

Por isso o sintoma é tão característico: o HTML carrega (veio do servidor novo) e os recursos quebram (foram pedidos ao domínio antigo).

Dois testes de dois minutos que confirmam o diagnóstico sem alterar nada

Antes de mexer em qualquer coisa, confirme. Os dois sinais abaixo levam menos de dois minutos e não alteram nada no site.

Ctrl+U e procurar wp-content: de qual domínio o CSS está sendo pedido

Abra o endereço temporário no navegador e pressione Ctrl+U (Cmd+Option+U no Mac) para ver o código-fonte. Pressione Ctrl+F dentro dessa aba e procure por wp-content.

Se as linhas encontradas começarem com https://seudominio.com.br/wp-content/, está confirmado: o WordPress está escrevendo o domínio antigo. Se começarem com o endereço do servidor, o problema é outro (permissão de arquivo, cache de plugin, .htaccess).

F12, aba Rede, filtro CSS: ler a URL em vez de confiar na aparência

Pressione F12, abra a aba Rede (Network) e recarregue a página com Ctrl+F5. Clique no filtro CSS.

O que procurar em cada linha:

Um detalhe que confunde muita gente: se o site antigo ainda estiver online, o CSS carrega normalmente e a página parece certa. Você só descobre o problema quando o site antigo for desligado. Confirme pela URL, não pela aparência.

Como confirmar de onde o CSS é pedidoCtrl+U no endereço temporárioProcure wp-content no código-fonteURL com domínio antigoDiagnóstico confirmado, siga para as saídasURL com o servidor novoVeja permissão, cache ou .htaccessF12, aba Rede, filtro CSSLeia a URL, não a aparência
Caminho de diagnóstico sem alterar nada no site.

A barra final depois do ~usuario só afeta caminho relativo

Esta parte não confirma o diagnóstico, é uma ressalva. Ela só vale para recursos escritos com caminho relativo, do tipo wp-content/tema/style.css, sem domínio na frente. Como o WordPress normalmente escreve URL absoluta, com domínio, a causa principal continua sendo siteurl e home.

Quando o caminho é relativo, o endereço servidor.exemplo.com/~usuario sem a barra final faz o navegador resolver wp-content/... para servidor.exemplo.com/wp-content/..., sem o ~usuario no meio. Na prática o Apache costuma redirecionar o diretório sem barra para a versão com barra, então o caso é raro.

Teste simples para descartar: digite o endereço terminando com barra. Se parte dos recursos passar a carregar, você tem os dois problemas somados, não só um.

Comparação das três saídas por risco e por para que servem

Saída Mexe no site Risco Serve para
Arquivo hosts no seu computador Não Nenhum Conferir o site real antes de apontar o DNS
Subdomínio de pré-visualização no cPanel Cria um subdomínio apontando para a mesma pasta Baixo Mostrar para cliente ou equipe sem mexer no DNS do domínio
WP_HOME e WP_SITEURL no wp-config.php Sim, um arquivo Médio, reversível Último caso, quando as duas opções acima não servem

A ordem importa. A primeira resolve o problema sem tocar na instalação, e é a que recomendo começar mesmo que pareça a mais trabalhosa.

Ordem recomendada das três saídasArquivo hostsSó o seu computador, risco nenhumSubdomínio de pré-visualizaçãoEndereço estável para mostrar a terceirosWP_HOME e WP_SITEURLÚltimo caso, reversível, remova depois
Ordem recomendada: comece pela saída que não toca na instalação.

Arquivo hosts: ver o site real pelo domínio sem tocar na instalação

O arquivo hosts faz o seu computador, e só ele, resolver o domínio para o IP novo. O resto do mundo continua vendo o site antigo. Como o navegador vai pedir tudo pelo domínio correto, CSS, imagens e links funcionam exatamente como vão funcionar depois da propagação.

Você precisa do IP do servidor novo. No cPanel, ele aparece na barra lateral de informações gerais, em Shared IP Address ou Dedicated IP Address.

Windows: abra o Bloco de Notas como administrador (clique com o botão direito no ícone, Executar como administrador), vá em Arquivo, Abrir, e cole o caminho:

C:\Windows\System32\drivers\etc\hosts

Troque o filtro de tipo de arquivo para Todos os arquivos para o hosts aparecer.

macOS ou Linux: no Terminal,

sudo nano /etc/hosts

Em qualquer um dos dois, acrescente uma linha no final, trocando o IP de exemplo pelo IP real da sua conta:

203.0.113.10 seudominio.com.br www.seudominio.com.br

Salve. No Windows, Ctrl+S. No nano, Ctrl+O, Enter, Ctrl+X.

Depois abra uma janela anônima e acesse https://seudominio.com.br. Se o certificado ainda não estiver emitido no servidor novo, o navegador vai avisar de certificado inválido: isso é esperado nesse estágio e não indica problema no site.

Para desfazer, apague a linha que você adicionou e salve. Não é preciso reiniciar nada, basta fechar e abrir o navegador.

Subdomínio de pré-visualização no cPanel para mostrar o site a terceiros

Se o domínio antigo já está em outro servidor e você precisa mostrar o site para alguém que não vai editar arquivo hosts, crie um subdomínio em um domínio que já aponte para o servidor novo.

  1. No cPanel, em Domínios, clique em Criar um domínio (ou Subdomínios, dependendo da versão).
  2. Em Domínio, escreva algo como preview.outrodominio.com.br.
  3. Desmarque a opção de criar uma pasta nova e aponte a raiz do documento para a mesma pasta da instalação do WordPress, normalmente public_html.
  4. Salve e aguarde a emissão do certificado, em Segurança, SSL/TLS Status.

O site vai abrir no subdomínio, mas o CSS continuará vindo do domínio antigo, porque siteurl e home não mudaram. A diferença é que agora você tem um endereço estável, com HTTPS, para aplicar a saída 3 se decidir aplicá-la.

WP_HOME e WP_SITEURL sobrepõem o banco sem alterá-lo

Essas duas constantes fixam o endereço do site por arquivo. Quando definidas, elas se sobrepõem aos valores gravados no banco sem alterá-los. É o detalhe que torna a operação reversível: para voltar, basta remover as duas linhas.

Onde guardar o backup do wp-config.php sem expor a senha do banco

Antes de copiar, entenda o risco: o wp-config.php guarda usuário e senha do banco em texto puro. O PHP só interpreta arquivos terminados em .php, então uma cópia chamada wp-config.php.bkp dentro de public_html é entregue pelo servidor como arquivo de texto comum. Quem digitar https://seudominio.com.br/wp-config.php.bkp baixa suas credenciais. Nunca deixe o backup na pasta pública.

Duas formas seguras, escolha uma:

Leva cinco segundos e é o seu desfazer garantido, sem expor senha.

Onde colar as duas linhas no wp-config.php e com qual formato de endereço

Ainda no Gerenciador de arquivos, selecione wp-config.php e clique em Editar. Procure a linha:

/* That's all, stop editing! Happy publishing. */

Imediatamente acima dela, cole as duas linhas, trocando o endereço de exemplo pelo seu endereço temporário real:

define( 'WP_HOME', 'https://preview.outrodominio.com.br' );
define( 'WP_SITEURL', 'https://preview.outrodominio.com.br' );

Sem barra no final. Se estiver usando o formato ~usuario, o valor fica assim:

define( 'WP_HOME', 'http://servidor.exemplo.com/~usuario' );
define( 'WP_SITEURL', 'http://servidor.exemplo.com/~usuario' );

Salve e recarregue com Ctrl+F5. O CSS deve voltar, e os links do menu passam a apontar para o endereço temporário.

Assim que confirmar que o site abriu, confira no Gerenciador de arquivos que não sobrou nenhuma cópia do wp-config.php dentro de public_html, com qualquer extensão (.bkp, .old, .txt, .save). Se sobrou, mova para /home/usuario ou apague agora, não ao fim da migração: enquanto o arquivo estiver lá, a senha do banco está disponível para download.

Imagem quebrada, login em loop, certificado inválido e conteúdo misto

Como reverter apagando as duas linhas, e a ordem certa se usar o backup

O caminho principal é apagar as duas linhas define(...) e salvar. Só isso. O banco não foi alterado em nenhum momento, então o site volta a usar siteurl e home originais.

Se preferir voltar pelo backup, a ordem importa: apague ou renomeie primeiro o wp-config.php atual e só depois copie o backup de /home/usuario (ou do seu computador) para dentro de public_html, com o nome wp-config.php. Copiar por cima de um arquivo existente falha ou sobrescreve sem aviso, dependendo da versão do Gerenciador de arquivos. Se renomear o atual em vez de apagar, use um nome fora de public_html também: wp-config.php.old na pasta pública tem o mesmo problema de leitura em texto puro.

Remova as constantes assim que o DNS apontar para o servidor novo

Assim que o domínio apontar para o servidor novo, remova as duas linhas. Se esquecer, o site continuará respondendo no endereço de pré-visualização e vai gerar links errados para visitantes e para o Google.

Checklist de seis itens antes de apontar o DNS

Se o item do hosts passou, o resto é propagação. O site vai aparecer igual para todo mundo assim que o DNS alcançar cada provedor.

Referências

  1. Documentação oficial (cpanel) — Apache mod_userdir Tweak. Consultado em 2026-09-20.
Leia também