2.9 KiB
🏠 Despliegue en localhost
Ejecuta 9Router en tu máquina local para desarrollo y uso personal.
📦 Instalación
Instala 9Router globalmente vía npm:
npm install -g 9router
Requisitos:
- Node.js 20 o superior
- npm 9 o superior
🚀 Iniciar el servidor
Inicia 9Router con un solo comando:
9router
El dashboard se abrirá automáticamente en tu navegador en http://localhost:3000
Configuración por defecto:
- Dashboard:
http://localhost:3000 - API Endpoint:
http://localhost:20128/v1 - Directorio de datos:
~/.9router
🔧 Configuración
Directorio de datos personalizado
Establece un directorio de datos personalizado usando una variable de entorno:
DATA_DIR=/path/to/data 9router
Puerto personalizado
El puerto de API (20128) y el puerto del dashboard (3000) están configurados en la aplicación. Para cambiarlos, necesitarás modificar el código fuente o usar variables de entorno si se soportan.
🛑 Detener el servidor
Presiona Ctrl+C en la terminal donde 9Router se está ejecutando.
# En la terminal ejecutando 9router
^C # Presiona Ctrl+C
El servidor se apagará correctamente y guardará todos los datos.
🔄 Reiniciar el servidor
Simplemente ejecuta el comando de inicio nuevamente:
9router
Todas tus configuraciones, API keys y combos se preservan en el directorio de datos.
📊 Actualizar 9Router
Actualiza a la última versión:
npm update -g 9router
Verifica tu versión actual:
npm list -g 9router
🔍 Solución de problemas
Puerto ya en uso
Si el puerto 20128 o 3000 ya está en uso:
# Encontrar proceso usando el puerto (macOS/Linux)
lsof -i :20128
lsof -i :3000
# Matar el proceso
kill -9 <PID>
Errores de permisos
Si encuentras errores de permisos durante la instalación:
# Usar sudo (no recomendado)
sudo npm install -g 9router
# O corregir los permisos de npm (recomendado)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
Problemas con el directorio de datos
Si el directorio de datos no es accesible:
# Verificar permisos
ls -la ~/.9router
# Corregir permisos
chmod 755 ~/.9router
📁 Estructura del directorio de datos
~/.9router/
├── db.json # Main database (providers, combos, settings)
├── logs/ # Application logs
└── cache/ # Temporary cache files
Respaldar tus datos:
# Respaldo
cp -r ~/.9router ~/.9router.backup
# Restaurar
cp -r ~/.9router.backup ~/.9router