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:
| Item | Valor |
|---|---|
| Versão do FFmpeg | n9.0.2-39-g7adfbe40dc-20261031 |
| Tag da versão da compilação | autobuild-2026-10-31-12-59 |
| Commit dos scripts de compilação | 5031c6f1082414e53688d39e521849905071070d |
| Código-fonte correspondente do FFmpeg | arquivo 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:
VUKEM_VIDEO_FFMPEGeVUKEM_VIDEO_FFPROBE. QuandoVUKEM_VIDEO_FFMPEGestá definido e é inutilizável, o servidor informaE_FFMPEG_MISSING; ele nunca recorre a outro, porque você pediu aquele binário. Ambos precisam ser caminhos absolutos para arquivos.- O FFmpeg ao lado do programa (incluído).
- 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#
vukem-video doctor --full
vukem-video doctor --verifyO 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_FFMPEGcomo 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=bwrapfaz o sistema operacional impor isso.