Migrações Vindo do Heroku, Render, Hatchbox ou Cloud 66? Migramos seu app de produção em até 48 horas →
O que realmente acontece no seu servidor quando você conecta a Railyard: uma auditoria linha por linha da nossa arquitetura de Docker, Caddy, firewall e zero lock-in ← Blog Segurança e arquitetura BYOC • 10 min de leitura

O que realmente acontece no seu servidor quando você conecta a Railyard: uma auditoria linha por linha da nossa arquitetura de Docker, Caddy, firewall e zero lock-in

Almokhtar Bekkour

Almokhtar Bekkour, Founder, Systems Architect

27 de outubro de 2026 · 10 min de leitura

A maioria dos engenheiros de DevOps que não quer experimentar um agente de PaaS não está objetando à ideia de um. Eles estão objetando a não saber o que ele faz: o que é instalado, quais portas abrem, se ele liga para casa ou aceita conexões, e o que fica para trás se eles forem embora. Isso é uma coisa razoável de querer responder antes de rodar qualquer coisa como root em uma máquina de produção. Então este post pula a estrutura usual de “o que a Railyard faz por você” e em vez disso descreve, a partir do próprio código-fonte, o que acontece entre clicar em Conectar um servidor e o agente reportar que está pronto, o que muda de forma contínua, e o que o código faz ao desconectar, já que esse último ponto não bate com a leitura mais simples do nosso próprio FAQ.

Conectando um servidor: os passos reais

Conectar um servidor é um job em background que abre uma sessão SSH com a chave que você fornece (ou uma que a Railyard gerou, se você deixou ela criar o servidor) e roda uma sequência fixa de comandos. Em ordem:

  1. Docker, instalado via o script oficial get.docker.com se ainda não estiver presente. Se você não está conectando como root, seu usuário é adicionado ao grupo docker para que os passos seguintes não precisem de sudo em cada chamada do Docker.
  2. Um swapfile de 2 GB em /swapfile, criado só se nenhum swap já existir, com vm.swappiness definido em 10. Servidores de build recebem um maior, dimensionado para deixar espaço suficiente para um build em andamento.
  3. Regras do UFW para as portas 22, 80, 443 e 50052, depois o UFW é forçadamente ativado se ele estava instalado mas desligado. Se o UFW não estiver instalado de forma alguma, esse passo é pulado e registrado, não assumido silenciosamente.
  4. Atualizações de segurança desacompanhadas: o pacote unattended-upgrades é instalado se estiver faltando, e /etc/apt/apt.conf.d/20auto-upgrades é escrito para ativar atualizações noturnas de lista de pacotes e atualizações de segurança desacompanhadas. Um reinício nunca é disparado automaticamente a partir desse passo; isso é uma ação separada e deliberada a partir da própria página do servidor.
  5. nixpacks, para deploys no estilo buildpack a partir de um repositório, a menos que o servidor tenha o papel de só-banco-de-dados.
  6. O próprio agente: um conjunto TLS em /var/lib/railyard-agent/tls se a CA do plano de controle estiver configurada (sempre verdadeiro para o próprio plano de controle hospedado da Railyard; ele se recusa a conectar um agente em texto puro em vez de recuar silenciosamente), um arquivo de ambiente em /etc/railyard-agent.env, o binário em /usr/local/bin/railyard-agent, e uma unidade systemd (railyard-agent.service) com Restart=always, prioridade elevada de CPU e I/O, e OOMScoreAdjust=-900. O próprio comentário do arquivo de unidade explica por quê: “o agente é a única forma de alcançar essa máquina, nunca deixe um build descontrolado ou um container em loop de crash sufocar ele.”
  7. Caddy, como lucaslorentz/caddy-docker-proxy, rodado com o socket Docker do host montado para que ele possa descobrir containers por label e rotear para eles automaticamente, publicando as portas 80 e 443. Pulado em um servidor só-banco-de-dados.
  8. Datastores, se algum estiver configurado para aquele servidor (Postgres e Redis por padrão; MySQL, ClickHouse, RabbitMQ, MongoDB, InfluxDB, Elasticsearch, MinIO e Memcached são opcionais), cada um como seu próprio container com uma senha gerada de 40 caracteres, em uma rede Docker dedicada railyard.

Nada nessa sequência toca em um container que você já tinha rodando. Containers nomeados são específicos (railyard-caddy, railyard-postgres, e assim por diante), então a única forma disso colidir com algo já na máquina é se por acaso você já tivesse um container com um desses nomes exatos.

O firewall, com precisão

As regras de permissão base do UFW são 22 (SSH), 80 e 443 (Caddy), e 50052 (a própria porta gRPC do agente, explicada abaixo). O WireGuard, se você ativar a rede privada para a equipe, adiciona uma regra de permissão UDP na porta 51820. Além dessa base, o agente pode abrir portas adicionais por conta própria, mas só sob instrução do plano de controle durante um heartbeat, marcadas com um comentário railyard-operator na lista de regras do UFW para que sejam identificáveis e removidas automaticamente no momento em que não forem mais necessárias, por exemplo quando você desliga uma configuração de “mais portas públicas” em um app. Portas de datastore (5432, 6379 e assim por diante) não são abertas por padrão; elas permanecem alcançáveis só na rede Docker privada, a menos que você ative explicitamente a publicação de porta legada para aquele servidor, ou adicione seu próprio IP sob Endereços confiáveis de um app, o que abre um proxy restrito a esse único endereço, não a porta em si.

