9router/gitbook/content/es/deployment/cloud.md

☁️ Despliegue en la nube

Despliega 9Router en VPS o Docker para acceso remoto y uso en producción.

---

🖥️ Despliegue en VPS

Requisitos previos

• Ubuntu 20.04+ o distribución Linux similar
• Node.js 20+
• Git
• Acceso root o sudo

Paso 1: Clonar el repositorio

git clone https://github.com/decolua/9router.git
cd 9router/app

Paso 2: Instalar dependencias

npm install

Paso 3: Compilar la aplicación

npm run build

Paso 4: Configurar variables de entorno

Crea un archivo .env o exporta variables:

export JWT_SECRET="your-secure-secret-change-this-to-random-string"
export INITIAL_PASSWORD="your-secure-password"
export DATA_DIR="/var/lib/9router"
export NODE_ENV="production"

Variables de entorno:

Variable	Por defecto	Descripción
JWT_SECRET	Auto-generado	¡DEBE cambiarse en producción! Usado para firmar tokens JWT
INITIAL_PASSWORD	123456	Contraseña de login del dashboard
DATA_DIR	~/.9router	Ruta de almacenamiento de la base de datos
NODE_ENV	development	Establece a production para despliegue
ENABLE_REQUEST_LOGS	false	Habilita logs de debug de request/response

Paso 5: Crear el directorio de datos

sudo mkdir -p /var/lib/9router
sudo chown $USER:$USER /var/lib/9router

Paso 6: Iniciar la aplicación

npm run start

Paso 7: Configurar PM2 para producción

PM2 mantiene tu aplicación corriendo y la reinicia en caso de crash:

# Instalar PM2 globalmente
npm install -g pm2

# Iniciar 9Router con PM2
pm2 start npm --name 9router -- start

# Guardar la configuración de PM2
pm2 save

# Configurar PM2 para iniciar al arrancar el sistema
pm2 startup
# Sigue las instrucciones impresas por el comando anterior

Comandos de gestión de PM2:

# Ver logs
pm2 logs 9router

# Reiniciar aplicación
pm2 restart 9router

# Detener aplicación
pm2 stop 9router

# Ver estado
pm2 status

# Monitorear recursos
pm2 monit

---

🐳 Despliegue con Docker

Opción 1: Usando Dockerfile

Crea un Dockerfile en el directorio app:

FROM node:20-alpine

WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm ci --only=production

# Copy application files
COPY . .

# Build application
RUN npm run build

# Expose ports
EXPOSE 3000 20128

# Set environment variables
ENV NODE_ENV=production
ENV DATA_DIR=/app/data

# Create data directory
RUN mkdir -p /app/data

# Start application
CMD ["npm", "run", "start"]

Build y Run:

# Construir imagen
docker build -t 9router .

# Ejecutar contenedor
docker run -d \
  --name 9router \
  -p 3000:3000 \
  -p 20128:20128 \
  -e JWT_SECRET="your-secure-secret-change-this" \
  -e INITIAL_PASSWORD="your-secure-password" \
  -v 9router-data:/app/data \
  9router

Opción 2: Docker Compose

Crea docker-compose.yml:

version: '3.8'

services:
  9router:
    build: .
    container_name: 9router
    ports:
      - "3000:3000"
      - "20128:20128"
    environment:
      - NODE_ENV=production
      - JWT_SECRET=your-secure-secret-change-this
      - INITIAL_PASSWORD=your-secure-password
      - DATA_DIR=/app/data
    volumes:
      - 9router-data:/app/data
    restart: unless-stopped

volumes:
  9router-data:

Ejecutar con Docker Compose:

# Iniciar servicios
docker-compose up -d

# Ver logs
docker-compose logs -f

# Detener servicios
docker-compose down

# Reconstruir y reiniciar
docker-compose up -d --build

---

🌐 Proxy reverso con Nginx

¿Por qué usar Nginx?

• Terminación SSL/TLS
• Mapeo de nombre de dominio
• Balanceo de carga
• Mejor seguridad

Paso 1: Instalar Nginx

sudo apt update
sudo apt install nginx

Paso 2: Configurar Nginx

Crea /etc/nginx/sites-available/9router:

