RabbitMQ na VPS: filas de mensagens no seu servidor
Produtor, fila, consumidor e ack em linguagem simples, instalação pelo repositório da equipe do RabbitMQ, guest fora, painel por túnel SSH e o checklist de produção.
Por Redação Eleven Host · @robson.direitodigital · 22 de novembro de 2026 · 11 min de leitura

Capa da Redação Eleven Host para o guia: RabbitMQ na VPS: filas de mensagens no seu servidor Arte: Eleven Host
RabbitMQ na VPS é ter, no seu próprio servidor, um programa que recebe mensagens de uma parte do sistema, guarda essas mensagens em filas e entrega cada uma a quem vai processá-la, no ritmo de cada lado.
Atualizado em 22/11/2026. Nada aqui foi executado no seu servidor: confira cada comando antes de usar e teste primeiro numa máquina sem dados reais.
Em 22/11/2026, as versões mais recentes do RabbitMQ eram a 4.4.1 e a 4.3.8, ambas de 16/11/2026. Pelas datas da página de informações de versões, só as séries 4.4 (até 31/07/2027) e 4.3 (até 31/01/2027) seguiam com suporte da comunidade. As duas falhas de gravidade alta listadas na página de segurança do repositório, publicadas em 25/10/2026, já tinham versão corrigida (na série 4.3, a 4.3.7). Segundo o arquivo LICENSE do repositório oficial, o servidor e os plugins embutidos usam a licença MPL 2.0, com alguns arquivos em Apache 2.0.
O que é um message broker
A documentação do RabbitMQ o descreve como um message broker: um intermediário que aceita e repassa mensagens. A comparação da própria página é com os correios, que recebem a carta, guardam e entregam; a diferença é que aqui as cartas são dados.
Quatro termos aparecem o tempo todo:
- produtor: o programa que envia a mensagem, como o site que acabou de receber um pedido;
- fila: onde as mensagens ficam guardadas até alguém pegá-las; vários produtores podem escrever na mesma fila e vários consumidores podem ler dela;
- consumidor: o programa que fica esperando mensagens para processar;
- ack: a confirmação que o consumidor manda depois de tratar a mensagem; só então o broker pode apagá-la.
Pela documentação de confirmações, se a conexão do consumidor cai antes do ack, a mensagem volta para a fila e é entregue de novo. A mesma página considera inseguro o ack automático, em que a mensagem conta como entregue no momento do envio. Por isso, nos seus programas, prefira o ack manual.
Para quem serve o RabbitMQ
Um caso comum é o app que não deve fazer o cliente esperar. Em vez de gerar o PDF, mandar o e-mail de confirmação ou processar o pagamento na mesma hora, o site publica uma mensagem na fila e responde; um programa à parte, o consumidor, faz o trabalho pesado em segundo plano. Se o consumidor parar, as mensagens esperam na fila.
Também serve para sistemas divididos em vários serviços, que trocam mensagens pelo broker em vez de chamar um ao outro diretamente. Existem outras ferramentas para filas, como Redis, Kafka e NATS; a escolha depende do seu projeto, e aqui o foco é só o RabbitMQ.
Uma VPS é um servidor virtual em que você instala e administra os programas; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes.
Uma lista das filas de cada app
Recomendamos anotar, desde o começo, qual app publica em qual fila e quem consome cada uma.
Quem ainda procura onde instalar o broker pode olhar os servidores virtuais da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Passo 1: instalar pelo repositório da equipe do RabbitMQ
A página de instalação para Debian e Ubuntu cobre Ubuntu 22.04, 24.04 e 26.04 e Debian 11, 12 e 13. Ela recomenda os repositórios apt mantidos pela equipe do RabbitMQ, porque os pacotes padrão das distribuições ficam muitas versões atrás. O mesmo vale para o Erlang, a linguagem em que o RabbitMQ roda: pela tabela de compatibilidade, a série 4.4 pede Erlang/OTP 27.0 a 29.x, e os pacotes de Erlang do Debian e do Ubuntu costumam ser velhos demais, por isso o script abaixo usa também o repositório de Erlang da equipe.
Os comandos abaixo são os do script da documentação para Ubuntu 24.04 (noble) em processador amd64. Primeiro, as ferramentas e a chave de assinatura:
sudo apt-get install curl gnupg apt-transport-https -y
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null
Depois, crie o arquivo /etc/apt/sources.list.d/rabbitmq.list, com o editor que preferir e sudo, com estas quatro linhas:
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-erlang/ubuntu/noble noble main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-erlang/ubuntu/noble noble main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-server/ubuntu/noble noble main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-server/ubuntu/noble noble main
Por fim, atualize a lista e instale o Erlang e o servidor:
sudo apt-get update -y
sudo apt-get install -y erlang-base erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key erlang-runtime-tools erlang-snmp erlang-ssl erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl
sudo apt-get install rabbitmq-server -y --fix-missing
No Ubuntu 22.04, troque noble por jammy nas linhas do repositório. No Debian, o caminho muda para debian/bookworm (Debian 12), e no Debian 13 a página usa só as linhas do rabbitmq-server, sem o repositório de Erlang. Esses repositórios só têm Erlang para amd64; em processador arm64, a documentação manda usar o PPA do Launchpad.
O outro caminho é a imagem oficial do Docker, rabbitmq, mantida pela comunidade Docker. A tag 4.4-management já vem com o painel ligado. Defina um --hostname fixo, porque o RabbitMQ guarda os dados pelo nome do nó, e publique as portas só no endereço local, como -p 127.0.0.1:15672:15672 (o exemplo da página publica em todas as interfaces).
Passo 2: conferir o serviço
O nó roda com o usuário de sistema rabbitmq. Para ver se está de pé:
sudo systemctl status rabbitmq-server
sudo rabbitmq-diagnostics ping
sudo rabbitmq-diagnostics status
Os registros ficam em geral em /var/log/rabbitmq e também aparecem com sudo journalctl --system | grep rabbitmq. A documentação pede um limite alto de arquivos abertos para o usuário rabbitmq em produção, na casa das dezenas de milhares. No systemd, isso vai no arquivo /etc/systemd/system/rabbitmq-server.service.d/limits.conf. Crie antes a pasta, com sudo mkdir -p /etc/systemd/system/rabbitmq-server.service.d, e crie o arquivo com sudo e o editor que preferir, com este conteúdo:
[Service]
LimitNOFILE=64000
Depois de criar o arquivo, recarregue o systemd e reinicie o serviço (o 64000 é o exemplo da documentação; o recarregamento é um passo padrão do systemd, que a página de instalação não traz):
sudo systemctl daemon-reload
sudo systemctl restart rabbitmq-server
Passo 3: criar vhost e usuários próprios
Um nó novo cria o usuário guest, com senha guest. Pela documentação de controle de acesso, por padrão ele só conecta a partir do próprio servidor (localhost), e liberar o acesso remoto dele é fortemente desaconselhado. O checklist de produção vai além: criar um usuário por aplicação, com credenciais geradas, e apagar o guest ou trocar a senha dele.
Um vhost separa filas e permissões de cada projeto. O exemplo abaixo, montado por nós, cria o vhost loja, um usuário para o app e outro para o painel. Gere uma senha para cada um:
openssl rand -hex 24
Depois, troque os textos SENHA_DO_APP e SENHA_DO_PAINEL pelas senhas geradas:
sudo rabbitmqctl add_vhost loja
sudo rabbitmqctl add_user app_loja SENHA_DO_APP
sudo rabbitmqctl set_permissions -p loja app_loja ".*" ".*" ".*"
sudo rabbitmqctl add_user admin_painel SENHA_DO_PAINEL
sudo rabbitmqctl set_user_tags admin_painel administrator
sudo rabbitmqctl set_permissions -p loja admin_painel ".*" ".*" ".*"
sudo rabbitmqctl delete_user guest
sudo rabbitmqctl list_users
As três expressões do set_permissions são, nesta ordem, configurar, escrever e ler; .* libera tudo, mas só dentro do vhost loja. A senha passada no comando pode ficar no histórico do terminal; a documentação também mostra a forma de enviá-la pela entrada padrão. Usuário novo nasce sem tag e sem acesso ao painel; a tag administrator permite gerenciar vhosts, usuários e permissões.
Passo 4: ligar o painel sem expor à internet
O painel de gerenciamento é um plugin. O comando para ligá-lo vem abaixo, mas aplique antes o arquivo de configuração mostrado mais adiante e reinicie o nó, para o painel já nascer preso ao endereço local (o plugin em si, segundo a documentação, não exige reinício):
sudo rabbitmq-plugins enable rabbitmq_management
Ele responde na porta 15672. Pela página de rede, a 5672 é a porta dos clientes AMQP, e a 25672, de comunicação entre nós e ferramentas de linha de comando, não deve ficar aberta ao público. Recomendamos não expor o painel à internet. Para isso, crie o arquivo /etc/rabbitmq/rabbitmq.conf (os pacotes não criam) e prenda o painel e, se os apps rodam no mesmo servidor, também a 5672 ao endereço local. A chave management.tcp.ip é da documentação (o exemplo dela usa 0.0.0.0); o valor 127.0.0.1 e a 5672 só local são escolhas nossas:
management.tcp.ip = 127.0.0.1
listeners.tcp.1 = 127.0.0.1:5672
listeners.tcp.2 = ::1:5672
Mudanças nesse arquivo só valem depois de reiniciar o nó (sudo systemctl restart rabbitmq-server). Confira onde cada porta está escutando com sudo rabbitmq-diagnostics -s listeners. Para abrir o painel do seu computador, use um túnel SSH (comando padrão do OpenSSH, montado por nós) e acesse http://localhost:15672 no navegador:
ssh -L 15672:127.0.0.1:15672 seu-usuario@ip-do-servidor
Outra saída é uma rede privada, como em Tailscale na VPS: acesso privado ao servidor e painéis. Se o app está em outra máquina, nosso conselho é liberar a 5672 só para o endereço dela no firewall, ou use TLS na 5671, como o checklist recomenda quando possível.
Passo 5: o checklist de produção
Alguns ajustes do checklist oficial, que também entram no rabbitmq.conf:
- memória:
vm_memory_high_watermark.relativevem em 0.6, e a faixa recomendada vai de 0.4 a 0.7. Pela documentação de memória, esse valor não é um teto: é o ponto em que o RabbitMQ segura os produtores até a memória baixar; - disco: o limite padrão de espaço livre, 50MB, serve só para desenvolvimento; em produção, a página sugere algo perto do limite de memória, como
disk_free_limit.absolute = 4Gpara um limite de memória de 4GB; - login anônimo: desligue com
auth_mechanisms.1 = PLAIN,auth_mechanisms.2 = AMQPLAINeanonymous_login_user = none; - filas: use filas duráveis ou exclusivas; desde a 4.3, filas não duráveis e não exclusivas vêm desligadas.
Um nó só, pelo checklist, é para desenvolvimento e testes; um cluster de três nós tolera a falha de um. Para acompanhar métricas, o plugin rabbitmq_prometheus expõe dados na porta 15692, no caminho /metrics; a coleta está em Prometheus na VPS: como monitorar seu servidor.
Passo 6: backup das definições
As definições são a estrutura do broker: usuários, vhosts, filas, exchanges e ligações. Para exportar e importar, o caminho abaixo é exemplo nosso; troque por uma pasta sua:
sudo rabbitmqctl export_definitions /caminho/definicoes.json
sudo rabbitmqctl import_definitions /caminho/definicoes.json
O arquivo traz os hashes das senhas, e a documentação manda tratá-lo como informação sensível. Recomendamos guardar a cópia fora do servidor, como em Duplicati na VPS: backup do servidor com painel web, e não contar com ele como cópia das mensagens.
Checklist do RabbitMQ na VPS
- série com suporte da comunidade (4.4 ou 4.3) e atualizações em dia;
- instalação pelo repositório da equipe, com Erlang compatível;
- guest apagado, um usuário por app, vhost por projeto;
- painel em 127.0.0.1 (e a 5672 também, se os apps estão no mesmo servidor), acesso por túnel SSH ou VPN;
- limites de memória e disco revisados, login anônimo desligado;
- definições exportadas e guardadas fora do servidor.
Um rótulo para cada servidor de filas
Recomendamos dar a cada máquina um nome fácil de reconhecer na configuração dos apps.
Nomes como filas.suaempresa.com.br começam por um domínio próprio. Buscar domínio
Perguntas frequentes
O usuário guest funciona de fora do servidor?
Não, por padrão. Pela documentação, o guest só conecta por localhost. Em vez de liberar, crie usuários próprios e apague o guest.
Preciso abrir a porta 15672 para usar o painel?
Não. Recomendamos deixar o painel em 127.0.0.1 e acessar por túnel SSH ou por uma rede privada.
Posso usar o RabbitMQ da distribuição?
A documentação recomenda os repositórios da equipe do RabbitMQ, porque os pacotes da distribuição ficam muitas versões atrás.
O export das definições guarda as mensagens?
O export guarda a estrutura: usuários, vhosts, filas e ligações. Recomendamos não tratá-lo como backup das mensagens.