Como o agente realmente conversa com o plano de controle

Essa é a parte que vale a pena ser precisa, porque a resposta honesta é mais sutil do que “só de saída”. O agente faz duas coisas ao mesmo tempo. Ele disca para fora, para o plano de controle, como um cliente gRPC para se registrar e enviar um heartbeat a cada 10 segundos, carregando métricas de CPU, memória, disco, processo e tráfego, por uma conexão que o agente sempre inicia. Separadamente, ele também roda seu próprio servidor gRPC, escutando em 0.0.0.0:50052, que é o que a regra do UFW acima abre. O plano de controle disca diretamente para essa porta para o trabalho real: deploys, streaming de logs, rodar um comando dentro de um container, backup e restauração, upgrades de sistema operacional. Esse caminho de entrada, não um só de saída, é o que roda deploys e logs desde o início, e ainda é o que os roda hoje.

Existe um RPC de streaming mais novo, iniciado pelo agente, no protocolo (Connect), construído especificamente para sobreviver a um servidor sem alcançabilidade de entrada alguma, atrás de NAT sem redirecionamento de porta. No momento desta publicação, ele só prova que o agente consegue manter um stream persistente de saída e trocar pings; ele ainda não carrega deploys ou nenhum dos RPCs mais pesados. O comentário no código sobre isso diz claramente: o caminho existente de entrada “permanece intocado e continua sendo como tudo realmente funciona hoje.” Se você está decidindo se abre a porta 50052 de entrada, essa é a resposta real: sim, hoje, essa porta ser alcançável a partir do plano de controle da Railyard é como o agente recebe instruções.

Toda chamada, em qualquer direção, carrega um token de portador único para aquele servidor. No próprio plano de controle hospedado da Railyard, todo agente também roda com TLS mútuo: um certificado por servidor emitido pela própria autoridade certificadora da Railyard, com o servidor validando o certificado de cliente do plano de controle e vice-versa, aplicado recusando conectar um agente em texto puro de forma alguma em vez de degradar silenciosamente. Um plano de controle self-hosted e de locatário único sem uma CA configurada pode rodar o agente em um modo de texto puro, só com token de portador, em vez disso, o que é uma troca deliberada disponível para alguém rodando o próprio plano de controle, não o padrão no produto hospedado.

O que o agente muda daqui para frente, não só na conexão

Depois da configuração inicial, três coisas rodam continuamente ou em resposta a instruções do plano de controle:

WireGuard, quando a rede privada é ativada para a equipe, como uma interface chamada ry0. Ele instala wireguard-tools se estiver faltando, gera um par de chaves guardado em /etc/railyard/wg.key, e adiciona peers (outros servidores da equipe) por chave pública e endpoint conforme o plano de controle os reporta, removendo qualquer peer que não esteja mais nessa lista. Rede cobre como os apps realmente se referenciam entre si assim que isso está ativado.

ActiveProtect, que vigia o padrão específico de um scanner: uma resposta 404 a um caminho de requisição que combina com sondas conhecidas de scanner de vulnerabilidade (/.env, /wp-admin, xmlrpc.php, phpmyadmin, e similares). Três acertos do mesmo IP dentro de um minuto o fazem ser bloqueado por 24 horas, aplicado com uma cadeia iptables (RAILYARD-BAN) inserida em INPUT e DOCKER-USER, nunca tocando um endereço privado ou de loopback independente de como ele se comporte. Isso é separado da proteção contra força bruta de SSH, que é a própria jail sshd do fail2ban, instalada sob demanda na primeira vez que o ActiveProtect é ativado, não algo que isso inventa por conta própria.

Atualizações desacompanhadas, além da passagem automática noturna configurada no momento da conexão, também podem ser disparadas sob demanda a partir da própria página do servidor: instalar tudo, ou só atualizações de segurança, com ou sem o reinício que terminar elas às vezes exige. Nada reinicia o servidor sem isso ser uma escolha explícita do seu lado.

O que nunca é tocado

Suas próprias chaves SSH permanecem exatamente como estavam. As chaves públicas de membros da equipe são adicionadas dentro de um bloco claramente delimitado em authorized_keys (“railyard team keys: begin / end”), e só dentro desse bloco; qualquer coisa que você mesmo adicionou, antes ou depois, é deixada em paz, e remover um membro remove só a linha dele. Veja Teams, SSO e acesso para como essa lista de chaves realmente é gerenciada por equipe. O próprio sshd_config nunca é editado diretamente. O que o agente de fato adiciona, uma vez, é um arquivo drop-in em /etc/ssh/sshd_config.d/00-railyard.conf que desliga a autenticação por senha e define login root só por chave, e só se o seu sshd_config já suportar drop-ins e pelo menos um login real baseado em chave já existir, verificado primeiro para que isso não possa te trancar fora. Ele valida a configuração com sshd -t antes de recarregar e reverte automaticamente se o sshd rejeitar ela. Defina RAILYARD_SSH_HARDENING=off no arquivo de ambiente do agente para parar isso completamente. Containers que você já tinha rodando antes de conectar o servidor nunca são inspecionados, parados ou tocados por nenhum passo acima.