server {
    listen 80;
    server_name your-domain.com;

    # Redirect HTTP to HTTPS
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    # SSL certificates (use certbot to generate)
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    # SSL configuration
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;

    # Proxy to 9Router
    location / {
        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;
        
        # SSE support - CRITICAL for streaming
        proxy_buffering off;
        proxy_read_timeout 86400;
    }

    # API endpoint
    location /v1 {
        proxy_pass http://localhost:20128;
        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;
        
        # SSE support - CRITICAL for streaming
        proxy_buffering off;
        proxy_read_timeout 86400;
    }
}

Paso 3: Habilitar el sitio

# Crear enlace simbólico
sudo ln -s /etc/nginx/sites-available/9router /etc/nginx/sites-enabled/

# Probar configuración
sudo nginx -t

# Recargar Nginx
sudo systemctl reload nginx

Paso 4: Configurar SSL con Let's Encrypt

# Instalar certbot
sudo apt install certbot python3-certbot-nginx

# Obtener certificado SSL
sudo certbot --nginx -d your-domain.com

# La auto-renovación se configura automáticamente
# Probar renovación
sudo certbot renew --dry-run

---

🔒 Consideraciones de seguridad

1. Cambiar credenciales por defecto

CRÍTICO: Cambia JWT_SECRET y INITIAL_PASSWORD antes del despliegue:

# Generar JWT secret seguro
openssl rand -base64 32

# Usa este valor para JWT_SECRET
export JWT_SECRET="generated-secret-here"

2. Configuración del firewall

# Permitir SSH
sudo ufw allow 22/tcp

# Permitir HTTP/HTTPS (si usas Nginx)
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# Si NO usas proxy reverso, permite los puertos de 9Router
sudo ufw allow 3000/tcp
sudo ufw allow 20128/tcp

# Habilitar firewall
sudo ufw enable

3. Restringir el acceso al dashboard

Si solo necesitas acceso por API, restringe el puerto del dashboard:

# Solo permitir acceso localhost al dashboard
sudo ufw deny 3000/tcp

Accede al dashboard vía túnel SSH:

ssh -L 3000:localhost:3000 user@your-server.com
# Luego abre http://localhost:3000 en tu navegador

4. Actualizaciones regulares

# Actualizar paquetes del sistema
sudo apt update && sudo apt upgrade -y

# Actualizar 9Router
cd /path/to/9router/app
git pull
npm install
npm run build
pm2 restart 9router

5. Estrategia de respaldo

# Respaldar el directorio de datos
tar -czf 9router-backup-$(date +%Y%m%d).tar.gz /var/lib/9router

# Respaldo automatizado diario (agregar a crontab)
0 2 * * * tar -czf /backups/9router-$(date +\%Y\%m\%d).tar.gz /var/lib/9router

---

📊 Monitoreo

Verificar el estado de la aplicación

# Estado PM2
pm2 status

# Ver logs
pm2 logs 9router --lines 100

# Monitorear recursos
pm2 monit

Logs de Nginx

# Logs de acceso
sudo tail -f /var/log/nginx/access.log

# Logs de error
sudo tail -f /var/log/nginx/error.log

Recursos del sistema

# Uso de CPU y memoria
htop

# Uso de disco
df -h

# Conexiones de red
netstat -tulpn | grep -E '3000|20128'

---

🚨 Solución de problemas

La aplicación no inicia

# Verificar logs
pm2 logs 9router

# Verificar si los puertos están en uso
sudo lsof -i :3000
sudo lsof -i :20128

# Verificar variables de entorno
pm2 env 9router

Nginx 502 Bad Gateway

# Verificar si 9Router está corriendo
pm2 status

# Verificar logs de error de Nginx
sudo tail -f /var/log/nginx/error.log

# Probar configuración de Nginx
sudo nginx -t

El streaming SSE no funciona

Asegúrate de que proxy_buffering off esté configurado en Nginx para soporte SSE.

Errores de permiso denegado

# Corregir permisos del directorio de datos
sudo chown -R $USER:$USER /var/lib/9router
chmod 755 /var/lib/9router

---

🔗 Próximos pasos

• Conectar proveedores
• Configurar combos
• Integrar con herramientas