aprendendolinux/debian-slim repository overview

⁠aprendendolinux/debian-slim

Esta imagem Docker fornece um ambiente Debian 12 Slim com um servidor SSH configurado para acesso remoto, ferramentas de rede e desenvolvimento, e um diretório mapeado para compartilhamento de arquivos. É ideal para testes, desenvolvimento, administração de sistemas ou aprendizado de Linux em um ambiente leve e isolado.

⁠Visão Geral

A imagem aprendendolinux/debian:latest é baseada em debian:12-slim, oferecendo:

• Servidor SSH para acesso remoto seguro.
• Ferramentas como git, vim, tcpdump, rsync, mariadb-client, e mais.
• Configuração de fuso horário via variável de ambiente TZ.
• Senha do usuário root configurável via ROOT_PASSWORD.
• Diretório /var/www/html mapeado para compartilhamento de arquivos.

⁠Tags Disponíveis

• latest: Versão mais recente da imagem, baseada em debian:12-slim.

⁠Pré-requisitos

• Docker⁠ (versão 20.10 ou superior).
• Docker Compose⁠ (opcional, para uso com docker-compose.yml).
• Cliente SSH (ex.: OpenSSH, PuTTY).
• Pelo menos 512 MB de RAM e espaço em disco para o volume mapeado.

⁠Como Usar

⁠Puxando a Imagem

Puxe a imagem do Docker Hub:

docker pull aprendendolinux/debian:latest

⁠Executando o Contêiner

Use o comando abaixo para iniciar o contêiner, substituindo SUA_SENHA por uma senha segura:

docker run -d \
  --name debian \
  -p 2222:22 \
  -e ROOT_PASSWORD=SUA_SENHA \
  -e TZ=America/Sao_Paulo \
  -v /srv/debian:/var/www/html \
  aprendendolinux/debian:latest

⁠Usando Docker Compose

1. Crie um arquivo docker-compose.yml:

   services:
     debian:
       container_name: debian
       hostname: debian
       image: aprendendolinux/debian:latest
       restart: always
       environment:
         - ROOT_PASSWORD=SUA_SENHA
         - TZ=America/Sao_Paulo
       volumes:
         - /srv/debian:/var/www/html
       ports:
         - "2222:22"
   

   Copy
2. Certifique-se de que o diretório /srv/debian existe:

   mkdir -p /srv/debian
   

   Copy
3. Inicie o contêiner:

   docker-compose up -d
   

   Copy

⁠Acessando via SSH

Conecte-se ao contêiner:

ssh root@localhost -p 2222

Use a senha definida em ROOT_PASSWORD.

⁠Configuração

⁠Variáveis de Ambiente

• ROOT_PASSWORD: Senha do usuário root para acesso SSH (ex.: Sua_Senha_Segura). Obrigatório.
• TZ: Fuso horário do contêiner (ex.: America/Sao_Paulo).

⁠Volumes

• /srv/debian:/var/www/html: Mapeia o diretório local /srv/debian para /var/www/html no contêiner, permitindo compartilhamento de arquivos.

⁠Portas

• 2222:22: Mapeia a porta 2222 do host para a porta 22 (SSH) do contêiner.

⁠Ferramentas Instaladas

• openssh-server: Servidor SSH.
• rsync: Sincronização de arquivos.
• sshpass: Automação de login SSH.
• mariadb-client: Cliente para bancos MariaDB/MySQL.
• git: Controle de versão.
• net-tools: Ferramentas como ifconfig e netstat.
• iputils-ping: Testes de conectividade.
• telnet: Testes de conexão.
• tcpdump: Análise de pacotes de rede.
• vim: Editor de texto.
• tzdata: Suporte a fuso horário.

⁠Exemplos de Uso

⁠Sincronização de Arquivos com rsync

Sincronize arquivos do diretório mapeado para um servidor remoto:

ssh root@localhost -p 2222
rsync -avz /var/www/html/ usuario@servidor_remoto:/destino/

⁠Captura de Pacotes com tcpdump

Capture pacotes de rede:

ssh root@localhost -p 2222
tcpdump -i eth0 -w /var/www/html/captura.pcap

O arquivo captura.pcap estará disponível em /srv/debian no host.

⁠Conexão a Banco de Dados

Conecte-se a um banco MariaDB/MySQL:

ssh root@localhost -p 2222
mariadb -h host_do_banco -u usuario -p

⁠Personalização

• Mudar a Senha: Ajuste ROOT_PASSWORD no comando docker run ou no docker-compose.yml.
• Alterar Fuso Horário: Modifique TZ (ex.: Europe/Lisbon).
• Mudar Porta SSH: Altere o mapeamento de portas (ex.: -p 3333:22).
• Adicionar Pacotes: Edite o Dockerfile (disponível no repositório⁠) e reconstrua a imagem.

⁠Boas Práticas

• Use senhas fortes para ROOT_PASSWORD.
• Restrinja o acesso à porta 2222 com um firewall.
• Monitore os logs com docker logs debian.
• Mantenha o diretório /srv/debian com permissões seguras (chmod 700 /srv/debian).

⁠Segurança

• Chaves SSH: Considere configurar chaves SSH em vez de senhas. Adicione sua chave pública a /root/.ssh/authorized_keys no Dockerfile.
• Firewall: Limite o acesso à porta 2222 a IPs confiáveis.
• Senhas Seguras: Evite expor ROOT_PASSWORD em logs ou repositórios públicos.

⁠Solução de Problemas

• Erro de conexão SSH:
  • Verifique a porta 2222: netstat -tuln | grep 2222.
  • Confirme ROOT_PASSWORD nos logs: docker logs debian.
• Contêiner não inicia:
  • Verifique o diretório /srv/debian: ls -ld /srv/debian.
  • Veja os logs: docker logs debian.
• Timezone incorreto:
  • Confirme a variável TZ e reinicie: docker-compose restart.

⁠Suporte

Para problemas ou sugestões, abra uma issue no repositório: https://github.com/AprendendoLinux/debian-slim/⁠.

⁠Licença

Licenciado sob a MIT License⁠.