PrivaStream

Desarrollo de un Servidor de Entretenimiento Local: Un Proyecto de Software Libre y Austero.

---

🚀 Guía Rápida: Cómo Ejecutar y Usar PrivaStream

Este proyecto está construido bajo una arquitectura Zero-Trust y está pensado para desplegarse fácilmente sobre un entorno Linux (ej. Ubuntu/Debian) usando nuestros scripts DevSecOps.

1. Inicializar la Infraestructura del Servidor

Toda la configuración pesada de Nginx, seguridad, Firewall y creación de túneles ha sido automatizada. Para ejecutarla:

1. Ingresa a tu servidor Linux (o entorno WSL/VM local si estás desarrollando).

2. Ve al directorio del script y dales permisos de ejecución:

   cd scripts/
   chmod +x install.sh

3. Ejecuta el script como administrador (root):

   sudo ./install.sh

   Nota: Este script instalará automáticamente las dependencias, configurará e iniciará Nginx, y activará el Firewall (UFW) cerrando todo menos lo esencial.

2. Conectar al Mundo Exterior (Cloudflare Tunnel)

Para que puedas acceder desde cualquier parte de internet sin abrir los puertos de tu router:

1. Autentica el daemon de Cloudflare (instalado en el paso anterior) con tu cuenta:

   sudo cloudflared tunnel login

2. Crea el túnel dedicado para el streaming:

   sudo cloudflared tunnel create privastream

3. Rutéalo a tu dominio:

   sudo cloudflared tunnel route dns privastream midominio.com

4. Pon a correr el túnel apuntando a Nginx (Localhost puerto 8080):

   cloudflared tunnel run --url http://127.0.0.1:8080 privastream

(Opcional: Si deseas que el túnel inicie automáticamente al encender el servidor, puedes instalarlo como servicio con sudo cloudflared service install)

3. Levantar tus Servicios (Backend / Frontend)

Todo el tráfico que entra a tu servidor de forma segura ahora es manejado por Nginx.

• Nginx espera que tu Backend/API esté corriendo en el puerto 3000 interno (http://127.0.0.1:3000). Todas las peticiones a midominio.com/api irán directo a tu código.
• Nginx servirá los archivos estáticos subidos a /media desde la carpeta /var/www/privastream/media/.

Si vas a desarrollar, recuerda instalar dependencias en ambas carpetas (npm install).

---

🛠️ Configuración Técnica

Variables de Entorno (.env)

Copia el archivo .env.example a .env y ajusta los valores:

• SERVER_PORT: Puerto donde corre el backend (defecto: 3000).
• MEDIA_UPLOAD_PATH: Ruta absoluta en Linux donde se guardan los videos (defecto: /var/www/privastream/media).
• ALLOWED_HOSTS: Dominios autorizados para evitar ataques de Host-Header.

🧪 Ejecución de Pruebas

Contamos con una suite de pruebas básicas en la carpeta /tests.

• Backend: python -m unittest discover -s tests -p "backend_test.py"
• Frontend: npm test (ver configuración en carpeta frontend).

---

🆘 Troubleshooting (Solución de Problemas)

Problema	Causa Probable	Solución
Error 502 Bad Gateway	El Backend de Node.js no está encendido o usa el puerto incorrecto.	Asegura que el backend corre en el puerto 3000 y que .env está cargado.
Permission Denied en subidas	El servidor Node no tiene permisos de escritura en /var/www/privastream/media.	Ejecuta el script install.sh y reinicia tu sesión de usuario para aplicar el grupo www-data.
Videos no se reproducen	Nginx no encuentra los archivos en la ruta del alias.	Verifica que MEDIA_UPLOAD_PATH en el backend coincida exactamente con la ruta en nginx/conf.d/privastream.conf.
Túnel no conecta	Token de Cloudflare expirado o firewall bloqueando salida.	Ejecuta cloudflared tunnel status para diagnosticar.