SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-11-11

Instalar Docker no Rocky Linux e AlmaLinux

Instale o Docker Engine com dnf no Rocky Linux ou AlmaLinux e resolva conflitos com o Podman, bloqueios do SELinux em bind mounts e portas no Firewalld.

Instalar o Docker no Rocky Linux e no AlmaLinux

Para instalar o Docker no Rocky Linux ou no AlmaLinux, adicione o repositório dnf do próprio Docker, instale o engine com o plugin Compose e ative o serviço. Essa parte requer quatro comandos e é idêntica nas duas distribuições, porque ambas são reconstruções do Red Hat Enterprise Linux (RHEL) e partilham a mesma organização de pacotes. O CentOS Stream funciona da mesma forma. Tudo o que se segue aplica-se às duas distribuições. Se ainda estiver a escolher entre elas, os fatores decisivos são o compromisso de compatibilidade assumido por cada projeto e o suporte ao seu CPU mais antigo.

A instalação é curta, por isso a maior parte deste guia explica o que o Enterprise Linux (EL) faz de forma diferente do Ubuntu. O Podman pode já ser o proprietário do comando docker na sua imagem. O SELinux só confina os contentores depois de ativar o suporte do Docker para SELinux. A partir daí, bloqueia ficheiros montados com bind mount até que tenham a etiqueta correta. O Firewalld não filtra as portas publicadas pelo Docker. Por isso, uma porta de contentor pode estar aberta à Internet enquanto firewall-cmd indica que não há nada aberto.

Não utilize o script de conveniência do Docker disponibilizado em get.docker.com. A documentação do Docker afirma que ele não é recomendado para produção. O script altera a configuração dos repositórios sem pedir confirmação e não pode ser executado novamente com segurança para fazer uma atualização. Adicionar o repositório manualmente faz com que dnf upgrade trate o Docker como qualquer outro pacote do sistema. Isso também inclui o engine no âmbito do dnf-automatic, se o tiver configurado para aplicar atualizações de segurança periodicamente, por isso decida desde cedo se pretende atualizar o Docker automaticamente ou mantê-lo sem alterações até uma janela de manutenção. Em qualquer dos casos, uma atualização substitui o binário do pacote enquanto o dockerd antigo continua em execução, e needs-restarting é o comando que indica quais serviços ainda estão a executar o código que acabou de substituir.

O podman já está a responder ao comando docker?

Rocky Linux e AlmaLinux incluem o podman nos repositórios predefinidos, e muitas imagens de VPS instalam-no automaticamente. Algumas imagens vão mais longe e instalam podman-docker, que coloca um script de shell em /usr/bin/docker para chamar o podman. Assim, cada comando docker que introduzir executa o podman, e um guia escrito para Docker começa a produzir resultados inesperados.

O primeiro indício é um banner. O script /usr/bin/docker procura um ficheiro com o nome nodocker em /etc/containers e no seu próprio diretório ~/.config/containers (em $XDG_CONFIG_HOME, se o tiver definido). Quando nenhum dos ficheiros existe, apresenta uma linha antes de executar qualquer comando:

Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.

Alguém pode ter criado um dos ficheiros para ocultar o banner, por isso não dependa apenas dele. Consulte a base de dados de pacotes para saber qual é o pacote proprietário do binário:

command -v docker
rpm -qf "$(command -v docker)"

Uma resposta que comece por podman-docker significa que o podman está a responder. Uma resposta que comece por docker-ce-cli significa que é o Docker real. Se rpm -qf indicar que nenhum pacote é proprietário do ficheiro, alguém instalou-o manualmente e deve ler o script antes de confiar nele.

O Podman executa as mesmas imagens OCI e é uma escolha razoável. Se pretende utilizá-lo, pode parar aqui. Ambos são motores de contentores Linux, por isso, se a decisão sobre a plataforma ainda estiver em aberto, é útil saber que as jails do FreeBSD isolam um userland completo em vez de executarem imagens em camadas obtidas de um registry. Se pretende utilizar o Docker Engine, remova primeiro os pacotes em conflito. Esta é a lista documentada pelo Docker para RHEL:

