🐚 docker-shell

Um script bash leve e sem dependências que oferece um shell interativo emulado dentro de um contêiner Docker — usando apenas curl, dd, od e awk. Sem Python, sem jq, sem editor necessário.

Desenvolvido para ambientes onde você só tem acesso bruto ao shell e precisa executar comandos dentro de um contêiner Docker por meio da Docker Engine API.

---

🧠 Como Funciona

Em vez de usar a CLI do Docker, este script fala diretamente com a REST API da Docker Engine via HTTP (normalmente exposta em http://192.168.65.7:2375 em ambientes Docker Desktop / WSL2).

Ele:

1. Cria e inicia um contêiner Alpine Linux com sua unidade C:\ do Windows montada
2. Para cada comando que você digita, cria uma instância exec via API
3. Analisa a saída do fluxo binário multiplexado do Docker usando apenas dd + od — sem necessidade de Python
4. Exibe o resultado de volta no seu terminal como um shell real

Fluxo Multiplexado do Docker

O Docker envolve toda a saída exec em um formato de enquadramento binário:

[1 byte: stream type] [3 bytes: padding] [4 bytes: payload size (big-endian)] [payload...]

Este script decodifica esse quadro a quadro usando apenas ferramentas Unix padrão.

---

⚙️ Requisitos

• bash
• curl
• dd, od, awk, grep, cut — todas ferramentas Unix padrão
• Docker Engine API acessível em http://192.168.65.7:2375 (Docker Desktop no WSL2)

Sem jq, sem Python, sem nano, sem editor.

---

🚀 Instalação

git clone https://github.com/yourusername/docker-shell.git
cd docker-shell
chmod +x docker_shell.sh
bash docker_shell.sh

---

💻 Uso

================================================
  Docker Emulated Shell  [target: alpine_escape]
  Commands: start | status | run <cmd> | exit
================================================

docker> start
docker> status
docker> run ls /mnt
docker> run ls /mnt/Users
docker> run cat /etc/os-release
docker> run id
docker> exit

Comandos

Comando	Descrição
start	Cria (se necessário) e inicia o contêiner alpine_escape
status	Mostra o ID do contêiner e o estado atual
run <cmd>	Executa qualquer comando de shell dentro do contêiner
exit / quit	Sai do shell emulado

---

🗂️ Layout de Montagem

O contêiner monta sua unidade C:\ do Windows (via WSL2) em /mnt:

Caminho do Windows	Dentro do Contêiner
C:\	/mnt
C:\Users	/mnt/Users
C:\Program Files	/mnt/Program Files
C:\Windows\System32	/mnt/Windows/System32

---

⚠️ Notas

• Cada run é uma instância exec separada — o estado não persiste entre comandos. Use run cd /some/dir && ls para encadear comandos em uma única chamada.
• O script localiza o contêiner pelo nome (alpine_escape), não pelo ID, para não executar acidentalmente no contêiner errado.
• A saída é analisada diretamente do arquivo binário /tmp/docker_out.bin usando dd quadro a quadro.

---

🔧 Configuração

Edite estas variáveis no topo do script para adequar ao seu ambiente:

DOCKER="http://192.168.65.7:2375"   # Docker Engine API address
CONTAINER="alpine_escape"            # Container name

---

📄 Licença

AGPLv3