← Blog Seguridad y arquitectura BYOC • 10 min de lectura Lo que realmente pasa en tu servidor cuando conectas Railyard: una auditoría línea por línea de nuestra arquitectura de Docker, Caddy, firewall y cero lock-in
La mayoría de los ingenieros de DevOps que no quieren probar un agente de PaaS no se oponen a la idea en sí. Se oponen a no saber qué hace: qué se instala, qué puertos se abren, si llama a casa o acepta conexiones, y qué queda atrás si se van. Eso es razonable querer tenerlo respondido antes de correr algo como root en una máquina de producción. Así que este artículo se salta el marco habitual de “lo que Railyard hace por ti” y en su lugar describe, desde el código fuente real, qué pasa entre hacer clic en Conectar un servidor y que el agente reporte estar listo, qué cambia de forma continua, y qué hace el código al desconectar, ya que esto último no coincide con la lectura más simple de nuestras propias preguntas frecuentes.
Conectar un servidor: los pasos reales
Conectar un servidor es un trabajo en segundo plano que abre una sesión SSH con la clave que proporcionas (o una que Railyard generó, si le pediste que creara el servidor) y corre una secuencia fija de comandos. En orden:
- Docker, instalado a través del script oficial
get.docker.comsi no está ya presente. Si no te conectas como root, tu usuario se agrega al grupodockerpara que los pasos siguientes no necesitensudoen cada llamada de Docker. - Un swapfile de 2 GB en
/swapfile, creado solo si no existe ya swap, convm.swappinessfijado en 10. Los servidores de build obtienen uno más grande, dimensionado para dejar suficiente margen para un build en curso. - Reglas de UFW para los puertos 22, 80, 443 y 50052, y luego UFW se fuerza a activarse si estaba instalado pero apagado. Si UFW no está instalado en absoluto, este paso se salta y se registra, no se asume silenciosamente.
- Actualizaciones de seguridad desatendidas: el paquete
unattended-upgradesse instala si falta, y se escribe/etc/apt/apt.conf.d/20auto-upgradespara activar actualizaciones nocturnas de la lista de paquetes y actualizaciones de seguridad desatendidas. Este paso nunca dispara un reinicio automáticamente; eso es una acción separada y deliberada desde la propia página del servidor. - nixpacks, para despliegues al estilo buildpack desde un repositorio, a menos que el servidor tenga un rol exclusivo de base de datos.
- El agente mismo: un paquete TLS en
/var/lib/railyard-agent/tlssi la CA del plano de control está configurada (siempre cierto en el plano de control alojado propio de Railyard; se niega a conectar un agente en texto plano en lugar de degradarse silenciosamente), un archivo de entorno en/etc/railyard-agent.env, el binario en/usr/local/bin/railyard-agent, y una unidad systemd (railyard-agent.service) conRestart=always, prioridad elevada de CPU y E/S, yOOMScoreAdjust=-900. El propio comentario del archivo de unidad explica por qué: “el agente es la única forma de alcanzar esta máquina, nunca dejes que un build descontrolado o un contenedor en bucle de crash lo mate de hambre”. - Caddy, como
lucaslorentz/caddy-docker-proxy, corrido con el socket de Docker del host montado para que pueda descubrir contenedores por etiqueta y enrutarles tráfico automáticamente, publicando 80 y 443. Se omite en un servidor exclusivo de base de datos. - Almacenes de datos, si alguno está configurado para ese servidor (Postgres y Redis por defecto; MySQL, ClickHouse, RabbitMQ, MongoDB, InfluxDB, Elasticsearch, MinIO y Memcached son opcionales), cada uno como su propio contenedor con una contraseña generada de 40 caracteres, en una red Docker dedicada
railyard.
Nada en esa secuencia toca un contenedor que ya tuvieras corriendo. Los contenedores nombrados son específicos (railyard-caddy, railyard-postgres, y así sucesivamente), así que la única forma en que esto choca con algo que ya está en la máquina es si por casualidad ya tenías un contenedor con uno de esos nombres exactos.
El firewall, con precisión
Las reglas base de permiso de UFW son 22 (SSH), 80 y 443 (Caddy), y 50052 (el puerto gRPC propio del agente, explicado más abajo). WireGuard, si activas la red privada para el equipo, agrega una regla de permiso UDP en el puerto 51820. Más allá de esa base, el agente puede abrir puertos adicionales por su cuenta, pero solo bajo instrucción del plano de control durante un heartbeat, etiquetados con un comentario railyard-operator en la lista de reglas de UFW para que sean identificables y se eliminen automáticamente en el momento en que ya no se necesiten, por ejemplo cuando apagas una configuración de “más puertos públicos” en una app. Los puertos de almacenes de datos (5432, 6379 y así sucesivamente) no se abren por defecto; se mantienen alcanzables solo en la red Docker privada a menos que actives explícitamente la publicación de puertos heredada para ese servidor, o agregues tu propia IP bajo las Trusted addresses de una app, lo cual abre un proxy limitado a esa única dirección, no al puerto en sí.
Cómo el agente realmente habla con el plano de control
Esta es la parte que vale la pena precisar, porque la respuesta honesta es más matizada que “solo saliente”. El agente hace dos cosas a la vez. Marca hacia afuera al plano de control como cliente gRPC para registrarse y enviar un heartbeat cada 10 segundos, con métricas de CPU, memoria, disco, procesos y tráfico, sobre una conexión que el agente siempre inicia. Por separado, también corre su propio servidor gRPC, escuchando en 0.0.0.0:50052, que es lo que abre la regla de UFW mencionada arriba. El plano de control marca directamente a ese puerto para el trabajo real: despliegues, streaming de logs, correr un comando dentro de un contenedor, copia de seguridad y restauración, actualizaciones del sistema operativo. Esa ruta entrante, no una solo saliente, es sobre la que corren los despliegues y los logs desde el principio, y sigue siendo lo que los corre hoy.
Existe un RPC de streaming más nuevo, iniciado por el agente, en el protocolo (Connect) construido específicamente para sobrevivir en un servidor sin ninguna alcanzabilidad entrante, detrás de NAT sin reenvío de puertos. Al momento de escribir esto, solo demuestra que el agente puede mantener un flujo saliente persistente e intercambiar pings; todavía no lleva despliegues ni ninguno de los RPC más pesados. El comentario del código fuente lo dice claramente: la ruta entrante existente “está intacta y sigue siendo cómo todo realmente funciona hoy”. Si estás decidiendo si abrir el 50052 de forma entrante, esa es la respuesta real: sí, hoy, que ese puerto sea alcanzable desde el plano de control de Railyard es cómo el agente recibe instrucciones.
Cada llamada, en cualquier dirección, lleva un token portador único a ese servidor. En el propio plano de control alojado de Railyard, cada agente además corre con TLS mutuo: un certificado por servidor emitido desde la propia autoridad certificadora de Railyard, con el servidor validando el certificado de cliente del plano de control y viceversa, forzado al negarse por completo a conectar un agente en texto plano en lugar de degradarse silenciosamente. Un plano de control autohospedado y de un solo inquilino sin una CA configurada puede en cambio correr el agente en un modo de solo token portador en texto plano, lo cual es una concesión deliberada disponible para alguien que corre su propio plano de control, no el valor por defecto en el producto alojado.
Lo que el agente cambia hacia adelante, no solo al conectar
Más allá de la configuración inicial, tres cosas corren continuamente o en respuesta a instrucciones del plano de control:
WireGuard, cuando la red privada está activada para el equipo, como una interfaz llamada ry0. Instala wireguard-tools si falta, genera un par de claves guardado en /etc/railyard/wg.key, y agrega peers (otros servidores del equipo) por clave pública y endpoint según los reporta el plano de control, eliminando cualquier peer que ya no esté en esa lista. Networking cubre cómo las apps realmente se referencian entre sí una vez que esto está activado.
ActiveProtect, que vigila el patrón específico de un escáner: una respuesta 404 a una ruta de solicitud que coincide con sondas conocidas de escáneres de vulnerabilidades (/.env, /wp-admin, xmlrpc.php, phpmyadmin, y similares). Tres aciertos desde la misma IP en un minuto la hace caer por 24 horas, forzado con una cadena de iptables (RAILYARD-BAN) insertada tanto en INPUT como en DOCKER-USER, sin tocar nunca una dirección privada o de loopback sin importar cómo se comporte. Esto es separado de la protección contra fuerza bruta en SSH, que es la propia jaula sshd de fail2ban, instalada a demanda la primera vez que se activa ActiveProtect, no algo que esto invente por su cuenta.
Actualizaciones desatendidas, más allá del pase automático nocturno configurado al momento de conectar, también se pueden activar a demanda desde la propia página del servidor: instalar todo, o solo actualizaciones de seguridad, con o sin el reinicio que a veces necesitan para terminar. Nada reinicia el servidor sin que eso sea una elección explícita de tu parte.
Lo que nunca se toca
Tus propias claves SSH se mantienen exactamente como estaban. Las claves públicas de los miembros del equipo se agregan dentro de un bloque claramente delimitado en authorized_keys (“railyard team keys: begin / end”), y solo dentro de ese bloque; cualquier cosa que hayas agregado tú mismo, antes o después, queda intacta, y eliminar a un miembro elimina solo su línea. Mira Teams, SSO and access para saber cómo se gestiona realmente esa lista de claves por equipo. El propio sshd_config nunca se edita directamente. Lo que el agente sí agrega, una vez, es un archivo drop-in en /etc/ssh/sshd_config.d/00-railyard.conf que apaga la autenticación por contraseña y fija el inicio de sesión root solo por clave, y solo si tu sshd_config ya soporta drop-ins y ya existe al menos un inicio de sesión real basado en clave, verificado primero para que esto no pueda dejarte bloqueado. Valida la configuración con sshd -t antes de recargar y revierte automáticamente si sshd la rechaza. Pon RAILYARD_SSH_HARDENING=off en el archivo de entorno del agente para detener esto por completo. Los contenedores que ya tenías corriendo antes de conectar el servidor nunca son inspeccionados, detenidos ni tocados por ningún paso de arriba.
Desconectar y cancelar no son lo mismo, y el código los trata de forma distinta
Cancelar una suscripción de Railyard no toca un servidor en absoluto; es una bandera a nivel de facturación, y nada en el código la conecta con detener o desconectar nada. Esa parte se sostiene exactamente como esperarías: tus apps son contenedores en un servidor que tu proveedor cloud te factura, y perder el acceso al panel no alcanza ese servidor.
Hacer clic en Detach en un servidor específico es una acción distinta y deliberada, y no es un no-op para las apps que hay en él. El controlador de desconexión detiene primero cada app de ese servidor (un docker stop ordenado, dándole a cada proceso su tiempo de espera de apagado, seguido de docker rm -f) antes de preguntar qué hacer con los registros de las apps mismas (archivar o eliminar), y solo entonces desasigna el servidor del equipo. Caddy en sí nunca se detiene por esto, así que sigue corriendo, pero con cada backend al que enrutaba ya desaparecido, no le queda nada que servir. Si estás desconectando un servidor específicamente para entregárselo a alguien más con sus apps todavía corriendo, eso no es lo que hace hoy el botón Detach; está construido para devolver un servidor limpiamente, no para una entrega en vivo.
Verifícalo tú mismo
Nada de lo anterior debería tomarse por fe. En cualquier servidor que hayas conectado:
# the agent, running and restarting on its own if it crashes
systemctl status railyard-agent
journalctl -u railyard-agent -n 50 --no-pager
# what's actually listening, and on which interface
ss -tlnp
# the firewall rules currently applied
sudo ufw status numbered
# containers actually running, by name
docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'
# the private network interface, if turned on
sudo wg show
# the ban chain ActiveProtect maintains
sudo iptables -L RAILYARD-BAN -n
# unattended upgrades, actually enabled
cat /etc/apt/apt.conf.d/20auto-upgrades
# the SSH drop-in, if present, and nothing else in sshd_config changed
cat /etc/ssh/sshd_config.d/00-railyard.conf 2>/dev/null || echo "not present"
Si algo en una futura versión de este artículo no coincide con lo que ves en tu propia máquina, eso es un error que vale la pena reportar, no un ejercicio de confianza.
Preguntas frecuentes
¿El agente necesita un puerto entrante abierto, o es solo saliente?
Hoy, ambas cosas: marca hacia afuera para el registro y los heartbeats, y también corre su propio servidor gRPC en el puerto 50052 al que el plano de control se conecta para despliegues, logs y comandos. Existe una ruta solo saliente en el protocolo para servidores sin alcanzabilidad entrante, pero todavía no lleva comandos reales; la ruta entrante es lo que realmente corre las cosas en este momento.
¿Conectar un servidor toca mi acceso SSH existente?
Tus propias claves y sshd_config se dejan intactas. El agente agrega las claves de los miembros del equipo dentro de su propio bloque delimitado en authorized_keys, y, si tu configuración soporta drop-ins y ya existe un inicio de sesión funcional basado en clave, agrega un archivo drop-in que desactiva la autenticación por contraseña. Ambas cosas son reversibles, y el paso de endurecimiento SSH se puede desactivar por completo con una variable de entorno.
¿Qué pasa con mis contenedores si dejo de pagar Railyard?
Nada. Cancelar una suscripción es una bandera de facturación sin ninguna ruta de código que detenga, elimine o desconecte nada; tus contenedores siguen corriendo en tu propio servidor exactamente como estaban.
¿Qué pasa con mis contenedores si hago clic en Detach en un servidor?
Se detienen y se eliminan, de forma ordenada, antes de que el servidor sea desasignado del equipo. Esto es distinto de cancelar una suscripción, y vale la pena saberlo antes de hacer clic en él en un servidor que realmente quieres mantener corriendo sin supervisión.
¿El tráfico entre mis apps en el mismo servidor es privado por defecto?
Sí, sin ninguna configuración: las referencias dentro del mismo servidor resuelven automáticamente a través de un alias de red Docker. A través de servidores, es privado en cuanto activas la red WireGuard del equipo; hasta entonces, una referencia entre servidores sigue resolviendo, solo sobre la dirección pública normal de la app en lugar de una privada.