Desconectar e cancelar não são a mesma coisa, e o código os trata de forma diferente

Cancelar uma assinatura da Railyard não toca em um servidor de forma alguma; é uma flag de nível de cobrança, e nada no código conecta ela a parar ou desconectar qualquer coisa. Essa parte se confirma exatamente como você esperaria: seus apps são containers em um servidor cobrado pelo seu provedor de nuvem, e perder o acesso ao painel não alcança aquele servidor.

Clicar em Desconectar em um servidor específico é uma ação diferente e deliberada, e não é uma operação vazia para os apps nele. O controlador de desconexão para todo app naquele servidor primeiro (um docker stop gracioso, dando a cada processo o tempo limite de encerramento dele, seguido de docker rm -f) antes de perguntar o que fazer com os próprios registros de app (arquivar ou excluir), e só então desatribui o servidor da equipe. O próprio Caddy nunca é parado por isso, então ele continua rodando, mas com todo backend para o qual ele estava roteando desaparecido, não há nada deixado para ele servir. Se você está desconectando um servidor especificamente para entregá-lo a outra pessoa com os apps dele ainda rodando, isso não é o que o botão Desconectar de hoje faz; ele é construído para devolver um servidor de forma limpa, não para uma entrega ao vivo.

Verifique você mesmo

Nada do que foi dito acima deveria ser aceito por fé. Em qualquer servidor que você conectou:

# o agente, rodando e reiniciando por conta própria se ele crashar
systemctl status railyard-agent
journalctl -u railyard-agent -n 50 --no-pager

# o que realmente está escutando, e em qual interface
ss -tlnp

# as regras de firewall atualmente aplicadas
sudo ufw status numbered

# containers realmente rodando, por nome
docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'

# a interface de rede privada, se ativada
sudo wg show

# a cadeia de bloqueio que o ActiveProtect mantém
sudo iptables -L RAILYARD-BAN -n

# atualizações desacompanhadas, realmente ativadas
cat /etc/apt/apt.conf.d/20auto-upgrades

# o drop-in de SSH, se presente, e nada mais no sshd_config alterado
cat /etc/ssh/sshd_config.d/00-railyard.conf 2>/dev/null || echo "not present"

Se qualquer coisa em uma versão futura deste post não bater com o que você vê na sua própria máquina, isso é um bug que vale a pena reportar, não um exercício de confiança.

Perguntas frequentes

O agente precisa de uma porta de entrada aberta, ou é só de saída?

Hoje, os dois: ele disca para fora para registro e heartbeats, e também roda o próprio servidor gRPC na porta 50052 ao qual o plano de controle se conecta para deploys, logs e comandos. Existe um caminho só de saída no protocolo para servidores sem alcançabilidade de entrada alguma, mas ele ainda não carrega comandos reais; o caminho de entrada é o que realmente roda as coisas agora.

Conectar um servidor toca no meu acesso SSH existente?

Suas próprias chaves e o sshd_config são deixados em paz. O agente adiciona as chaves de membros da equipe dentro do próprio bloco delimitado dele em authorized_keys, e, se sua configuração suportar drop-ins e um login real baseado em chave já existir, adiciona um arquivo drop-in que desativa a autenticação por senha. Os dois são reversíveis, e o passo de hardening de SSH pode ser desligado completamente com uma variável de ambiente.

O que acontece com meus containers se eu parar de pagar pela Railyard?

Nada. Cancelar uma assinatura é uma flag de cobrança sem caminho de código que para, remove ou desconecta qualquer coisa; seus containers continuam rodando no seu próprio servidor exatamente como estavam.

O que acontece com meus containers se eu clicar em Desconectar em um servidor?

Eles são parados e removidos, de forma graciosa, antes do servidor ser desatribuído da equipe. Isso é diferente de cancelar uma assinatura, e vale saber antes de clicar nisso em um servidor que você realmente quer manter rodando sem supervisão.

O tráfego entre meus apps no mesmo servidor é privado por padrão?

Sim, sem configuração alguma: referências no mesmo servidor resolvem por um alias de rede Docker automaticamente. Entre servidores, é privado assim que você ativa a rede WireGuard da equipe; até lá, uma referência entre servidores ainda resolve, só que pelo endereço público normal do app em vez de um privado.

Leia o código, não só este post.

Tudo descrito aqui é o que realmente roda quando você conecta um servidor. Verifique você mesmo com os comandos no final, na sua própria máquina.

Teste de 14 dias em todos os planos. Um preço fixo por equipe, seus servidores ao preço do seu provedor.

Tema
Cores