sudo dnf remove docker docker-client docker-client-latest docker-common \
  docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runc

Leia o que o dnf planeia remover juntamente com eles antes de confirmar. Numa imagem de VPS nova, a lista é curta. Num servidor que alguém já tenha utilizado, remover podman pode remover cockpit-podman ou outra ferramenta que dependa dele.

Em princípio, é possível manter o podman juntamente com o Docker: remova apenas podman-docker, para libertar o nome docker, e runc, que o pacote containerd.io substitui. A documentação do Docker trata o podman como um pacote em conflito, por isso esta configuração não é suportada pelo Docker. Se a instalação continuar a indicar um conflito, utilize a lista completa de remoção apresentada acima.

Adicione o repositório do Docker com dnf config-manager

O Docker publica pacotes RPM para Enterprise Linux em download.docker.com. O ficheiro do repositório aponta para a árvore do CentOS, que é aquela contra a qual Rocky Linux e AlmaLinux resolvem os pacotes. Apontar um sistema Rocky para um repositório CentOS parece um erro até saber como ambas as distribuições surgiram da linhagem do CentOS depois de a Red Hat transformar o CentOS em Stream em 2020. Verificado em 10 de novembro de 2026, o Docker documenta este repositório para CentOS Stream 9 e CentOS Stream 10.

sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

A versão 5 do dnf removeu o argumento --add-repo, por isso o segundo comando falha nas versões mais recentes. Verifique qual versão está instalada e use a forma correspondente:

dnf --version

Se apresentar uma versão 5.x, use a forma com subcomando:

sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/centos/docker-ce.repo

Ambas escrevem o mesmo ficheiro em /etc/yum.repos.d/docker-ce.repo. A forma incorreta falha com um erro de argumento desconhecido, em vez de executar algo incorretamente em silêncio, por isso não passará despercebida.

Esse ficheiro de repositório define baseurl como um caminho que contém $releasever, e o dnf expande essa variável a partir do pacote de release. Rocky Linux e AlmaLinux definem-na como o número da versão principal: 9 no EL 9 e 10 no EL 10. É por isso que um repositório CentOS é resolvido corretamente num sistema Rocky. Confirme a expansão antes de instalar:

sudo dnf repoinfo docker-ce-stable

Leia a linha Repo-baseurl. Ela deve terminar em /9/x86_64/stable ou /10/x86_64/stable. Se o seu release definir $releasever como uma versão pontual, como 9.6, a linha mostrará /9.6/, e o dnf informará Status code: 404 para esse URL ao obter os metadados. Corrija o problema editando /etc/yum.repos.d/docker-ce.repo e substituindo $releasever pelo número da versão principal sem outros componentes. Um erro 404, por si só, não comprova isto. A Red Hat lista outras causas para o mesmo erro, incluindo metadados de repositório inconsistentes e um URL base incorreto. Por isso, faça a alteração apenas quando Repo-baseurl mostrar efetivamente uma versão pontual. Se já terminar no número da versão principal, substituir a variável não altera nada.

Instale o engine e o plugin Compose

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

São cinco pacotes, e cada um tem uma função. docker-ce é o daemon, dockerd. docker-ce-cli é o comando docker que introduz. containerd.io é o runtime de contentores controlado pelo daemon. docker-buildx-plugin cria imagens. docker-compose-plugin disponibiliza docker compose como subcomando.

Estes pacotes não instalam um binário docker-compose com hífen. Esse era o Compose v1, que a Docker declarou obsoleto depois de o Compose v2 ficar geralmente disponível. Tudo o que chamar docker-compose com um hífen precisa de ser atualizado para docker compose com um espaço.

A primeira instalação para para importar a chave de assinatura da Docker e mostra a respetiva impressão digital. A chave vem de gpgkey=https://download.docker.com/linux/centos/gpg no ficheiro do repositório que acabou de adicionar. Compare a impressão digital apresentada pelo dnf com esse URL antes de a aceitar.

