Skip to content

Containers Docker Servidor

O Gerenciador de Containers é a central de operações Docker do RoqueOS. Instale aplicações da App Store com um clique, importe containers via docker run ou docker-compose.yml, gerencie ciclo de vida, visualize logs em tempo real e acesse interfaces web de containers pelo proxy reverso integrado.

App Store com catálogo de containers


Formas de Instalar Containers

O RoqueOS oferece quatro formas de criar containers, do mais simples ao mais avançado:

1. App Store (Um Clique)

A forma mais fácil. O catálogo possui dezenas de apps populares pré-configurados:

  1. Abra o Gerenciador de Containers no Launchpad
  2. Na aba App Store, navegue pelo catálogo ou use a busca
  3. Clique em Instalar no app desejado
  4. Aguarde o download da imagem e a criação do container

Instalando um app da App Store

Veja o catálogo completo da App Store para a lista de apps disponíveis.


2. Importar via Docker Run

Já tem um comando docker run pronto? Cole diretamente no RoqueOS:

Importação via Docker CLI

  1. No Gerenciador de Containers, clique em + Novo Container
  2. Selecione a aba Docker Run
  3. Cole o comando completo, por exemplo:
bash
docker run -d \
  --name meu-nginx \
  -p 8080:80 \
  -v /app/disks/Sites:/usr/share/nginx/html \
  nginx:latest
  1. O RoqueOS interpretará automaticamente o comando e criará o container com todas as configurações (portas, volumes, variáveis de ambiente).

3. Importar via Docker Compose

Para configurações mais complexas com múltiplos serviços:

Importação via Docker Compose

  1. Clique em + Novo Container
  2. Selecione a aba Docker Compose
  3. Cole o conteúdo do seu docker-compose.yml:
yaml
version: '3.8'
services:
  wordpress:
    image: wordpress:latest
    ports:
      - '8081:80'
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wp
      WORDPRESS_DB_PASSWORD: secret
    volumes:
      - wp_data:/var/www/html

  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: rootsecret
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wp
      MYSQL_PASSWORD: secret
    volumes:
      - db_data:/var/lib/mysql

volumes:
  wp_data:
  db_data:
  1. O RoqueOS criará e iniciará todos os serviços definidos no compose.

4. Criação Manual

Para controle total sobre todos os parâmetros:

  1. Clique em + Novo Container
  2. Selecione a aba Manual
  3. Configure cada campo individualmente:
    • Imagem — Nome da imagem Docker (ex: nginx:latest)
    • Nome — Nome do container
    • Portas — Mapeamento de portas (host:container)
    • Volumes — Mapeamento de volumes
    • Variáveis de Ambiente — Chave-valor
    • Restart Policy — Política de reinício automático

Gerenciando Containers

Painel de Containers Instalados

Lista de containers instalados

A aba Meus Apps mostra todos os containers com status em tempo real:

AçãoDescrição
▶️ IniciarInicia um container parado
⏹️ PararPara um container em execução
🔄 ReiniciarReinicia o container
🗑️ RemoverRemove o container e opcionalmente seus dados
⚙️ ConfigurarEdite portas, volumes e variáveis de ambiente

Logs em Tempo Real

Visualize os logs de qualquer container em tempo real:

Logs de container em tempo real

  1. Clique no container desejado
  2. Selecione a aba Logs
  3. Os logs são atualizados automaticamente via streaming

Terminal do Container

Acesse o shell de qualquer container diretamente pelo RoqueOS:

  1. Clique no container desejado
  2. Selecione a aba Terminal
  3. Você terá acesso ao shell do container (geralmente bash ou sh)

Proxy Reverso Integrado

O RoqueOS possui um proxy reverso integrado que permite acessar a interface web de qualquer container diretamente pelo navegador, sem precisar expor portas adicionais.

Acesso via proxy reverso

Como Usar

  1. Após instalar um container que tenha interface web (ex: qBittorrent, Grafana, Portainer)
  2. Na lista de containers, clique no botão 🌐 Abrir
  3. A interface web do container abrirá dentro do Navegador Remoto do RoqueOS

Interface web de container no navegador

Isso elimina a necessidade de abrir portas no firewall para acessar dashboards de containers.


Configuração Avançada

Editar Container

Edição de configuração do container

Após a criação, você pode editar qualquer container:

  • Portas — Adicionar ou remover mapeamentos de porta
  • Volumes — Alterar volumes montados
  • Variáveis de Ambiente — Adicionar, editar ou remover variáveis
  • Restart Policy — Alterar política de reinício
  • Limites de Recursos — Definir limites de CPU e memória

Atualizar Imagem

Para atualizar um container para a versão mais recente da imagem:

  1. Na lista de containers, clique em ⚙️ Configurar
  2. Clique em Atualizar Imagem
  3. O RoqueOS baixará a versão mais recente e recriará o container

Dicas de Uso

DICAS RÁPIDAS

  • Containers com restart: unless-stopped reiniciam automaticamente com o servidor
  • Use volumes em /app/disks/ para que os dados fiquem visíveis no Finder
  • O proxy reverso funciona mesmo sem Cloudflare Tunnels (acesso local)
  • Monitore recursos com o Monitor do Sistema para evitar sobrecarregar o servidor

RECURSOS DO SERVIDOR

Cada container consome RAM e CPU do servidor. Monitore o uso de recursos e remova containers que não esteja usando. Para servidores com menos de 4 GB de RAM, limite-se a 3-5 containers leves.

Lançado sob a Licença MIT.