Guia: por que WordPress com Nginx e SSL falha no Windows 2025

16 min de leitura  ·  Guia técnico

Como instalar WordPress com Nginx e SSL no Windows Server 2025 é o processo de preparar o Windows Server para servir arquivos do WordPress pelo Nginx, processar PHP corretamente e publicar o site em HTTPS. Para fazer a instalação sem cair em erro 502, página em branco ou CSS quebrado, siga estes passos:

1. Confirme acesso administrativo ao Windows Server 2025 e ao DNS do domínio.
2. Instale e valide Nginx 1.28 ou superior, PHP 8.4 ou superior e MariaDB 11.8 ou superior.
3. Crie a pasta do site, extraia o WordPress e ajuste permissões de leitura e gravação.
4. Crie o banco de dados e vincule as credenciais no arquivo de configuração do WordPress.
5. Configure o host virtual do Nginx para HTTP, PHP e HTTPS com certificado válido.
6. Teste portas, logs, redirecionamento HTTPS e carregamento de imagens antes de colocar em produção.

Pré-requisitos

• Acesso como Administrator ao Windows Server 2025, preferencialmente via Área de Trabalho Remota.
• Domínio apontando para o IP público do servidor, com acesso ao painel DNS para validar registros.
• Nginx 1.28 ou superior instalado em uma pasta fixa, como C:\nginx.
• PHP 8.4 ou superior disponível em uma pasta como C:\php, com extensões necessárias para WordPress.
• MariaDB 11.8 ou superior ou banco MySQL compatível acessível localmente.
• Certificado TLS emitido para o domínio, com arquivo de certificado e chave privada disponíveis no servidor.
• Permissão para liberar as portas 80 e 443 no firewall local e na camada de rede do provedor.
• Backup ou snapshot antes de alterar configuração de servidor já em produção.

Como instalar WordPress com Nginx e SSL no Windows Server 2025

Instalação do WordPress no Windows Server falha com frequência quando o Nginx está funcionando, mas o PHP não está ouvindo na porta esperada ou o caminho físico do site não combina com o root configurado. Antes de baixar arquivos ou mexer no SSL, valide se você consegue acessar o servidor por RDP, se o domínio resolve para o IP correto e se o Windows Firewall não bloqueia as portas públicas. Se precisar revisar o acesso remoto, veja também Acessando servidores VPS Windows da AviraHost.

Crie uma estrutura simples de diretórios. Evite nomes com espaços no caminho do WordPress, porque isso reduz erros em parâmetros do Nginx e facilita a leitura dos logs. Use um diretório para o site, outro para certificados e mantenha os binários de Nginx e PHP separados.

New-Item -ItemType Directory -Path C:\web\wordpress -Force
New-Item -ItemType Directory -Path C:\certs -Force
New-Item -ItemType Directory -Path C:\logs\nginx -Force

Output esperado:
Diretórios criados ou já existentes:
C:\web\wordpress
C:\certs
C:\logs\nginx

Depois de extrair o pacote do WordPress para a pasta do site, confirme que os arquivos principais estão no root correto. Um erro comum é deixar o conteúdo em C:\web\wordpress\wordpress, enquanto o Nginx aponta para C:\web\wordpress. Isso gera 404 em arquivos estáticos, instalador que não abre ou carregamento parcial de CSS.

Get-ChildItem C:\web\wordpress | Select-Object Name

Output esperado:
Name
index.php
wp-admin
wp-content
wp-includes
wp-config-sample.php

Preparar PHP 8.4 para processar WordPress no Nginx

PHP no Nginx para WordPress depende de um processo PHP escutando localmente para que o Nginx encaminhe arquivos .php. No Windows Server 2025, a falha mais comum é tratar o Nginx como se ele executasse PHP sozinho. Ele não executa. O Nginx entrega arquivos estáticos e repassa scripts PHP para um backend, como um processo PHP-CGI configurado para ouvir em 127.0.0.1 na porta 9000.

