Configurações do streamer¶

Um streamer não tem configuração própria: o central a guarda e a entrega à máquina. O formulário de configurações mora no pé do cartão do streamer — abra-o do registro com um clique na linha.

Como as mudanças se aplicam¶

O botão Salvar alterações envia só o que você mudou — edições paralelas de outras seções não são atropeladas. Dali, uma trilha de três indicadores acompanha a entrega:

• Salvo — o central aceitou as mudanças.
• Em trânsito — a configuração está a caminho do streamer; o indicador pulsa. Se o streamer está offline, o formulário diz na cara: as configurações se aplicarão quando o enlace voltar.
• Aplicado — o streamer confirmou a aplicação; ao lado — quantos segundos a entrega levou.

Se as configurações foram alteradas em paralelo com você, o formulário mostra um aviso de conflito com uma escolha: Ver as mais recentes — reler a versão alheia, Sobrescrever — insistir na sua.

Um selo amarelo ENV num campo significa que o valor é definido pelo ambiente da própria máquina: ele pesa mais que o entregue pelo central, e editar o formulário não terá efeito neste streamer até a variável ser removida.

Listeners¶

As portas que o streamer abre por protocolo: HTTP, RTSP, RTMP, WebRTC. Uma porta é adicionada como chip; um chip marcado tls significa que a porta leva certificado.

Certificados e HTTPS¶

A seção Certificados pendura TLS nos listeners HTTP — o certificado mora numa porta, então primeiro vem o listener. O botão Ativar HTTPS faz as duas coisas de uma vez: um listener na 443 e uma entrada Let's Encrypt nele. Uma porta pode levar várias entradas: os clientes escolhem o certificado por SNI.

A fonte do certificado de uma entrada:

• Let's Encrypt — emissão automática para os domínios listados. Ao lado aparece o E-mail de contato ACME, e ele é obrigatório: sem ele nada é emitido e o salvamento fica bloqueado, e é para ele que o CA manda avisos de expiração. Em Avançado ficam a URL do diretório ACME e a chave da CA de teste — uma URL vazia é o Let's Encrypt de produção.
• PEM estático — seu próprio certificado e chave privada: PEM inteiro ou caminho de um arquivo no streamer.
• Autoassinado — para bancadas e redes internas.

Os domínios vão separados por vírgula; o formulário sugere o hostname dos endereços de entrega do streamer. ACME não emite para um IP pelado — é preciso um domínio.

O estado da emissão aparece ao lado da própria entrada, e se repete acima no cartão do streamer: emitido (com o prazo até expirar), emitindo, falhou — com o texto do erro. Duas semanas antes de expirar a linha amarela.

O caminho completo, com os pré-requisitos e as razões de a emissão travar — Certificado HTTPS.

DVR¶

Onde o streamer grava o arquivo: a Raiz do arquivo, a lista de discos quando há vários e o Caminho do catálogo. O interruptor Verificar montagem antes de gravar vem ligado por padrão: gravar na partição raiz do sistema é proibido, e um disco sem montagem própria é reportado «não montado». Desligue-o só de propósito.

A raiz do arquivo é a base dos caminhos relativos e a casa do catálogo de metadados, não um disco de gravação: sem nenhum disco na lista não há onde gravar o arquivo, e o streamer reporta um erro de gravação honesto em vez de gravar em silêncio na raiz.

Discos de cache¶

A segunda lista são os Discos de cache. São discos com outro papel: neles assenta o arquivo remoto que o streamer leu de um origin, para que uma solicitação repetida seja servida localmente. A gravação ao vivo nunca os escolhe, a retenção de streams não os governa, e o espaço é liberado por despejo segundo a última leitura. É assim que um streamer vira um edge.

Cada disco de cache tem dois limites opcionais:

• Limite de cache, GiB — quanto o cache pode ocupar; vazio significa limitado apenas pelo espaço livre.
• Manter livre, GiB — quanto espaço deixar no volume; vazio significa o mínimo do sistema.

O mesmo caminho não pode constar ao mesmo tempo como disco de arquivo e como disco de cache — ao salvar, essa configuração é rejeitada.

Abaixo está a admissão no cache, comum a todo o cache do streamer:

• Janela fresca, horas — os fragmentos mais novos são cacheados na primeira solicitação; vazio significa um dia.
• Conteúdo antigo: número da solicitação — a partir de qual repetição um fragmento mais antigo que esse limite é cacheado; vazio significa a segunda, 1 significa de imediato.

A razão da divisão é simples: quase todos veem a cauda fresca do arquivo e apenas alguns a sua profundidade, então um único salto para trás não deve despejar o que é popular.

Um streamer sem discos de cache não quebra por causa de um stream com cache ativado: o cache simplesmente não funciona e um aviso vai para o log.

O volume do cache e a taxa de acertos aparecem na seção DVR do cluster; a mecânica completa do cache está na documentação do Sapsan.

A gravação e o visionamento do arquivo em detalhe — a página de DVR.

VOD¶

A seção VOD define os roots VOD que o nó serve e nos quais aceita uploads. Sem ao menos um root, o Catálogo VOD fica vazio: não há para onde enviar.

Cada root tem um Nome do root e um Caminho, além do ajuste fino: Máx. de arquivos abertos, Idle timeout, s, Máx. de handles de leitura; e à parte um Máx. global de arquivos abertos para o nó inteiro.

O nome não é um rótulo, e sim parte da disposição em disco, então renomear um root não é suportado. Escolha desde o início o nome que vai permanecer.

Um erro de digitação no nome de um campo é recusado ao salvar: 422 com o caminho até o campo — por exemplo unknown field "vod.root" se você escrever root em vez de roots.

Prefixos de publicação¶

Os prefixos de nomes sob os quais o streamer aceita publicações entrantes. Sem prefixos, a publicação é aceita só em streams existentes.

Conexão e entrega¶

• URL da API do streamer — o endereço pelo qual o central alcança o management API da máquina. Sem ele o streamer leva um chip de alcance no registro e suas sessões somem da saída.
• Zona CDN — a qual zona o streamer pertence; a frente de reprodução direciona os espectadores por ela.
• URL pública de payload — a base pública de endereços para espectadores. Definida — os reprodutores recebem um redirect direto ao streamer; vazia — o central faz proxy da mídia através de si.
• URL privada de payload — a base para transferências entre streamers e o proxy; por padrão coincide com a URL da API.

O modo de entrega resultante aparece no cartão do streamer: em processo (o streamer local), redirect, proxy pelo central ou inalcançável — em vermelho quando nada está definido. Um aviso à parte aparece quando há certificado emitido para um nome mas a base de entrega segue em http:// — o TLS fica sem uso.

Reverse proxy e restauração¶

A seção Reverse proxy (JSON) é um editor temporário da seção crua rproxy; JSON inválido bloqueia o salvamento.

O botão Restaurar padrões na zona de perigo devolve todas as configurações do streamer aos valores padrão — o streamer as aplica no próximo sync. A ação é irreversível.