Como usar container Docker básico em hospedagem compartilhada (com suporte SSH)
Olá, viajante do conhecimento! 👋 Seja bem-vindo ao nosso guia especial para quem quer experimentar o mundo dos containers Docker mesmo em uma hospedagem compartilhada — sim, é possível! Aqui, você vai aprender passo a passo como rodar um container simples, com segurança, sem precisar de root ou servidor dedicado. Vamos com calma, como se fosse uma conversa entre amigos no café da manhã. ☕
Antes de começar: o que é Docker e por que isso importa?
Imagine um ambiente isolado dentro do seu servidor — como uma caixinha que carrega tudo que você precisa para rodar um programa (como um site, uma API ou até um jogo). Esse é o Docker. Ele permite que você "empacote" um software com suas dependências, e rode em qualquer lugar, sem se preocupar com conflitos.
Dica do Sensei: Em hospedagem compartilhada, o Docker não é instalado por padrão, mas com acesso via SSH e algumas ferramentas básicas, você pode rodar containers simples — desde que respeite os limites da sua conta.
Pré-requisitos: o que você precisa ter
- Conta de hospedagem GeHost com acesso SSH (ativado na sua conta).
- Conexão SSH com o servidor (use um cliente como Putty ou Termius).
- Um domínio ou subdomínio apontado para a sua hospedagem.
- Conhecimento básico de comandos no terminal (não se preocupe — vamos ensinar tudo).
Passo a passo: rodando seu primeiro container Docker
1. Faça login via SSH
Abra seu terminal ou cliente SSH e conecte-se ao servidor usando suas credenciais (usuário e senha da GeHost).
Exemplo de comando:
ssh seu_usuario@seu_servidor.gehost.com.br
2. Verifique se o Docker está disponível
Em hospedagem compartilhada, o Docker não é instalado por padrão. Mas, em alguns casos, a GeHost oferece um ambiente pré-configurado com Podman (um substituto seguro e compatível com Docker).
Teste com este comando:
podman --version
Se aparecer a versão, você está pronto para seguir. Se não, verifique com o suporte da GeHost se há suporte a containers.
3. Crie uma pasta para o container
Vamos organizar tudo em um local específico. No terminal, digite:
mkdir ~/docker-nginx
Depois, entre na pasta:
cd ~/docker-nginx
4. Crie um arquivo de configuração simples (para testar)
Queremos rodar um servidor web simples (nginx) como container. Vamos criar um arquivo chamado index.html:
echo "<h1>Olá do Docker!</h1><p>Este site está rodando dentro de um container.</p>" > index.html
Isso cria uma página simples com uma mensagem de boas-vindas.
5. Execute o container com o comando Podman
Agora vamos rodar o container nginx, expondo a porta 8080 do servidor para o seu navegador:
podman run -d -p 8080:80 -v $PWD:/usr/share/nginx/html:ro nginx
Explicando o comando:
-d: roda em segundo plano (detached).-p 8080:80: mapeia a porta 8080 do servidor para a porta 80 do container.-v $PWD:/usr/share/nginx/html:ro: monta a pasta atual como conteúdo do nginx (leitura apenas).nginx: imagem oficial do nginx.
6. Acesse seu container pelo navegador
Abra seu navegador e vá para:
http://seu_servidor.gehost.com.br:8080
Se tudo deu certo, você verá a página que criamos: “Olá do Docker!” 🎉
7. (Opcional) Verifique os containers em execução
Para ver se o container está rodando, use:
podman ps
Isso mostra uma lista com os containers ativos. Você verá algo como:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
Se o seu container aparecer, está tudo certo!
8. Interrompa o container quando quiser
Quando terminar de testar, pare o container com:
podman stop CONTAINER_ID
Substitua CONTAINER_ID pelo ID que apareceu no comando podman ps.
Importante: limitações e boas práticas
- Em hospedagem compartilhada, você não tem acesso root, então não pode instalar Docker diretamente.
- Use apenas containers com imagem oficial e segura (como nginx, alpine, node, etc.).
- Evite usar containers que consumam muitos recursos (CPU, memória).
- Seu container só será acessível via porta (ex: 8080), não via domínio direto — use um subdomínio ou proxy se precisar.
- Não armazene dados persistentes no container — use o sistema de arquivos da hospedagem.
Conclusão: você está no caminho certo!
Parabéns, aluno! Você acaba de rodar seu primeiro container Docker (ou Podman) em uma hospedagem compartilhada. Isso é um grande passo rumo à autonomia e criatividade no desenvolvimento.
Lembre-se: o Docker não é só para profissionais — ele é uma ferramenta que pode ajudar qualquer um a testar, aprender e prototipar com segurança.
Do Sensei: “A jornada de mil quilômetros começa com um único passo. Hoje, você deu esse passo com coragem e curiosidade. Continue assim!” 🌟
Se tiver dúvidas, não hesite em entrar em contato com o suporte da GeHost. Estamos aqui para te ajudar a crescer. Até a próxima aventura! 🚀