Como configurar o WordPress para funcionar corretamente atrás de um CDN
Olá, querido(a) cliente! Seja bem-vindo(a) ao seu guia de mão na massa, com carinho e paciência — como um verdadeiro Sensei da GeHost. Hoje vamos te ajudar a deixar seu WordPress funcionando perfeitamente atrás de um CDN (Rede de Entrega de Conteúdo). Isso significa que seu site vai carregar mais rápido, ficar mais seguro e deixar seus visitantes felizes — sem complicações!
Se você já tem um CDN ativo (como Cloudflare, BunnyCDN ou outro), mas seu WordPress está com problemas — como imagens quebradas, links errados ou páginas que não carregam direito — é provável que o problema esteja na configuração. Vamos resolver isso juntos, passo a passo, com calma e clareza.
Antes de começar: o que é CDN?
Um CDN é como um "acelerador" do seu site. Ele armazena suas imagens, arquivos estáticos e até partes do seu site em servidores espalhados pelo mundo. Quando alguém acessa seu site, ele pega esses arquivos de um servidor mais próximo — muito mais rápido!
Porém, quando o WordPress não sabe que está sendo servido por um CDN, ele pode gerar links para o seu domínio original (como seusite.com), mesmo quando o conteúdo está sendo servido pelo CDN (como cdn.seusite.com). Isso causa erros e perda de desempenho.
Dica do Sensei: Sempre verifique se o CDN está ativo e configurado corretamente antes de seguir os passos abaixo. Se não souber como configurar o CDN, entre em contato com o suporte do serviço que você está usando.
Passo 1: Ative o modo de "proxy" ou "modo de CDN" no WordPress
Se você está usando um serviço de CDN como Cloudflare, ele pode ter um modo chamado Proxy (ou "modo de CDN") que faz com que o tráfego passe por ele. Isso é bom — mas o WordPress precisa saber que está atrás de um proxy.
Para isso, vamos editar o arquivo wp-config.php — o coração do seu WordPress.
Como editar o wp-config.php:
- Entre no cPanel da sua conta.
- Na seção Arquivos, clique em Gerenciador de Arquivos.
- Selecione a pasta
public_html(ou a pasta do seu site, se estiver em subdiretório). - Localize o arquivo
wp-config.phpna lista de arquivos. - Clique com o botão direito nele e escolha Editar (ou "Editar com o editor de texto").
- Procure por uma linha que diga:
define('WP_DEBUG', false);
Acima dessa linha, insira o seguinte código:
define('FORCE_SSL_ADMIN', true);
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on';
}
Salve as alterações.
Dica do Sensei: Nunca altere o arquivo wp-config.php sem fazer um backup. Se algo der errado, você pode restaurar do backup.
Passo 2: Configure o WordPress para usar URLs corretas (CDN)
Agora que o WordPress entende que está sendo servido por HTTPS e por um proxy, precisamos dizer a ele que os arquivos estão sendo servidos pelo CDN.
Para isso, vamos usar um plugin simples chamado WP Offload Media ou Cloudflare (se for o seu CDN), mas se você não quiser instalar plugins, podemos fazer isso manualmente com um código no functions.php.
Opção 1: Usando o arquivo functions.php (recomendado para leigos que querem controle direto)
- No Gerenciador de Arquivos do cPanel, vá até a pasta
public_html/wp-content/themes/seu-tema(substitua "seu-tema" pelo nome do seu tema, comotwentytwentyfour). - Localize o arquivo
functions.phpe clique em Editar. - Acima da linha
<?php(ou no final do arquivo, antes do fechamento), insira este código:
// Forçar URLs do site para o CDN
add_filter('siteurl', 'force_cdn_url');
add_filter('home', 'force_cdn_url');
function force_cdn_url($url) {
$cdn_url = 'https://cdn.seusite.com'; // Substitua pelo seu domínio CDN
if (strpos($url, 'seusite.com') !== false) {
$url = str_replace('https://seusite.com', $cdn_url, $url);
}
return $url;
}
Substitua https://cdn.seusite.com pelo domínio real do seu CDN (ex: https://cdn.meusite.com.br).
Salve as alterações.
Dica do Sensei: Se você não souber qual é o domínio do CDN, verifique com o provedor dele (ex: Cloudflare, BunnyCDN). Ele geralmente é algo como cdn.seusite.com.
Passo 3: Limpe o cache do WordPress
Depois de fazer as alterações, o WordPress pode estar usando arquivos antigos. Vamos limpar o cache para garantir que tudo esteja atualizado.
Se você usa um plugin de cache (como WP Super Cache, W3 Total Cache ou LiteSpeed Cache), vá até o painel do plugin e clique em Limpar Cache.
Se não usa plugin, você pode limpar o cache manualmente:
- No cPanel, vá até Gerenciador de Arquivos.
- Entre na pasta
wp-content/cache(ouwp-content/uploads/cache). - Exclua todos os arquivos e pastas dentro dela.
Passo 4: Teste o resultado
Abra seu site em um navegador novo (ou em modo anônimo) e verifique:
- As imagens estão carregando?
- Os links internos estão apontando para o CDN?
- O site está carregando mais rápido?
Se tudo estiver funcionando, parabéns! Você acaba de dar um grande passo para tornar seu site mais rápido, seguro e profissional.
Quer mais? Dicas extras do Sensei
- Se usar o Cloudflare, ative o modo Proxy (nuvem laranja) nos arquivos estáticos (CSS, JS, imagens).
- Evite configurar CDN em domínios de e-mail ou login (como
login.seusite.com). - Use HTTPS em todo o site — isso é obrigatório para CDN funcionar bem.
Se precisar de ajuda, basta entrar em contato com o suporte da GeHost. Estamos aqui para te ajudar, sempre.
Com carinho,
Sensei da GeHost 🌟