Configuración del streamer¶
Un streamer no tiene configuración propia: central la guarda y la entrega a la máquina. El formulario de configuración vive al pie de la ficha del streamer — ábralo desde el registro con un clic en la fila.
Cómo se aplican los cambios¶
El botón Guardar cambios envía solo lo que usted cambió — las ediciones paralelas de otras secciones no se pisan. Desde ahí, una traza de tres indicadores sigue la entrega:
- Guardado — central aceptó los cambios.
- En vuelo — la configuración va camino del streamer; el indicador pulsa. Si el streamer está offline, el formulario lo dice sin rodeos: la configuración se aplicará cuando vuelva el enlace.
- Aplicado — el streamer confirmó la aplicación; al lado — cuántos segundos tomó la entrega.
Si la configuración se cambió en paralelo con usted, el formulario muestra un cartel de conflicto con una elección: Ver la más reciente — releer la versión ajena, Sobrescribir — insistir en la suya.
Una insignia amarilla ENV en un campo significa que el valor lo fija el entorno de la propia máquina: pesa más que lo entregado por central, y editar el formulario no tendrá efecto en este streamer hasta quitar la variable.
Listeners¶
Los puertos que el streamer abre por protocolo: HTTP, RTSP, RTMP, WebRTC. Un puerto se añade como chip; un chip marcado tls significa que el puerto lleva certificado.
Certificados y HTTPS¶
La sección Certificados cuelga TLS de los listeners HTTP — el certificado vive en un puerto, así que primero hace falta el listener. El botón Activar HTTPS hace ambas cosas de una vez: un listener en 443 y una entrada de Let's Encrypt en él. Un puerto puede llevar varias entradas: los clientes eligen el certificado por SNI.
La fuente del certificado de una entrada:
- Let's Encrypt — emisión automática para los dominios listados. Justo al lado aparece el Correo de contacto ACME, y es obligatorio: sin él no se emite nada y el guardado se bloquea, y a él el CA envía los avisos de expiración. Bajo Avanzado están la URL del directorio ACME y el interruptor del CA de pruebas — una URL vacía es el Let's Encrypt de producción.
- PEM estático — su propio certificado y clave privada: PEM completo o ruta a un archivo en el streamer.
- Autofirmado — para bancos de pruebas y redes internas.
Los dominios van separados por comas; el formulario sugiere el hostname de las direcciones de entrega del streamer. ACME no emite para una IP pelada — hace falta un dominio.
El estado de la emisión se ve junto a la propia entrada, y se repite arriba en la ficha del streamer: emitido (con el plazo hasta expirar), emitiéndose, fallido — con el texto del error. Dos semanas antes de expirar la fila se pone amarilla.
El camino completo, con los requisitos y las razones por las que la emisión se atasca — Certificado HTTPS.
DVR¶
Dónde escribe el streamer el archivo: la Raíz del archivo, la lista de discos cuando hay varios y la Ruta del catálogo. El interruptor Comprobar montaje antes de escribir está activado por defecto: escribir en la partición raíz del sistema está prohibido, y un disco sin montaje propio se reporta «no montado». Desactívelo solo a conciencia.
La raíz del archivo es la base de las rutas relativas y el hogar del catálogo de metadatos, no un disco de escritura: sin ningún disco en la lista no hay dónde escribir el archivo, y el streamer reporta un error de escritura honesto en lugar de escribir en silencio en la raíz.
Discos de caché¶
La segunda lista son los Discos de caché. Son discos con otro papel: en ellos se asienta el archivo remoto que el streamer ha leído de un origin, para que una solicitud repetida se sirva localmente. La grabación en vivo nunca los elige, la retención de streams no los gobierna, y el espacio se libera por desalojo según la última lectura. Así un streamer se convierte en edge.
Cada disco de caché tiene dos límites opcionales:
- Límite de caché, GiB — cuánto puede ocupar la caché; vacío significa limitada solo por el espacio libre.
- Mantener libre, GiB — cuánto espacio dejar en el volumen; vacío significa el mínimo del sistema.
La misma ruta no puede figurar a la vez como disco de archivo y como disco de caché — al guardar, esa configuración se rechaza.
Debajo está la admisión en caché, común a toda la caché del streamer:
- Ventana fresca, horas — los fragmentos más jóvenes se cachean en la primera solicitud; vacío significa un día.
- Contenido antiguo: número de solicitud — a partir de qué repetición se cachea un fragmento más antiguo que ese límite; vacío significa la segunda,
1significa de inmediato.
La razón de la división es simple: casi todos ven la cola fresca del archivo y solo unos pocos su profundidad, así que un solo salto atrás no debe desalojar lo popular.
Un streamer sin discos de caché no se rompe por un stream con la caché activada: la caché simplemente no funciona y va un aviso al log.
El volumen de la caché y la tasa de aciertos se ven en la sección DVR del clúster; la mecánica completa de la caché está en la documentación de Sapsan.
La grabación y el visionado del archivo en detalle — la página de DVR.
VOD¶
La sección VOD define los roots VOD que el nodo sirve y en los que acepta subidas. Sin al menos un root, el Catálogo VOD se queda vacío: no hay dónde subir.
Cada root tiene un Nombre del root y una Ruta, además del ajuste fino: Máx. de archivos abiertos, Idle timeout, s, Máx. de handles de lectura; y aparte un Máx. global de archivos abiertos para todo el nodo.
El nombre no es una etiqueta sino parte de la disposición en disco, así que renombrar un root no está soportado. Elija desde el principio el nombre que va a quedarse.
Una errata en el nombre de un campo se rechaza al guardar: 422 con la ruta hasta el campo — por ejemplo unknown field "vod.root" si escribe root en lugar de roots.
Prefijos de publicación¶
Los prefijos de nombres bajo los que el streamer acepta publicaciones entrantes. Sin prefijos, la publicación se acepta solo en streams existentes.
Conexión y entrega¶
- URL de API del streamer — la dirección por la que central llega al management API de la máquina. Sin ella el streamer lleva un chip de accesibilidad en el registro y sus sesiones desaparecen de la salida.
- Zona CDN — a qué zona pertenece el streamer; el frente de reproducción dirige a los espectadores por ella.
- URL pública de payload — la base pública de direcciones para espectadores. Puesta — los reproductores reciben un redirect directo al streamer; vacía — central proxya los medios a través de sí.
- URL privada de payload — la base para transferencias entre streamers y el proxeo; por defecto coincide con la URL de API.
El modo de entrega resultante se ve en la ficha del streamer: en proceso (el streamer local), redirect, proxeado por central o inaccesible — en rojo cuando no hay nada puesto. Un aviso aparte aparece cuando hay certificado emitido para un nombre pero la base de entrega sigue en http:// — el TLS queda sin usar.
Reverse proxy y restablecimiento¶
La sección Reverse proxy (JSON) es un editor temporal de la sección cruda rproxy; un JSON inválido bloquea el guardado.
El botón Restablecer valores en la zona de peligro devuelve toda la configuración del streamer a los valores por defecto — el streamer la aplica en su siguiente sync. La acción es irreversible.