Invidious: interfaz, rutas multimedia y responsabilidad operativa
Desplegar Invidious: Compose de desarrollo frente al sistema de producción con companion
Prepara la composición documentada de tres servicios, separa claves y datos persistentes y comprueba más que la página inicial.
Qué aprenderás
- Selecciona la composición correcta antes de arrancar
- Configura deliberadamente conexiones privadas y estado
- Define aceptación y recuperación
Antes de empezar
- Conceptos básicos de HTTP y contenedores
- Distinguir estado de aplicación y tráfico multimedia
Explicar dependencias y confianza, preparar una prueba verificable e interpretar evidencia sin exagerar su alcance.
Conclusiones clave
- El Compose raíz y la guía de producción son artefactos diferentes.
- Separa las claves HMAC y companion y haz coincidir los extremos companion.
- Acepta una versión mediante estado y reproducción, no solo una portada.
Selecciona la composición correcta antes de arrancar
El docker-compose.yml de la raíz advierte que está pensado para desarrollo y compila la aplicación local. Su ejemplo de dos servicios no es la receta de producción de la guía, que incluye una imagen de aplicación en Quay, otra de companion y PostgreSQL. La guía también advierte que la reproducción no funcionará sin companion configurado en el entorno de desarrollo.
Prepara Docker Engine y Compose V2 en un entorno controlado. Fija la fuente de los archivos de inicialización de la base de datos y revisa la receta de producción en la revisión documental citada. El ejemplo emplea etiquetas latest mutables: registra y fija los resúmenes de las imágenes que realmente valides. Fijar la cita de un artículo no convierte una etiqueta mutable en un despliegue reproducible.
Configura deliberadamente conexiones privadas y estado
La aplicación necesita parámetros PostgreSQL, inicialización de tablas, private_url de companion, una clave companion y otra HMAC. La documentación solicita claves distintas; la referencia exige exactamente dieciséis caracteres para la clave companion. El secreto del servidor companion debe coincidir con esa clave, no con la clave HMAC de firma. Sustituye también las credenciales de ejemplo de la base de datos de forma coherente en ambos extremos.
Conserva el volumen de base de datos y el montaje de caché documentado para companion. Mantén privados sus puertos salvo que otra topología revisada justifique exponerlos. La receta sencilla enlaza la interfaz a 127.0.0.1:3000 para un proxy inverso de entrada. Configura domain, external_port y https_only según ese acceso; activar https_only no sustituye una terminación TLS real.
Define aceptación y recuperación
Valida la sintaxis de Compose sin imprimir secretos resueltos y arranca la composición revisada en una prueba no productiva. Comprueba disponibilidad de la base de datos, ruta stats, un vídeo conocido permitido, preferencias y recuperación controlada de estado. El endpoint stats es una sonda del servicio, no una garantía conjunta de companion, acceso al proveedor y reproducción en el navegador.
Respalda los datos antes de cambios y conserva los resúmenes anteriores de aplicación y companion. Separa la compatibilidad de la base de datos del retroceso de imágenes y ensaya la restauración en lugar de borrar volúmenes. Las estimaciones de recursos de la guía no miden tu carga real. Para este artículo no se instaló Invidious, generaron secretos, migraron bases de datos ni probaron vídeos.
Pasos de implementación
- 1
Revisa la composición de producción en la guía fijada.
- 2
Selecciona resúmenes de imágenes verificados y conexiones privadas.
- 3
Sustituye credenciales y conserva montajes de datos y caché.
- 4
Valida, prueba en un entorno controlado y ensaya la restauración.
Ejemplo para copiar
# Solo en tu directorio de despliegue Invidious ya revisado.
# Estos comandos inspeccionan; no instalan ni arrancan servicios.
docker compose version
docker compose config --quiet
docker compose ps
curl --fail --max-time 10 http://127.0.0.1:3000/api/v1/statsPreguntas frecuentes
¿Puedo tratar el Compose del repositorio como receta de producción?
No. El archivo raíz declara su finalidad de desarrollo; la guía fijada proporciona otra composición con companion.
¿Una respuesta stats correcta prueba la reproducción?
No. Faltan una prueba autorizada de reproducción completa y comprobaciones separadas del estado persistente.
Fuentes
- invidious/docker-compose.ymlFuente verificada 2026-09-08
- invidious/config/config.example.ymlFuente verificada 2026-09-08
- documentation/docs/installation.mdFuente verificada 2026-09-08