Base de Conhecimento

RustDesk na VPS: servidor de acesso remoto próprio

  • rustdesk, acesso remoto, docker, vps, hbbs
  • Usuários acharam útil: 0

Servidor próprio do RustDesk com Docker Compose: portas TCP e UDP, chave pública, relay que exige a chave, configuração do aplicativo e domínio opcional.

Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: RustDesk na VPS: servidor de acesso remoto próprio

Capa da Redação Eleven Host para o guia: RustDesk na VPS: servidor de acesso remoto próprio Arte: Eleven Host

RustDesk na VPS é um servidor de acesso remoto próprio: você instala os programas hbbs e hbbr, aponta os aplicativos para ele e controla computadores sem depender do servidor público.

Atualizado em 16/11/2026. Para entender o que é uma VPS antes de começar, veja O que é servidor VPS: guia simples para iniciantes.

O que é o RustDesk e o que é o servidor próprio

O RustDesk é um software de acesso remoto de código aberto: um aplicativo mostra e controla a tela de outro computador. O servidor próprio tem dois programas.

  • hbbs é o servidor de ID, também chamado de rendezvous ou de sinalização. Os dispositivos se registram nele com o endereço e a porta do momento, e ele coordena a conexão entre os dois lados, tentando ligá-los direto por uma técnica chamada hole punching.
  • hbbr é o servidor de relay. O tráfego só passa por ele quando a conexão direta falha, o que a documentação oficial descreve como raro.

A licença do servidor é a AGPL-3.0. Em 16/11/2026, a versão estável do servidor de código aberto é a 1.1.16, publicada em 20/07/2026, e a do aplicativo (cliente) é a 1.5.3, de 09/11/2026.

Para quem serve e o que a versão gratuita traz

O servidor próprio atende quem quer que os computadores da família, da equipe ou da empresa se registrem num servidor sob seu controle. A versão de código aberto é gratuita, traz o hbbs e o hbbr e exige instalação e configuração manuais.

Alguns recursos ficam só no RustDesk Server Pro, a edição paga do projeto: contas de usuário, console web, API, login por OIDC e LDAP, 2FA, catálogo de endereços, gestão de dispositivos, vários relays com escolha automática do mais próximo e web client hospedado por você. O servidor gratuito é usado com o aplicativo RustDesk, e é dele que tratam os passos a seguir.

Outra opção para acessar máquinas é pelo navegador, como em Guacamole na VPS: acesso remoto pelo navegador. É um jeito diferente: o RustDesk usa um aplicativo instalado em cada computador.

Sem servidor por perto, as VPS da Eleven Host são um caminho. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Requisitos

A documentação do servidor de código aberto fala em requisitos baixos: a configuração mínima de um servidor de nuvem básico basta. O que pesa é a banda de rede, quando a conexão cai no relay. Numa tela 1920x1080, a documentação cita de cerca de 30 K/s a 3 M/s, conforme a imagem muda.

Os passos a seguir partem de uma VPS com Linux, com o Docker e o plugin Docker Compose já instalados, um usuário que possa usar sudo e um IP público fixo. O modo network_mode: host do compose oficial só funciona em Linux.

Passo 1: liberar as portas no firewall do servidor

Na documentação oficial, o conjunto principal vai de TCP 21114 a 21119, mais UDP 21116, e o mínimo para funcionar são as TCP 21115 a 21117.

  • TCP 21115 (hbbs): teste do tipo de NAT.
  • TCP e UDP 21116 (hbbs): registro de ID, sinal de vida (heartbeat) e hole punching.
  • TCP 21117 (hbbr): relay.
  • TCP 21114 (hbbs): console web e API, que são do Pro.
  • TCP 21118 e 21119 (hbbs e hbbr): web clients por WebSocket. Sem web client, podem ficar desativadas.

Há um aviso de segurança da documentação sobre as portas 21118 e 21119: com elas abertas, o hbbs e o hbbr confiam nos cabeçalhos X-Real-IP e X-Forwarded-For sem validar. Quem as alcançar direto pode forjar o IP e burlar limite de taxa e bloqueio por IP. Sem web client, mantenha as duas fechadas.

Esquecer o UDP da 21116 é uma falha comum. Um exemplo de comandos com o ufw, para o servidor gratuito sem web client; confira cada linha no seu servidor antes de aplicar:

sudo ufw allow OpenSSH

sudo ufw allow 21115:21117/tcp

sudo ufw allow 21116/udp

sudo ufw enable

sudo ufw status

O SSH é liberado antes do ufw enable para você não ficar trancado fora da VPS. Se houver firewall no painel do provedor, as mesmas portas precisam ser liberadas lá também.

Passo 2: subir o servidor com Docker Compose

O Docker é o método que a documentação recomenda. O arquivo oficial está em rustdesk.com/oss.yml e define dois serviços, hbbs e hbbr, com a imagem rustdesk/rustdesk-server:latest, o volume ./data:/root e network_mode: "host". O modo host faz os programas verem o IP real do cliente.

Um exemplo de comandos, que cria uma pasta de trabalho, baixa o arquivo e sobe os dois serviços; confira no seu servidor se o caminho e o nome do arquivo batem:

mkdir -p ~/rustdesk && cd ~/rustdesk

curl -fsSL https://rustdesk.com/oss.yml -o compose.yml

sudo docker compose up -d

sudo docker compose ps

A pasta ./data nasce na primeira partida e guarda o par de chaves. Para os logs, use sudo docker logs hbbs e sudo docker logs hbbr.