Há uma falha que ocorre com frequência suficiente para ser identificada. Se o dnf indicar que containerd.io requer container-selinux e que nenhum pacote fornece esse requisito, o repositório AppStream está desativado. Execute dnf repolist e confirme que appstream está listado, porque é aí que container-selinux é disponibilizado no EL 9 e no EL 10.

Inicie o Docker e confirme que está a funcionar

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world

Os pacotes RPM do Docker deixam o daemon parado e desativado depois da instalação. Por isso, este passo aparece na página do Docker para CentOS, mas não na página para Ubuntu, onde o pacote deb inicia o serviço por si. Ignore enable e o Docker funcionará até ao próximo reboot. Depois, ficará parado e fará parar todos os contentores.

systemctl status deve mostrar Active: active (running). O contentor hello-world deve imprimir This message shows that your installation appears to be working correctly. e terminar. Se, em vez disso, imprimir um erro de permissões em /var/run/docker.sock, significa que omitiu sudo. A secção sobre o grupo docker, mais abaixo, corrige esse problema.

Verifique o plugin Compose separadamente, porque é um pacote diferente e pode estar em falta mesmo quando o engine está a funcionar:

docker compose version

Numa instalação nova, uma resposta saudável tem o aspeto de Docker Compose version v5.7.0. Esta é a versão disponibilizada pelo repositório EL 9 do Docker em 10 November 2026. Não estranhe a passagem da v2 para a v5. O Docker lançou o Compose v5 em 2025, funcionalmente idêntico à v2, e saltou os números intermédios para evitar confusão com os formatos de ficheiro Compose antigos, identificados como v2 e v3. O Docker suporta tanto o Compose v2 como o Compose v5. Por isso, um servidor mais antigo que responda v2.x.x continua a funcionar, e dnf upgrade atualiza-o para a v5. Recuperar os seus serviços depois de um reboot é uma questão diferente de ativar o daemon, e as políticas de reinício determinam se os serviços Compose voltam a arrancar no boot.

Por que um bind mount resulta em permission denied?

Rocky Linux e AlmaLinux executam o SELinux (Security-Enhanced Linux) no modo enforcing por predefinição. Confirme com getenforce, que imprime Enforcing.

A aplicação de políticas no host não confina, por si só, os contentores Docker. O suporte do Docker para SELinux é uma definição do daemon, selinux-enabled, que está desativada por predefinição, e o pacote docker-ce não a ativa. Com essa definição desativada, os contentores são iniciados como spc_t, um tipo sem confinamento. Por isso, um bind mount funciona sem qualquer label e o SELinux não separa o contentor do host. Para que o SELinux confine os seus contentores, ative a definição em /etc/docker/daemon.json e reinicie o daemon. Se esse ficheiro já tiver definições, adicione a chave ao objeto existente em vez de substituir o ficheiro:

echo '{ "selinux-enabled": true }' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

Com a etiquetagem ativa, os contentores Docker executam-se sob o tipo SELinux container_t. A política dá a esse tipo acesso total a ficheiros com a label container_file_t e a alguns tipos de sistema de ficheiros, como nfs_t, além de acesso de leitura a outros, como container_ro_file_t. Não concede acesso às labels genéricas atribuídas aos diretórios normais do host. Um diretório criado no host recebe a label definida pelo caminho-pai. Por isso, o acesso do contentor é negado, embora o proprietário, o grupo e o modo pareçam corretos no host. Reproduza o problema com três comandos:

sudo mkdir -p /srv/site
echo hello | sudo tee /srv/site/index.html
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro nginx:alpine cat /usr/share/nginx/html/index.html

O contentor imprime:

cat: can't open '/usr/share/nginx/html/index.html': Permission denied

Dois comandos mostram a causa. ls -ldZ /srv/site imprime a label, que, para um caminho sob /srv, é system_u:object_r:var_t:s0, e não container_file_t. Depois, sudo ausearch -m avc -ts recent imprime o registo de auditoria do kernel, que contém avc: denied { read }, um campo scontext= que identifica container_t, e um campo tcontext= que identifica a label que acabou de ver no diretório. A diferença entre esses dois campos explica todo o problema.

A correção é um sufixo no argumento do volume. O Docker altera a label do caminho automaticamente:

sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html

:z em minúsculas atribui ao conteúdo uma label partilhada, permitindo que vários contentores usem o mesmo diretório. :Z em maiúsculas atribui uma label privada e não partilhada, associada a um contentor. Nesse caso, um segundo contentor que leia o mesmo caminho terá o acesso negado. Use :z para tudo o que também seja utilizado por um sidecar ou por um contentor de backup. Use :Z para um diretório de base de dados pertencente a um único contentor.

A documentação do Docker contém um aviso que vale a pena repetir, porque a alteração da label é recursiva. Fazer bind mount de um diretório do sistema, como /home ou /usr, com :Z "torna a sua máquina host inoperável e pode ser necessário alterar manualmente as labels dos ficheiros do host". Aponte estes sufixos para diretórios que criou para o contentor, nunca para um caminho do sistema.

No Compose, o sufixo é colocado na mesma string:

services:
  web:
    image: nginx:alpine
    volumes:
      - /srv/site:/usr/share/nginx/html:ro,z

É fácil atingir dois limites. A flag --mount não consegue definir uma label SELinux. Use -v quando precisar de uma. Os volumes nomeados não precisam de sufixo, porque o Docker atribui automaticamente labels aos diretórios que cria sob /var/lib/docker/volumes.

Não desative o SELinux. Use sudo setenforce 0 apenas como teste de um minuto: se o contentor funcionar depois disso, o SELinux é o que está a bloqueá-lo, embora não necessariamente através da label do bind mount. Leia o campo tcontext= na negação. Se contiver a label do diretório, :z é a resposta. Se identificar um dispositivo, a correção costuma ser uma boolean policy, como sudo setsebool -P container_use_xserver_devices 1 para um dispositivo de servidor X montado no contentor. Volte imediatamente ao modo enforcing com sudo setenforce 1. No Enterprise Linux, permission denied num bind mount tem duas causas distintas que parecem idênticas dentro do contentor. Uma é a label SELinux. A outra é a propriedade numérica normal do utilizador e do grupo, que é o problema que as variáveis PUID e PGID resolvem. ls -lnZ mostra o modo, o proprietário numérico e a label numa só linha, para poder distinguir qual dos dois problemas está a tratar.

Por que uma porta publicada fica acessível quando o firewalld parece fechado?

O firewalld é o firewall padrão no Rocky Linux e no AlmaLinux. Confirme se está em execução com sudo systemctl is-active firewalld. Se ainda não configurou o firewalld neste servidor, comece por abrir a porta SSH e uma porta web com o firewalld, porque o problema abaixo só faz sentido quando existe um conjunto de regras de zona funcional para comparação. Agora publique uma porta e verifique o que o firewalld considera aberto:

sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-ports

firewall-cmd imprime uma linha vazia. A partir de outra máquina, curl -I http://YOUR_SERVER_IP:8080/ devolve HTTP/1.1 200 OK. A porta está aberta para a Internet, mas o firewall não mostra nenhuma regra correspondente.

A causa é o caminho percorrido pelo pacote. As zonas do firewalld filtram o tráfego destinado ao próprio servidor. Uma porta publicada não é destinada ao servidor: o Docker instala uma regra de NAT de destino (tradução de endereços de rede) que reescreve o destino para o endereço do contentor antes de o pacote chegar ao caminho de entrada do servidor. Por isso, o kernel encaminha o pacote em vez de o entregar localmente. O Docker coloca então as suas interfaces bridge numa zona do firewalld chamada docker, cujo destino é ACCEPT, e adiciona uma política de encaminhamento chamada docker-forwarding que permite o encaminhamento de qualquer zona para a zona docker. As suas regras de zona nunca veem o pacote.

A correção mais simples não precisa de nenhuma regra de firewall. Faça o bind da extremidade do host da publicação ao loopback e coloque um reverse proxy à frente:

sudo docker rm -f web
sudo docker run -d --name web -p 127.0.0.1:8080:80 nginx:alpine
curl -I http://127.0.0.1:8080/