Verifique primeiro se o PHP responde no terminal e se as extensões básicas carregam sem erro. Se o comando abaixo não retornar a versão, corrija o caminho do executável antes de continuar, porque qualquer configuração de Nginx vai resultar em erro 502 se o backend PHP não existir.

C:\php\php.exe -v

Output esperado:
PHP 8.4 ou superior
Copyright e informações de build exibidas sem erro fatal

Inicie o PHP-CGI em localhost. Em produção, prefira transformar esse processo em serviço do Windows para reinício automático, mas para validar a instalação inicial o comando abaixo permite testar a comunicação rapidamente.

Start-Process -FilePath C:\php\php-cgi.exe -ArgumentList "-b 127.0.0.1:9000" -WindowStyle Hidden
Test-NetConnection 127.0.0.1 -Port 9000

Output esperado:
ComputerName     : 127.0.0.1
RemotePort       : 9000
TcpTestSucceeded : True

Se o teste da porta falhar, pare antes de configurar o host virtual. Verifique antivírus, firewall local, caminho incorreto do php-cgi.exe e conflitos de porta. O WordPress só vai instalar corretamente quando o Nginx conseguir entregar index.php ao interpretador PHP sem bloqueio local.

Criar banco de dados MariaDB para WordPress

Banco de dados do WordPress no Windows precisa estar criado antes da etapa final do instalador, com usuário próprio e senha forte. Use um banco dedicado para o site, porque isso facilita backup, restauração e diagnóstico. Se você usar o mesmo servidor para vários sites, não reutilize o usuário root do banco dentro do wp-config.php.

Atenção: os comandos abaixo criam banco, usuário e permissões. Se já existir um banco chamado wordpress ou um usuário chamado wpuser, revise os nomes antes de executar para não misturar credenciais de outro site.

mysql -u root -p

Output esperado:
Enter password:
MariaDB ou MySQL monitor aberto aguardando comandos SQL

CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'troque-esta-senha';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Output esperado:
Query OK
Query OK
Query OK
Query OK
Bye

Depois disso, configure o WordPress com nome do banco wordpress, usuário wpuser, senha definida e host localhost. Se o banco estiver em outro servidor, use o host correto e confirme a conectividade antes da instalação. Para cenários com acesso remoto a banco em ambiente com painel, o artigo Conectando remotamente ao MySQL - cPanel ajuda a entender a liberação de hosts.

Configurar Nginx 1.28 com host virtual para WordPress

Nginx para WordPress no Windows deve apontar o root exatamente para a pasta onde estão index.php, wp-admin, wp-content e wp-includes. A configuração também precisa encaminhar requisições PHP para 127.0.0.1:9000, definir index.php como índice e registrar logs em arquivos fáceis de consultar. O erro técnico mais comum é usar um caminho de script diferente do caminho real do arquivo, causando 502 ou 404 intermitente.

No arquivo de configuração do Nginx, valide os seguintes itens sem misturar blocos de sites diferentes: server_name com o domínio correto, root igual a C:\web\wordpress, index contendo index.php, regra de URL amigável usando fallback para index.php, encaminhamento de arquivos .php para 127.0.0.1:9000 e parâmetro de script baseado no caminho físico real do arquivo solicitado. Também mantenha logs separados para acesso e erro, pois eles aceleram o diagnóstico.

Atenção: antes de recarregar o Nginx, sempre teste a sintaxe. Um erro simples no arquivo de configuração pode impedir o serviço de subir e tirar o site do ar.

C:\nginx\nginx.exe -t

Output esperado:
nginx: the configuration file C:\nginx\conf\nginx.conf syntax is ok
nginx: configuration file C:\nginx\conf\nginx.conf test is successful

Com a sintaxe validada, inicie ou recarregue o Nginx. Ao rodar este comando, você verá o processo ativo no gerenciador de tarefas ou conseguirá testar a porta 80 localmente.

Start-Process -FilePath C:\nginx\nginx.exe -WorkingDirectory C:\nginx
Test-NetConnection 127.0.0.1 -Port 80

Output esperado:
ComputerName     : 127.0.0.1
RemotePort       : 80
TcpTestSucceeded : True

