amayo/README/VPS_SETUP_COMMANDS.md

🎯 Comandos Exactos para el VPS

✅ Ya Tienes Configurado

✓ Certificado SSL para api.amayo.dev
✓ Certificado SSL para docs.amayo.dev (según tu configuración)
✓ NGINX instalado

📝 Pasos a Seguir

1. Configurar NGINX para docs.amayo.dev (Frontend Vue)

Editar el archivo de configuración existente:

sudo nano /etc/nginx/sites-available/default

Reemplazar la configuración de docs.amayo.dev con esto:

server {
    listen 80;
    listen [::]:80;
    server_name docs.amayo.dev;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name docs.amayo.dev;

    ssl_certificate /etc/letsencrypt/live/docs.amayo.dev/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/docs.amayo.dev/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    # IMPORTANTE: Cambiar a archivos estáticos
    root /var/www/docs.amayo.dev;
    index index.html;

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

    # Gzip
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json application/javascript;

    # SPA fallback
    location / {
        try_files $uri $uri/ /index.html;
    }

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

    # Security headers
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
}

2. Configurar NGINX para api.amayo.dev (Backend)

En el mismo archivo o crear uno separado:

sudo nano /etc/nginx/sites-available/default

Agregar o modificar la sección de api.amayo.dev:

server {
    listen 80;
    listen [::]:80;
    server_name api.amayo.dev;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name api.amayo.dev;

    ssl_certificate /etc/letsencrypt/live/api.amayo.dev/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/api.amayo.dev/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    access_log /var/log/nginx/api.amayo.dev.access.log;
    error_log /var/log/nginx/api.amayo.dev.error.log;

    # Proxy al bot en puerto 3000
    location / {
        proxy_pass http://127.0.0.1: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;

        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }

    # CORS para el frontend
    add_header Access-Control-Allow-Origin "https://docs.amayo.dev" always;
    add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
    add_header Access-Control-Allow-Headers "Authorization, Content-Type" always;
    add_header Access-Control-Allow-Credentials "true" always;

    # Manejar preflight
    if ($request_method = 'OPTIONS') {
        add_header Access-Control-Allow-Origin "https://docs.amayo.dev" always;
        add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
        add_header Access-Control-Allow-Headers "Authorization, Content-Type" always;
        add_header Access-Control-Max-Age 1728000;
        add_header Content-Type 'text/plain; charset=utf-8';
        add_header Content-Length 0;
        return 204;
    }

    # Security headers
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
}

3. Verificar y Reiniciar NGINX

# Verificar sintaxis
sudo nginx -t

# Si está OK, reiniciar
sudo systemctl restart nginx

# Ver estado
sudo systemctl status nginx

4. Crear Directorio para el Frontend

# Crear directorio
sudo mkdir -p /var/www/docs.amayo.dev

# Ajustar permisos
sudo chown -R $USER:www-data /var/www/docs.amayo.dev
sudo chmod -R 755 /var/www/docs.amayo.dev

5. Deploy del Frontend (Desde tu PC Local)

En tu PC con Windows, en la carpeta AmayoWeb:

# Build
npm run build

# El contenido estará en la carpeta dist/

Transferir archivos al VPS:

Opción A - Con SCP desde PowerShell:

scp -r dist/* shnimlz@tu_ip_servidor:/home/shnimlz/amayo-frontend/

Opción B - Con WinSCP o FileZilla (interfaz gráfica)

En el VPS, mover los archivos:

# Copiar archivos al directorio web
sudo cp -r /home/shnimlz/amayo-frontend/* /var/www/docs.amayo.dev/

# Ajustar permisos
sudo chown -R www-data:www-data /var/www/docs.amayo.dev
sudo chmod -R 755 /var/www/docs.amayo.dev

6. Verificar Variables de Entorno del Bot

En el servidor VPS:

cd /ruta/a/tu/proyecto/amayo

# Editar .env
nano .env

Asegúrate de tener:

PORT=3000
DISCORD_TOKEN=tu_token
# ... resto de tus variables

7. Verificar que el Bot Esté Corriendo

# Si usas PM2
pm2 status

# Ver logs
pm2 logs amayo

# Reiniciar si es necesario
pm2 restart amayo

# Si no usas PM2, verificar el proceso
ps aux | grep node

# Verificar que esté en el puerto 3000
netstat -tulpn | grep 3000

8. Verificar que Todo Funcione

# Verificar frontend
curl https://docs.amayo.dev

# Verificar backend API
curl https://api.amayo.dev/api/bot/stats

# Ver logs de NGINX
sudo tail -f /var/log/nginx/docs.amayo.dev.access.log
sudo tail -f /var/log/nginx/api.amayo.dev.access.log

🔥 Comando Rápido de Deploy (Crear Script)

Crear archivo en el servidor:

nano ~/deploy-amayo-frontend.sh

Contenido:

#!/bin/bash

echo "🚀 Deploying Amayo Frontend..."

# Limpiar directorio
sudo rm -rf /var/www/docs.amayo.dev/*

# Copiar nuevos archivos (ajusta la ruta según donde subas los archivos)
sudo cp -r /home/shnimlz/amayo-frontend/* /var/www/docs.amayo.dev/

# Permisos
sudo chown -R www-data:www-data /var/www/docs.amayo.dev
sudo chmod -R 755 /var/www/docs.amayo.dev

# Reiniciar NGINX
sudo systemctl reload nginx

echo "✅ Deploy completado!"
echo "🌐 https://docs.amayo.dev"

Hacer ejecutable:

chmod +x ~/deploy-amayo-frontend.sh

Usar:

./deploy-amayo-frontend.sh

🎯 Resumen de URLs

Servicio	URL	Puerto Interno
Frontend	https://docs.amayo.dev	Archivos estáticos
Backend API	https://api.amayo.dev	→ localhost:3000

🔍 Troubleshooting Rápido

El frontend no carga

# Ver logs
sudo tail -f /var/log/nginx/error.log

# Verificar archivos
ls -la /var/www/docs.amayo.dev/

# Verificar NGINX
sudo nginx -t

La API no responde (502)

# Verificar bot
pm2 status
pm2 logs amayo

# Verificar puerto
netstat -tulpn | grep 3000

# Reiniciar bot
pm2 restart amayo

CORS errors

Verificar que la configuración de NGINX tenga los headers CORS correctos en la sección de api.amayo.dev.

---

Notas:

• El bot se ejecuta en el puerto 3000 (no 3001)
• El frontend son archivos estáticos de Vue
• NGINX hace proxy del API al bot en puerto 3000