Ir para o conteúdo

Hospedagem própria

FFmpeg, codecs e licenças

Qual FFmpeg o produto inclui, como ele é encontrado e verificado, e quais são os termos de licença.

Última atualização:

O que você vai aprender#

  • qual compilação do FFmpeg a imagem traz (os arquivos de release e os instaladores não trazem nenhuma), e onde está o seu código-fonte;
  • como o produto encontra um FFmpeg e recusa um arriscado;
  • quais obrigações acompanham a compilação LGPL.

A ideia#

O Vukem Video executa o FFmpeg apenas como um processo separado. Ele nunca o vincula, e os pixels de um quadro são compostos em Go. O FFmpeg que a imagem de contêiner traz é uma compilação LGPL fixada do BtbN FFmpeg-Builds, baixada pela sua URL exata e verificada por SHA-256 quando a imagem é construída. Ele é configurado sem --enable-gpl e sem --enable-nonfree, e a construção falha se qualquer um dos dois aparecer na linha de configuração. O produto não inclui nenhum componente GPL.

O fixador desta versão:

ItemValor
Versão do FFmpegn9.0.2-39-g7adfbe40dc-20261031
Tag da versão da compilaçãoautobuild-2026-10-31-12-59
Commit dos scripts de compilação5031c6f1082414e53688d39e521849905071070d
Código-fonte correspondente do FFmpegarquivo do código-fonte do FFmpeg

O texto da licença, a linha de configuração e esses links de código-fonte estão dentro da imagem, em /usr/share/doc/vukem-video/ffmpeg/ (LICENSE.txt, configure.txt e SOURCE.txt). Os pacotes da base Debian estão listados com as suas licenças em /usr/share/doc/vukem-video/base-image-packages.txt.

Como um FFmpeg é encontrado#

A ordem é fixa:

  1. VUKEM_VIDEO_FFMPEG e VUKEM_VIDEO_FFPROBE. Quando VUKEM_VIDEO_FFMPEG está definido e é inutilizável, o servidor informa E_FFMPEG_MISSING; ele nunca recorre a outro, porque você pediu aquele binário. Ambos precisam ser caminhos absolutos para arquivos.
  2. O FFmpeg ao lado do programa (incluído).
  3. O PATH.

O ffprobe vem do mesmo diretório do ffmpeg. O produto é testado no FFmpeg 9.0.2; outra versão é aceita com um aviso e uma versão abaixo de 7 é informada como antiga. Um codificador, filtro ou muxer necessário que esteja ausente é E_FFMPEG_MISSING.

A licença da compilação escolhida é classificada pela sua linha de configuração como lgpl, gpl ou nonfree. Uma compilação incluída precisa ser lgpl. A sua própria compilação pode ser GPL, o que é aceitável para o seu uso pessoal mas não para algo que você distribui, e o libx264 só é usado se você definir VUKEM_VIDEO_ALLOW_USER_X264=true.

Início rápido#

Terminal
vukem-video doctor --full
vukem-video doctor --verify

O doctor --full executa todas as verificações e imprime a versão do FFmpeg, a sua classe de licença e os codificadores H.264 encontrados. O --verify recalcula os digests do FFmpeg e dos auxiliares baixados. Ele só informa "matches the release" para o FFmpeg fixado (o da imagem, ou o par fixado que você coloca ao lado do programa); qualquer outro FFmpeg aparece como "your own build, not compared".

Erros comuns#

  • Definir VUKEM_VIDEO_FFMPEG como um caminho relativo ou um diretório: recusado na inicialização como um caminho de FFmpeg inválido.
  • Distribuir o seu próprio FFmpeg GPL dentro de uma imagem que você publica.
  • Esperar que o FFmpeg consiga alcançar a rede. Ele nunca recebe um endereço de rede, e no Linux VUKEM_VIDEO_SANDBOX=bwrap faz o sistema operacional impor isso.

Próximos passos#