O comando local curl devolve HTTP/1.1 200 OK, e o mesmo pedido a partir de outra máquina deixa de estabelecer ligação. Com as definições padrão do Docker, um argumento -p sem endereço de host publica a porta em todas as interfaces. A exceção ocorre quando alguém alterou o endereço de bind padrão do daemon, por exemplo com "ip": "127.0.0.1" em /etc/docker/daemon.json. Se não sabe que isso foi feito neste servidor, trate um -p 8080:80 sem endereço de host como uma decisão de expor esse serviço publicamente.

Quando precisa de que um serviço seja acessível a alguns endereços, mas não a outros, o Docker disponibiliza uma chain própria. DOCKER-USER é processada antes das regras de aceitação do Docker. Assim, uma regra colocada nessa chain permanece depois de o Docker reiniciar e reescrever as suas chains:

sudo iptables -I DOCKER-USER -i enp1s0 ! -s 203.0.113.10 -j DROP
sudo iptables -S DOCKER-USER

Obtenha o nome da interface a partir de ip route show default em vez de presumir eth0, porque as imagens EL atuais usam nomes como enp1s0 ou ens3. No Rocky Linux e no AlmaLinux, o comando iptables é uma camada de compatibilidade sobre o nftables, e as chains do Docker ficam visíveis através dele. As regras adicionadas dessa forma desaparecem depois de um reboot, a menos que as guarde. Quando estiver satisfeito com elas, coloque-as numa unidade systemd.

O Docker Engine 28.0, lançado em 2025, corrigiu um problema relacionado: o acesso direto encaminhado às portas dos contentores que nunca foram publicadas passou a ser bloqueado na chain DOCKER. Essa alteração não afeta as portas publicadas, por isso tudo o que foi descrito acima continua a aplicar-se às versões atuais. Vale a pena criar um hábito operacional: depois de qualquer sudo firewall-cmd --reload, teste novamente uma porta publicada. Se deixar de responder, sudo systemctl restart docker reinstala as regras do Docker.

Os administradores de Ubuntu encontram o mesmo problema através de uma ferramenta diferente, como explicado em por que as portas Docker publicadas ignoram as regras do ufw. Em ambos os casos, a causa é o caminho de NAT. Apenas o firewall colocado à frente desse caminho é diferente.

Adicionar um utilizador não-root ao grupo docker

Escrever sudo antes de cada comando docker torna-se cansativo, e o grupo docker elimina essa necessidade:

sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-world

usermod -aG edita /etc/group, mas a shell atual já tem a sua lista de grupos, por isso a alteração não é aplicada até iniciar uma nova. newgrp docker inicia uma shell com o grupo associado, para poder testar imediatamente. As novas sessões SSH passam a utilizá-lo automaticamente.

Seja claro sobre as permissões concedidas por esse grupo. A associação dá acesso de escrita a /var/run/docker.sock, e qualquer processo que consiga comunicar com esse socket pode pedir ao daemon para iniciar um contentor que monte o sistema de ficheiros do host. Um comando mostra o que isso significa:

docker run --rm -v /:/host alpine wc -l /host/etc/shadow

Isto lê um ficheiro que apenas root pode ler, a partir de uma conta sem permissões sudo. A documentação de pós-instalação do Docker afirma o mesmo: o grupo docker concede privilégios equivalentes aos de root. Adicione uma conta a esse grupo apenas se também concedesse a essa conta sudo. Se estiver a configurar contas num servidor novo, tome esta decisão juntamente com o resto da sua configuração de utilizadores com privilégio mínimo num VPS, e não posteriormente.

O Docker também disponibiliza um modo rootless, que executa o daemon como um utilizador sem privilégios. É um método de instalação separado e altera o comportamento dos controladores de armazenamento e das portas abaixo de 1024. Por isso, planeie-o como um projeto próprio, e não como uma flag a adicionar mais tarde.

Próximos passos

Agora já tem o motor, o plugin Compose, um serviço que sobrevive a um reboot e os três comportamentos específicos de EL documentados acima. O próximo passo é uma compose.yaml por serviço. A anatomia de um ficheiro Compose explica o formato do ficheiro e os comandos que o controlam. Se este for o seu primeiro host de contentores, executar Docker numa VPS aborda as questões de dimensionamento, armazenamento e higiene das imagens que este guia não cobre.

