Como instalar o Docker no Ubuntu

Antes de começar

• Um Ubuntu suportado: o Docker suporta as versões de 64 bits do Ubuntu 26.04, 24.04 e 22.04 LTS. Verifique a sua com cat /etc/os-release.
• Um servidor KVM, não um contentor: o Docker precisa de funcionalidades próprias do kernel. Funciona em qualquer VPS KVM, mas muitas vezes não em planos baseados em contentores (OpenVZ ou LXC).
• Root ou um utilizador com sudo. Os comandos abaixo usam sudo; se tiver sessão iniciada como root, pode omiti-lo.

Em servidores, evite o pacote docker.io do repositório do próprio Ubuntu e a versão Snap: o repositório do Docker recebe as novas versões primeiro e é o que a documentação do próprio Docker utiliza.

Passo 1: Remover pacotes em conflito

Se já instalou o Docker antes a partir de outra fonte, remova primeiro esses pacotes. Num servidor novo, o apt indica simplesmente que nenhum está instalado:

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)

As imagens e os volumes em /var/lib/docker/ não são apagados por isto.

Passo 2: Adicionar o repositório do Docker

Estes comandos, retirados da documentação do Docker, adicionam a chave de assinatura do Docker e o respetivo repositório apt para a sua versão do Ubuntu:

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Passo 3: Instalar o Docker e o Compose

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Isto instala o Docker Engine, a ferramenta de linha de comandos, o builder Buildx e o plugin Compose. Confirme que funciona:

sudo docker run hello-world
docker compose version

O primeiro comando descarrega uma pequena imagem de teste e mostra uma mensagem de boas-vindas. No Ubuntu, o Docker arranca automaticamente com o sistema, por isso não há nada a ativar.

O Compose é o comando docker compose, com espaço. O antigo docker-compose com hífen é a primeira versão, já descontinuada; os guias que ainda o usam também funcionam com o novo comando.

Passo 4: Permissões e rotação de registos

Usar o docker sem sudo. Adicione o seu utilizador ao grupo docker e depois termine sessão e volte a entrar:

sudo usermod -aG docker $USER

Tenha em atenção que o próprio Docker avisa que este grupo concede privilégios ao nível de root: qualquer pessoa que faça parte dele pode controlar todo o servidor. Adicione apenas utilizadores a quem daria root.

Limite o tamanho dos registos. Por predefinição, os registos dos contentores crescem sem limite e podem encher o disco. Crie /etc/docker/daemon.json:

{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

Depois execute sudo systemctl restart docker. O limite aplica-se aos contentores criados após a alteração, por isso recrie os existentes.

Um primeiro ficheiro Compose

O Compose descreve os seus contentores num único ficheiro. Crie uma pasta com um compose.yaml:

services:
  web:
    image: nginx:stable
    ports:
      - "127.0.0.1:8080:80"
    restart: unless-stopped

Inicie-o com docker compose up -d, verifique-o com docker compose ps e leia os registos com docker compose logs. restart: unless-stopped volta a pôr o contentor a correr após uma falha ou um reinício. A porta está associada a 127.0.0.1 de propósito, como explica a secção seguinte.

Docker e ufw: a armadilha da firewall

Isto apanha quase toda a gente. Quando publica uma porta, por exemplo -p 8080:80, o Docker adiciona as suas próprias regras de firewall, que são aplicadas antes das do ufw. A porta fica aberta à internet mesmo que o ufw diga que está fechada.

• Associe as portas a localhost quando só o próprio servidor precisa delas, como uma base de dados ou uma aplicação atrás de um reverse proxy: 127.0.0.1:8080:80.
• Não publique de todo as portas das bases de dados; deixe que os contentores comuniquem entre si através de uma rede Docker.
• Para filtrar por endereço de origem, adicione regras à cadeia iptables DOCKER-USER, que o Docker verifica antes das suas.

O mesmo se aplica a servidores de jogos executados em Docker; veja como configurar uma VPS para servidores de jogos.

Docker numa VPS da HytHost

Os planos VPS da HytHost funcionam em KVM, por isso cada VPS tem o seu próprio kernel e o Docker corre sem restrições. Escolha Ubuntu 24.04 ou 22.04 ao fazer a encomenda, ligue-se por SSH e siga os passos acima. Tem acesso root total, armazenamento SSD e proteção DDoS, e pode passar mais tarde para um plano maior à medida que os seus contentores crescem.