spoke-piped
Módulo Spoke para Piped que habilita reproducción adaptativa en YouTube mediante un resolver local y gestión segura de secretos, ideal para despliegues autoalojados con Traefik.
Ficha actualizada 28 sept 2026, 0:42 · upstream 28 sept 2026, 0:33 · release v1.0.0
Qué es spoke-piped
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un módulo para la plataforma Piped, una alternativa a YouTube centrada en la privacidad. Incluye servicios clave como el backend Java, frontend estático, proxy de segmentos en Rust y una base de datos PostgreSQL local. La característica principal es el servicio piped-resolver, que utiliza FastAPI y yt-dlp para recuperar streams adaptativos (1080p/4K), superando las limitaciones del token SABR de YouTube que restringen la calidad en el backend estándar.
El despliegue requiere un hub Spoke con red Troxy y configuración DNS específica para subdominios separados (frontend, API, proxy). La arquitectura es modular, permitiendo mantener componentes internos como piped-bgutil sin exponerlos públicamente. Se gestiona la seguridad mediante secretos externos para contraseñas de base de datos y claves de firma de URLs.
Los recursos recomendados son 2 núcleos CPU, 2GB RAM y 20GB de disco. El sistema soporta integración con clientes como LibreTube y Piped Web, manteniendo la compatibilidad con la API existente mientras mejora la experiencia de reproducción.
- Autoalojamiento de frontend Piped para usuarios que priorizan la privacidad
- Mejora de calidad de video adaptativa (1080p/4K) evitando restricciones SABR de YouTube
- Integración directa con clientes como LibreTube y Piped Web sin cambios en el cliente
- Gestión segura de sesiones mediante proxy de segmentos firmado con HASH_SECRET
- Despliegue modular en infraestructura Spoke con red Troxy
- Implementación de piped-resolver para obtener streams adaptativos completos sin limitaciones del backend estándar
- Arquitectura modular con Traefik que separa frontend, API y proxy en subdominios distintos
- Base de datos PostgreSQL local independiente que no depende del hub central
- Proxy seguro de segmentos en Rust con validación de firma BLAKE3 para evitar abuso
- Soporte nativo para múltiples clientes compatibles como LibreTube y Piped Web
- Dependencia obligatoria del hub Spoke y red Troxy para el despliegue
- Configuración DNS compleja que requiere subdominios específicos (frontend, API, proxy)
- Reconstrucción manual del contenedor frontend necesaria al cambiar el subdominio de la API
- Gestión manual de secretos externos para contraseñas y claves de firma
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere 2 núcleos CPU y 2GB RAM. Generar secretos para Postgres y hash de proxy antes del despliegue. Asegurar que el frontend se reconstruya si cambia el subdominio API. Configurar DNS con tres registros o wildcard. Usar imágenes pinadas por digest en modules.yml para despliegues reproducibles.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.