Webmin na VPS: administre o servidor pelo navegador ajuda a administrar a VPS depois da instalação.

Passo 3: a chave pública e o relay que exige a chave

Na primeira partida, o servidor gera um par de chaves, id_ed25519 (privada) e id_ed25519.pub (pública), na pasta de trabalho do processo. Com o compose oficial, elas aparecem em ./data. A chave pública é a Key que vai nos aplicativos. Não é a chave de licença do Pro.

Um exemplo de comando para ler a chave pública, a partir da pasta do compose; confira se o arquivo existe antes de copiar:

cat ./data/id_ed25519.pub

Por padrão, o relay (hbbr) não confere a chave: quem descobrir o IP do servidor consegue usar o relay sem ela. Enquanto o hbbr não exigir a chave, o relay não fica restrito aos seus aplicativos, mesmo com a Key configurada neles.

Para exigir a chave, o hbbr precisa usar a mesma chave do hbbs. No hbbs, o padrão já carrega ou gera o par sozinho, e passar -k _ a ele não o deixa mais rígido. O que muda é no hbbr.

Um exemplo de ajuste no arquivo compose.yml (abra com nano compose.yml), na seção do hbbr, para ele carregar o mesmo par de chaves; confira no seu arquivo e depois nos logs:

command: hbbr -k _

sudo docker compose up -d

sudo docker logs hbbr

Nos logs do hbbs e do hbbr, a linha com a Key deve mostrar o mesmo valor. Se um dia usar -k com uma chave escrita por extenso, ela deve ser a privada; para os aplicativos vai a pública.

Guarde a pasta ./data

Volume mal mapeado pode dar chave diferente entre hbbs e hbbr. Se a pasta ./data for apagada, o servidor gera um par novo, e os clientes passam a dar o erro de chave pública inválida até receberem a Key nova. Recomendamos manter um backup dessa pasta e deixar a chave privada só na VPS.

Passo 4: configurar o aplicativo

Em cada computador, abra as configurações de rede do RustDesk (Settings, depois Network, e o item de ID/Relay server), desbloqueie com privilégio de administrador e preencha os campos.

  • ID Server: o endereço do hbbs, host ou IP, com porta opcional. O exemplo da documentação tem o formato hbbs.example.com:21116.
  • Relay Server: pode ficar em branco, porque o RustDesk deduz o endereço do hbbr, que usa a porta 21117. Só preencha se o hbbr estiver em outro endereço.
  • API Server: campo do Pro. No servidor gratuito, deixe vazio.
  • Key: o conteúdo do arquivo id_ed25519.pub.

O ID Server e a Key precisam estar preenchidos nos dois lados, em quem acessa e em quem é acessado. Depois de configurar um computador, o menu de Settings, Network tem a opção Export Server Config, e nos outros você usa Import Server Config e Apply.

Mantenha o aplicativo em 1.5.3 ou mais novo: há alertas de segurança para versões antigas do cliente, e a 1.5.3 trouxe a aprovação de pedido de conexão. No servidor, a 1.1.16 corrige pedidos UDP sem autenticação que podiam ser usados em ataque de reflexão e amplificação. Em 16/11/2026, não há alerta de segurança público conhecido para o servidor de código aberto.

Acesso só com autorização

Acesso remoto vale para computadores cujo dono ou usuário autorizou o acesso. Numa empresa, recomendamos que a autorização seja por escrito e que o funcionário saiba que a máquina pode ser acessada.

Problemas comuns

  • Chave inválida (invalid public key): a Key do aplicativo não bate com a do servidor. Compare com o id_ed25519.pub, confira se o hbbr usa a mesma chave do hbbs e olhe o volume do Docker.
  • Failed to connect via rendezvous server: Please try later: o computador controlado não alcança o hbbs. Do computador controlado, o teste com telnet no IP e na porta 21116 ajuda a localizar o bloqueio.
  • Falha no relay, com mensagens como deadline has elapsed ou Connection reset by the peer: coloque o sufixo /r no ID remoto para forçar o relay, confira se o hbbr roda no mesmo servidor e se a TCP 21117 está acessível.
  • UDP bloqueado: se a falha ocorre só em alguns aparelhos, a opção avançada disable-udp do cliente força o uso só do TCP.

Um nome de domínio para o servidor

O ID Server aceita IP ou nome. Recomendamos um registro A, como rustdesk.suaempresa.com.br apontando para o IP da VPS, para trocar de servidor mudando só o DNS, sem reconfigurar os aplicativos. A Key tem de ir junto para o servidor novo. Recomendamos não pôr proxy de CDN na frente desse nome, porque a UDP 21116 e as portas 2111x não passam por proxy HTTP.

Com domínio registrado conosco, o DNS gerenciado é grátis na rede da Cloudflare, com painel na área do cliente. Buscar domínio

Perguntas frequentes

O servidor do RustDesk é gratuito?

A versão de código aberto é gratuita, sob a licença AGPL-3.0, e vem com hbbs e hbbr. Contas, console web, 2FA e web client hospedado por você são do RustDesk Server Pro.

Como faço o relay aceitar só clientes com a chave?

O hbbr usa a mesma chave do hbbs. Um exemplo, no compose oficial, é trocar command: hbbr por command: hbbr -k _ e conferir nos logs a linha da Key.

O que fazer se o aplicativo acusa chave inválida?

Compare a Key do aplicativo com o id_ed25519.pub do servidor. Se a pasta ./data foi apagada, o servidor gerou um par novo.

Esta resposta lhe foi útil?

Artigos Relacionados