amayo/AmayoWeb/NGINX_SETUP.md

Guía de Configuración de Nginx para docs.amayo.dev

📋 Requisitos Previos

• Ubuntu/Debian VPS con acceso root o sudo
• Nginx instalado
• Dominio docs.amayo.dev apuntando a tu VPS
• Certificado SSL (Let's Encrypt recomendado)

1. Instalar Nginx (si no está instalado)

sudo apt update
sudo apt install nginx
sudo systemctl start nginx
sudo systemctl enable nginx

2. Crear directorio para la aplicación

sudo mkdir -p /var/www/docs.amayo.dev/dist
sudo chown -R $USER:$USER /var/www/docs.amayo.dev

3. Crear configuración de Nginx

Crea el archivo de configuración:

sudo nano /etc/nginx/sites-available/docs.amayo.dev

Pega la siguiente configuración:

# Redirigir HTTP a HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name docs.amayo.dev;
    
    return 301 https://$server_name$request_uri;
}

# Configuración HTTPS
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name docs.amayo.dev;

    # Certificados SSL
    ssl_certificate /etc/letsencrypt/live/docs.amayo.dev/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/docs.amayo.dev/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/docs.amayo.dev/chain.pem;

    # Configuración SSL moderna
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    ssl_stapling on;
    ssl_stapling_verify on;

    # Headers de seguridad
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;

    # Root y index
    root /var/www/docs.amayo.dev/dist;
    index index.html;

    # Logs
    access_log /var/log/nginx/docs.amayo.dev.access.log;
    error_log /var/log/nginx/docs.amayo.dev.error.log;

    # Configuración para SPA (Single Page Application)
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Proxy para API backend (ajusta el puerto según tu configuración)
    location /api {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        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_cache_bypass $http_upgrade;
        
        # Timeouts
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }

    # Cache para assets estáticos
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|webp)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        access_log off;
    }

    # Desactivar logs para favicon y robots.txt
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    location = /robots.txt {
        log_not_found off;
        access_log off;
    }

    # Compresión Gzip
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss application/rss+xml font/truetype font/opentype application/vnd.ms-fontobject image/svg+xml;
    gzip_disable "msie6";

    # Brotli compression (si está disponible)
    # brotli on;
    # brotli_comp_level 6;
    # brotli_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss;
}

4. Habilitar el sitio

# Crear enlace simbólico
sudo ln -s /etc/nginx/sites-available/docs.amayo.dev /etc/nginx/sites-enabled/

# Eliminar configuración por defecto (opcional)
sudo rm /etc/nginx/sites-enabled/default

5. Instalar Certbot para SSL (Let's Encrypt)

sudo apt install certbot python3-certbot-nginx

# Obtener certificado
sudo certbot --nginx -d docs.amayo.dev

# El certificado se renovará automáticamente

6. Verificar configuración de Nginx

sudo nginx -t

Si todo está bien, deberías ver:

nginx: configuration file /etc/nginx/nginx.conf test is successful

7. Reiniciar Nginx

sudo systemctl restart nginx

8. Configurar Firewall (si está activo)

sudo ufw allow 'Nginx Full'
sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw status

9. Verificar que funciona

curl -I https://docs.amayo.dev

Deberías ver un código 200 o 301.

📝 Comandos Útiles

Verificar estado de Nginx

sudo systemctl status nginx

Ver logs en tiempo real

sudo tail -f /var/log/nginx/docs.amayo.dev.access.log
sudo tail -f /var/log/nginx/docs.amayo.dev.error.log

Recargar configuración sin downtime

sudo nginx -t && sudo systemctl reload nginx

Renovar certificado SSL manualmente

sudo certbot renew

🔒 Configuración PM2 para Backend (Opcional)

Si tienes un backend Node.js para la autenticación:

# Instalar PM2
npm install -g pm2

# Iniciar el servidor
pm2 start server-example.js --name "amayo-auth"

# Configurar para iniciar al arranque
pm2 startup
pm2 save

# Ver logs
pm2 logs amayo-auth

# Reiniciar
pm2 restart amayo-auth

🐛 Troubleshooting

Error 502 Bad Gateway

• Verifica que el backend esté corriendo: pm2 status
• Revisa los logs: sudo tail -f /var/log/nginx/error.log

Error 403 Forbidden

• Verifica permisos: sudo chown -R www-data:www-data /var/www/docs.amayo.dev
• Verifica que index.html existe en /var/www/docs.amayo.dev/dist/

Error SSL

• Renueva el certificado: sudo certbot renew --force-renewal
• Verifica rutas de certificados en la configuración de Nginx

📊 Monitoreo (Opcional)

Instalar herramientas de monitoreo

# GoAccess para análisis de logs
sudo apt install goaccess
goaccess /var/log/nginx/docs.amayo.dev.access.log --log-format=COMBINED

# Netdata para monitoreo en tiempo real
bash <(curl -Ss https://my-netdata.io/kickstart.sh)

---

¡Tu sitio debería estar funcionando en https://docs.amayo.dev! 🎉