Como configurar o WordPress para trabalhar atrás de um CDN sem quebrar os links
Olá, querido(a) cliente da GeHost! 🌟
Se você está aqui, provavelmente já escolheu um CDN (Rede de Distribuição de Conteúdo) para deixar seu site mais rápido e seguro — ótima decisão! Mas, como muitos descobrem, o WordPress por padrão gera URLs com o domínio original, o que pode fazer com que imagens, scripts ou estilos pareçam "quebrados" quando o site está rodando atrás de um CDN. Não se preocupe! Como seu Sensei da GeHost, vou te guiar passo a passo para resolver isso com segurança, sem precisar de código mágico — só boas práticas e um toque de cuidado.Por que isso acontece?
O WordPress, por padrão, gera links como:
https://seusite.com.br/wp-content/uploads/2024/05/imagem.jpgSe você está usando um CDN (como Cloudflare, BunnyCDN ou outro), o conteúdo deve ser servido pelo domínio do CDN, por exemplo:
https://cdn.seusite.com.br/wp-content/uploads/2024/05/imagem.jpgSe o WordPress não souber disso, ele continuará gerando links com o domínio original — e o navegador vai tentar carregar os arquivos do seu servidor real, mesmo que o CDN esteja configurado. Isso quebra o desempenho e pode causar erros visuais.
Passo a passo: como configurar o WordPress para funcionar com CDN
Para resolver isso, precisamos fazer duas coisas:
- Informar ao WordPress que os arquivos estão em um domínio diferente.
- Garantir que todos os links gerados usem esse novo domínio.
Seguem os passos com carinho, como se fosse um ritual de harmonia digital 🌿:
1. Acesse o painel do WordPress
Entre no seu painel do WordPress (normalmente: seusite.com.br/wp-admin).
2. Acesse as configurações do WordPress
No menu lateral, vá em Configurações → Geral.
Veja os campos:
- Endereço do WordPress (URL)
- Endereço do site (URL)
⚠️ Dica importante: Não altere esses campos se você não souber o que está fazendo. Eles devem continuar apontando para o seu domínio principal (ex: https://seusite.com.br).
3. Use um plugin para gerenciar URLs do CDN
Para evitar quebrar o site, o melhor caminho é usar um plugin que redirecione automaticamente os links dos arquivos para o CDN. Um dos mais confiáveis é o WP Rocket (se você tiver o plano Pro), ou CDN Enabler (gratuito).
Se você preferir fazer manualmente (sem plugin), siga os próximos passos.
4. Edite o arquivo wp-config.php (modo avançado)
Este passo é seguro, mas exige cuidado. Vamos editar o arquivo de configuração do WordPress para forçar o uso do domínio do CDN para arquivos estáticos.
1. Acesse o cPanel da sua hospedagem: painel.gehost.com.br
2. No cPanel, clique em Arquivos → Gerenciador de Arquivos.
3. Navegue até a pasta public_html (ou a pasta raiz do seu site).
4. Localize o arquivo wp-config.php. Clique nele com o botão direito e escolha Editar.
5. No final do arquivo, antes da linha /* That's all, stop editing! */, adicione o seguinte código:
define('WP_CONTENT_URL', 'https://cdn.seusite.com.br/wp-content');
define('WP_SITEURL', 'https://seusite.com.br');
define('WP_HOME', 'https://seusite.com.br');
⚠️ Atenção: Substitua cdn.seusite.com.br pelo domínio do seu CDN. O seusite.com.br deve ser o seu domínio principal.
6. Salve as alterações.
5. Configure o CDN para redirecionar os arquivos
Seu CDN (como Cloudflare ou BunnyCDN) precisa estar configurado para servir os arquivos de /wp-content/uploads/ a partir do domínio do CDN.
Por exemplo, no Cloudflare:
- Adicione um CNAME apontando
cdn.seusite.com.brpara o endereço do CDN (ex:your-site.cdn.cloudflare.net). - Ative o proxy (modo "orange cloud") para que o CDN cache os arquivos.
Se você usar um serviço como BunnyCDN:
- Crie um novo endpoint (domínio) no CDN.
- Configure o DNS para apontar
cdn.seusite.com.brpara o endpoint do Bunny. - Configure o cache para arquivos estáticos (imagens, CSS, JS).
6. Teste o resultado
1. Acesse seu site em um navegador.
2. Abra o inspetor de elementos (F12).
3. Procure por imagens, CSS ou JS.
4. Verifique se os links estão apontando para o domínio do CDN (ex: cdn.seusite.com.br).
Se sim — parabéns! Você está no caminho certo 🎉
7. (Opcional) Limpe o cache
Se você usa um plugin de cache (como WP Rocket ou W3 Total Cache), limpe o cache para garantir que os novos links sejam carregados corretamente.
Dica do Sensei: Cuidado com o cache do navegador
Às vezes, o navegador ainda mostra o conteúdo antigo. Para garantir que o novo comportamento esteja funcionando:
- Limpe o cache do navegador (Ctrl+Shift+R ou F5).
- Use modo anônimo (navegador em modo incógnito).
Resumo do que você aprendeu hoje
✅ O WordPress gera links com o domínio original por padrão.
✅ Para usar um CDN, é preciso redirecionar os arquivos estáticos para o domínio do CDN.
✅ A forma mais segura é usar o arquivo wp-config.php para definir o novo URL do conteúdo.
✅ O CDN deve estar configurado para servir os arquivos de /wp-content/uploads/ com o domínio correto.
✅ Sempre teste com o inspetor de elementos para confirmar que os links estão corretos.
Se tiver dúvidas, não hesite em entrar em contato com o suporte da GeHost — estamos aqui para te ajudar com todo o carinho do mundo 💛
Seu site está mais rápido, mais seguro e mais elegante. Parabéns por estar evoluindo! 🚀
Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*