Abra o domínio em HTTP apenas para validar a entrega inicial. Se o instalador do WordPress aparecer, a cadeia Nginx, PHP e banco está próxima do correto. Se baixar o arquivo PHP em vez de executar, o encaminhamento PHP não foi aplicado. Se aparecer 502, o PHP não está respondendo ou o parâmetro de script não aponta para o arquivo certo.

Ativar SSL e redirecionar HTTP para HTTPS

SSL no WordPress com Nginx exige três pontos alinhados: certificado válido para o domínio, porta 443 liberada e URL do WordPress usando https. O Nginx não corrige automaticamente URLs antigas gravadas no WordPress, então você deve validar tanto a camada TLS quanto as configurações internas do CMS.

Copie o certificado e a chave privada para C:\certs ou outro diretório protegido. O bloco HTTPS do Nginx deve usar a porta 443 com SSL, o mesmo server_name do domínio, os caminhos completos do certificado e da chave, o mesmo root do site e as mesmas regras PHP já testadas no HTTP. O bloco da porta 80 deve redirecionar para HTTPS para evitar conteúdo misto. Para uma visão geral de redirecionamento, consulte Como redirecionar um site http para https?.

Test-Path C:\certs\seudominio-fullchain.pem
Test-Path C:\certs\seudominio-privkey.pem

Output esperado:
True
True

Depois de ajustar o bloco HTTPS, teste a configuração e valide a porta 443. Não pule esse teste: ele separa problema de certificado, erro de sintaxe e bloqueio de firewall.

C:\nginx\nginx.exe -t
C:\nginx\nginx.exe -s reload
Test-NetConnection 127.0.0.1 -Port 443

Output esperado:
syntax is ok
test is successful
TcpTestSucceeded : True

No painel do WordPress, ajuste o endereço do site para https com o domínio final. Se você acabou de instalar, faça isso na própria tela de configuração. Em sites migrados, revise também links internos, mídia e plugins de cache, porque conteúdo misto geralmente vem de URLs absolutas antigas com http.

Validar instalação, logs e permissões do WordPress

Permissões do WordPress no Windows Server determinam se uploads, temas, plugins e cache conseguem gravar em wp-content. O usuário usado pelo processo web precisa ler os arquivos do site e gravar nas pastas que o WordPress atualiza. Permissão excessiva também é risco: não conceda controle total para todos os usuários apenas para fazer o instalador passar.

Comece validando se os arquivos existem e se wp-content está acessível. Depois, confira logs do Nginx e erros do PHP sempre que a página responder 500, 502 ou carregar parcialmente. O caminho exato dos logs depende da configuração definida, mas manter C:\logs\nginx facilita a rotina.

Get-ChildItem C:\web\wordpress\wp-content | Select-Object Name
Get-ChildItem C:\logs\nginx | Select-Object Name,Length

Output esperado:
Name
plugins
themes
uploads

Name              Length
access.log        valor maior ou igual a zero
error.log         valor maior ou igual a zero

Teste o site em três URLs: página inicial em HTTPS, painel administrativo em wp-admin e um arquivo de mídia enviado pelo WordPress. Se a home abre, mas o painel não, revise cookies, URL do site e redirecionamento. Se o painel abre, mas imagens não carregam, o problema costuma estar em root, permissão ou URL duplicada no redirecionamento.

Problemas comuns e como resolver

Sintoma: WordPress mostra erro 502 Bad Gateway

Causa: o Nginx não conseguiu falar com o processo PHP. Isso ocorre quando o PHP-CGI está parado, a porta configurada no Nginx é diferente da porta real, o firewall bloqueia localhost ou o parâmetro de script aponta para um caminho inexistente. Solução: rode Test-NetConnection em 127.0.0.1 na porta 9000, confirme o processo php-cgi.exe e revise o caminho físico do root do WordPress. Depois execute C:\nginx\nginx.exe -t e recarregue o Nginx somente se o teste passar.

Sintoma: HTTPS abre, mas CSS e imagens não carregam

