Cómo instalar y configurar Nginx en VPS Windows Server

Abre PowerShell como administrador y crea el directorio de instalación:

New-Item -ItemType Directory -Path "C:\nginx" -Force
Set-Location "C:\nginx"

Este directorio albergará el binario, los archivos de configuración y los logs. Mantener todo en C:\nginx simplifica las rutas en nginx.conf y evita problemas con espacios (no uses C:\Program Files\).

Descarga la versión estable más reciente de Nginx para Windows:

Invoke-WebRequest -Uri "https://nginx.org/download/nginx-1.27.3.zip" -OutFile "nginx.zip"

Verifica la versión actual en nginx.org/en/download.html antes de ejecutar — la línea mainline (1.27.x) recibe correcciones con más frecuencia. La línea stable (1.26.x) es una alternativa más conservadora para producción.

Extrae el archivo y organiza el contenido en la raíz de C:\nginx:

Expand-Archive -Path "nginx.zip" -DestinationPath "C:\nginx-temp"
Move-Item -Path "C:\nginx-temp\nginx-1.27.3\*" -Destination "C:\nginx" -Force
Remove-Item -Path "C:\nginx-temp", "C:\nginx\nginx.zip" -Recurse -Force

Después de esto, C:\nginx debe contener nginx.exe y las carpetas conf, html, logs y temp.

Inicia Nginx en primer plano:

Set-Location "C:\nginx"
.\nginx.exe

El comando retorna inmediatamente — Nginx queda corriendo en background. Abre el navegador en la propia VPS y accede a http://localhost. La página por defecto “Welcome to nginx!” debe aparecer.

Detén el proceso manualmente antes de continuar:

.\nginx.exe -s stop

Usa -s quit para finalizar de forma elegante (espera a que terminen las conexiones activas) o -s stop para terminar inmediatamente.

Crea reglas para HTTP y HTTPS:

New-NetFirewallRule -DisplayName "Nginx HTTP" -Direction Inbound -Protocol TCP -LocalPort 80 -Action Allow
New-NetFirewallRule -DisplayName "Nginx HTTPS" -Direction Inbound -Protocol TCP -LocalPort 443 -Action Allow

Por defecto, esto aplica a todos los perfiles (Dominio, Privado, Público). Si tu VPS está en una red mixta, valida con Get-NetFirewallRule -DisplayName "Nginx*" | Format-List.

Descarga y extrae NSSM:

Invoke-WebRequest -Uri "https://nssm.cc/release/nssm-2.24.zip" -OutFile "C:\nssm.zip"
Expand-Archive -Path "C:\nssm.zip" -DestinationPath "C:\nssm-temp"
Move-Item -Path "C:\nssm-temp\nssm-2.24\win64\nssm.exe" -Destination "C:\nginx\nssm.exe"
Remove-Item -Path "C:\nssm-temp", "C:\nssm.zip" -Recurse -Force

La carpeta win64 contiene el binario de 64 bits. Si tu VPS es de 32 bits (raro hoy en día), usa win32.

Registra el servicio apuntando a nginx.exe:

C:\nginx\nssm.exe install Nginx "C:\nginx\nginx.exe"
C:\nginx\nssm.exe set Nginx AppDirectory "C:\nginx"
C:\nginx\nssm.exe set Nginx Start SERVICE_AUTO_START
C:\nginx\nssm.exe set Nginx AppStdout "C:\nginx\logs\service-stdout.log"
C:\nginx\nssm.exe set Nginx AppStderr "C:\nginx\logs\service-stderr.log"

El parámetro AppDirectory es crítico — sin él, Nginx busca conf/nginx.conf en el directorio equivocado y falla silenciosamente.

Inicia el servicio y habilita el autoarranque:

Start-Service Nginx
Get-Service Nginx

La columna Status debe mostrar Running. A partir de aquí, Nginx se levanta automáticamente al reiniciar el servidor.

Edita el archivo principal de configuración:

notepad C:\nginx\conf\nginx.conf

Dentro del bloque http { ... }, agrega un bloque server para hacer reverse proxy a una aplicación corriendo en localhost:3000 (típico para Node.js):

server {
    listen 80;
    server_name app.tudominio.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Los headers X-Real-IP y X-Forwarded-For preservan la IP real del cliente para la aplicación backend. Las líneas Upgrade y Connection habilitan WebSockets.

Para servir archivos estáticos directamente, agrega otro bloque server:

server {
    listen 80;
    server_name static.tudominio.com;
    root C:/sites/static;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~* \.(jpg|jpeg|png|gif|svg|css|js|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }
}

Atención al formato de la ruta: dentro de nginx.conf usa barra normal (C:/sites/static), nunca barra invertida. Nginx en Windows interpreta \ como carácter de escape.

Valida la configuración antes de recargar:

C:\nginx\nginx.exe -t

La salida esperada es syntax is ok seguida de test is successful. Cualquier error muestra el número exacto de línea.

Recarga Nginx sin tirar el servicio:

C:\nginx\nginx.exe -s reload

El proceso master lee el nuevo nginx.conf e inicia workers actualizados, manteniendo los antiguos atendiendo conexiones en curso hasta que finalicen.