FAQ

O repositório do Docker para CentOS funciona no Rocky Linux e no AlmaLinux?

Sim. Adicione https://download.docker.com/linux/centos/docker-ce.repo com dnf config-manager. O baseurl nesse ficheiro contém $releasever, e o Rocky Linux e o AlmaLinux expandem-no para o número da versão principal. Assim, um sistema EL 9 resolve para a árvore do CentOS 9, e um sistema EL 10 resolve para a árvore do CentOS 10. Confirme a expansão com sudo dnf repoinfo docker-ce-stable e leia a linha Repo-baseurl. Se essa linha mostrar uma versão de ponto, como 9.6, e o dnf comunicar Status code: 404 ao obter os metadados, editar /etc/yum.repos.d/docker-ce.repo para usar apenas o número da versão principal corrige o problema. Se a linha já mostrar o número da versão principal, o erro 404 tem outra causa, como metadados de repositório inconsistentes ou um URL base incorreto. Nesse caso, editar a variável não resolve o problema.

Posso instalar Docker e podman no mesmo servidor?

A documentação do Docker lista podman e runc como pacotes em conflito e indica que ambos devem ser removidos antes da instalação do Docker Engine. O conflito concreto envolve o pacote podman-docker, que é proprietário de /usr/bin/docker e transforma todos os comandos docker em comandos do podman. Execute rpm -qf "$(command -v docker)" para ver qual pacote é proprietário desse caminho. Se a saída começar por podman-docker, é o podman que está a responder. Manter os dois engines não é uma configuração suportada pelo Docker. Num servidor importante, escolha apenas um.

Por que o meu contentor recebe permission denied num bind mount?

O SELinux aplica a sua política por predefinição no Rocky Linux e no AlmaLinux. Quando a definição selinux-enabled do Docker está ativa, os contentores são executados com o tipo container_t. Essa tipagem não tem acesso aos rótulos genéricos atribuídos aos diretórios normais do host. Por isso, o acesso a um diretório criado por si é negado, independentemente do proprietário e das permissões. Confirme isso com ls -ldZ no caminho do host e com sudo ausearch -m avc -ts recent, que apresenta avc: denied com os dois contextos incompatíveis. Adicione :z ao argumento do volume para conteúdo partilhado entre contentores, ou :Z para conteúdo privado de um só contentor. Nunca aponte :Z para /home ou /usr, porque a alteração recursiva dos rótulos danificará o host.

Preciso de abrir uma porta no firewalld para publicar a porta de um contentor?

Não. Esse é precisamente o problema. A regra NAT do Docker reescreve o endereço de destino antes de o pacote chegar ao caminho de entrada do host. Por isso, as regras de zona do firewalld nunca o inspecionam. O Docker também coloca as suas bridges numa zona do firewalld chamada docker, com o destino ACCEPT. Um contentor iniciado com -p 8080:80 fica acessível a partir da Internet, enquanto sudo firewall-cmd --list-ports não apresenta qualquer saída. Publique para um endereço específico com -p 127.0.0.1:8080:80 quando apenas o host deve conseguir aceder ao serviço, ou insira regras de filtragem na cadeia DOCKER-USER. O Docker processa essa cadeia antes das suas próprias regras de aceitação.

É seguro adicionar o meu utilizador ao grupo docker?

Isso concede acesso root. Um membro do grupo docker pode escrever em /var/run/docker.sock, e docker run --rm -v /:/host alpine wc -l /host/etc/shadow pode depois ler um ficheiro acessível apenas por root a partir de uma conta sem permissões sudo. A documentação de pós-instalação do Docker afirma a mesma equivalência. Adicione apenas contas às quais já concederia confiança com sudo, e continue a usar sudo docker para contas partilhadas ou de serviço. O modo rootless é a alternativa quando precisa de executar contentores com um utilizador sem privilégios. É um método de instalação separado, não uma definição.

Este artigo foi útil?