Causa: o root do Nginx aponta para uma pasta acima ou abaixo da instalação real, ou o WordPress ainda usa URL antiga com http. Também pode ocorrer quando wp-content não tem permissão de leitura para o usuário do serviço web. Solução: confirme que index.php, wp-content e wp-includes estão na mesma pasta indicada no root, ajuste a URL do WordPress para https e revise permissões de leitura em C:\web\wordpress.

Sintoma: instalador do WordPress não conecta ao banco

Causa: nome do banco, usuário, senha ou host foram digitados incorretamente, ou o serviço de banco não está ativo. Em instalações locais, localhost costuma ser o host esperado, mas ambientes com banco separado exigem endereço próprio e liberação de acesso. Solução: teste login com mysql -u wpuser -p, confirme se o banco wordpress existe e se o usuário recebeu permissão sobre wordpress.*.

Sintoma: navegador informa certificado inválido

Causa: o certificado não foi emitido para o domínio acessado, o caminho do arquivo está errado ou o Nginx carregou certificado antigo. Também pode acontecer quando o DNS ainda aponta para outro IP. Solução: verifique os arquivos com Test-Path, teste a sintaxe do Nginx, recarregue o serviço e confirme se o domínio resolve para o IP correto do Windows Server 2025.

Perguntas frequentes sobre Como instalar WordPress com Nginx e SSL no Windows Server 2025

Dá para instalar WordPress com Nginx no Windows Server 2025?

Sim, é possível instalar WordPress com Nginx no Windows Server 2025 quando o servidor tiver PHP, banco de dados e configuração de host virtual compatíveis. O ponto crítico é ajustar corretamente o processamento PHP, as permissões dos arquivos e o certificado TLS para que o WordPress responda em HTTPS.

Por que o WordPress com Nginx mostra erro 502 no Windows Server?

O erro 502 geralmente indica que o Nginx não conseguiu se comunicar com o processo PHP responsável por executar o WordPress. As causas mais comuns são porta PHP incorreta, serviço PHP parado, caminho errado no fastcgi_param ou bloqueio local de firewall.

Preciso usar Apache para rodar WordPress no Windows Server 2025?

Não é obrigatório usar Apache para rodar WordPress no Windows Server 2025. O Nginx pode servir os arquivos estáticos e encaminhar requisições PHP para o PHP-CGI ou PHP-FPM equivalente disponível no ambiente, desde que a configuração esteja correta.

Como ativar SSL no WordPress com Nginx no Windows Server 2025?

Para ativar SSL, configure o bloco HTTPS do Nginx com os caminhos do certificado e da chave privada, libere a porta 443 e ajuste a URL do WordPress para usar https. Também é importante redirecionar HTTP para HTTPS para evitar conteúdo misto e acessos inseguros.

O que verificar quando o WordPress instala mas não carrega imagens ou CSS?

Verifique se o root do site no Nginx aponta para a pasta correta do WordPress e se os arquivos têm permissão de leitura para o usuário do serviço web. Também confira se a URL do site está definida com o domínio correto e se o redirecionamento HTTPS não está gerando caminhos duplicados.

Conclusão

• Valide Nginx, PHP e banco separadamente antes de iniciar o instalador do WordPress.
• Use caminhos simples, logs separados e teste C:\nginx\nginx.exe -t antes de qualquer reload.
• Ative HTTPS somente depois que HTTP, PHP e banco estiverem funcionando, e revise URLs internas para evitar conteúdo misto.

Leia também

• Otimizar Node-RED Dashboard 2.0 no FreeBSD 14.3 com Nginx e SSL
• Passo a passo para migrar aplicação Node.js do Heroku para VPS Ubuntu 22.04
• Checklist para configurar servidor LAMP no Ubuntu 22.04

Precisa de ajuda com WordPress, Nginx e SSL no Windows Server 2025?

A AviraHost oferece soluções de hospedagem para sites WordPress com foco em estabilidade, suporte e ambiente adequado para publicar seu projeto com segurança. Se você prefere reduzir a complexidade de manter Nginx, PHP, banco e SSL manualmente, escolha um plano compatível com sua demanda.

Conheça a hospedagem de sites da AviraHost