Solução da comunidade

Como executar o Firefox no Docker no CasaOS com jlesage/firefox

A December 2024 CasaOS tutorial showing how to run the jlesage/firefox Docker image with web access on port 5800 and persistent configuration stored under the container's /config path.

O tutorial original da comunidade mostra uma forma simples de executar o Firefox dentro do Docker no CasaOS e aceder ao navegador através de uma interface Web. Utiliza a imagem jlesage/firefox, associa a interface Web à porta 5800 e armazena os dados persistentes do Firefox no diretório /config do contentor.

Esta publicação original é um tutorial do CasaOS de dezembro de 2024, não um teste específico do ZimaOS. O aspeto útil é que os parâmetros Docker principais continuam a corresponder à documentação atual do projeto para jlesage/firefox.

As três definições principais do contentor

O guia da comunidade utilizou três elementos importantes:

Definições de aplicação personalizada do CasaOS para o jlesage Firefox, mostrando a porta 5800, um volume de configuração persistente, privilégios e limite de memória
A configuração original do tutorial no CasaOS utilizava jlesage/firefox, a porta 5800 no anfitrião e no contentor, e um volume do anfitrião associado a /config.
  • imagem Docker: jlesage/firefox;
  • porta do contentor para a interface Web: 5800;
  • diretório de configuração persistente dentro do contentor: /config.

O projeto original continua atualmente a documentar o mesmo modelo básico. Associa um diretório do anfitrião a /config e disponibiliza a interface do navegador através da porta 5800.

opções atuais do contentor jlesage/firefox

Porque é importante o /config

O volume /config armazena a configuração da aplicação Firefox, o estado, os registos e outros dados persistentes. Se o contentor for recriado enquanto o mesmo diretório do anfitrião continuar associado a /config, o projeto original afirma que a aplicação pode retomar com esse estado guardado.

Escolha um caminho do anfitrião adequado à sua organização de armazenamento e ao seu plano de cópias de segurança no CasaOS. O autor da fonte mencionou caminhos como /DATA/AppData/firefox, mas o caminho exato do anfitrião não é universal.

Aceder ao navegador através da porta 5800

Com o exemplo de rede bridge predefinido, a interface Web é disponibilizada na porta TCP 5800. Depois de o contentor iniciar, o projeto original descreve o acesso ao Firefox através do IP do anfitrião nessa porta.

Firefox a ser executado dentro do contentor Docker jlesage e apresentado através da sua interface Web acessível pelo navegador
O autor da fonte mostrou o Firefox a ser executado com sucesso através da interface do contentor acessível pelo navegador.

Se a porta 5800 já estiver a ser utilizada no anfitrião, associe uma porta diferente do lado do anfitrião, mantendo a porta da aplicação no lado do contentor de acordo com a documentação da imagem.

O modo privilegiado não foi estabelecido como requisito

O autor da comunidade ativou os privilégios “por precaução”. Isso não equivale a demonstrar que o modo privilegiado é necessário.

Não conceda a um contentor de navegador privilégios mais amplos sobre o anfitrião do que aqueles de que necessita. Comece pelos requisitos da imagem original e adicione capacidades extra apenas quando uma funcionalidade documentada o exigir.

A fonte utilizou um limite de memória de 1 GB

O autor definiu um limite de memória de 1024 MB e descreveu-o como suficiente para a sua utilização ligeira. Considere isto como a alocação de um utilizador, não como um mínimo universal. A utilização de memória do navegador depende bastante do número de separadores, dos sites, da reprodução de multimédia, das extensões e da duração da sessão.

A mesma imagem pode ser executada no ZimaOS?

A publicação original não testou o ZimaOS, pelo que não deve ser apresentada como prova de compatibilidade com o ZimaOS. No entanto, o ZimaOS suporta aplicações Docker personalizadas, e os mesmos parâmetros do contentor original podem ser adaptados para uma importação Docker Compose no ZimaOS, caso decida testá-los aí.

Para consultar o comportamento atual das aplicações personalizadas no ZimaOS, veja o fluxo de trabalho atual das aplicações personalizadas no ZimaOS.

Perguntas frequentes sobre o Firefox no Docker

Que imagem Docker foi utilizada pelo tutorial da comunidade?

jlesage/firefox.

Que porta disponibiliza a interface Web do Firefox?

Tanto o tutorial da comunidade como a documentação atual do projeto original utilizam a porta TCP 5800 para a interface Web.

Que caminho do contentor armazena os dados persistentes do Firefox?

/config. Associe esse caminho a um diretório persistente do anfitrião se quiser que o estado do navegador sobreviva à recriação do contentor.

Preciso do modo privilegiado?

O autor da fonte ativou-o como precaução, mas o tópico não estabeleceu que seja uma definição obrigatória. Utilize os privilégios mínimos exigidos pela sua implementação concreta.