Configuración de VPS & Nube

Aprende cómo desplegar y configurar tu Servidor RoqueOS en un VPS (Servidor Privado Virtual) para obtener acceso global 24/7 a tu propia plataforma en la nube.

---

¿Qué es un VPS?

Un Servidor Privado Virtual es una máquina virtual que alquilas mensualmente de un proveedor de nube. Es la forma ideal de mantener tu Servidor RoqueOS en línea en todo momento, con internet de alta velocidad, sin consumir la energía de tu computadora local y con direcciones IP públicas confiables.

---

Proveedores Recomendados

Proveedor	Destacado	Costo
Oracle Cloud	Nivel "Siempre Gratis" con instancias ARM	Gratis (difícil de aprobar)
Hetzner	Instancias ARM súper baratas y potentes	€4–10/mes
DigitalOcean	Fácil para principiantes, excelente documentación	$6–12/mes
Contabo	Precios inmejorables por cantidades masivas de RAM y CPU	$5–15/mes

---

Requisitos Mínimos Recomendados

Para una experiencia fluida con RoqueOS y la capacidad de instalar aplicaciones Docker:

Recurso	Mínimo	Recomendado
RAM	2 GB	4 GB o más
CPU	2 vCPUs	4 vCPUs
Disco	20 GB SSD	40 GB+ NVMe
SO	Ubuntu 22.04 LTS	Ubuntu 24.04 LTS
Arquitectura	amd64 o arm64	arm64 (mejor valor)

---

Paso a Paso: Desde Cero al Servidor

1. Alquilar y acceder al VPS

Después de alquilar tu VPS y recibir las credenciales, accede a través de SSH:

ssh root@TU_IP_VPS

2. Actualizar el sistema e instalar Docker

apt update && apt upgrade -y
curl -fsSL https://get.docker.com | sh

3. Instalar Servidor RoqueOS

curl -fsSL https://roqueos.com.br/install.sh | bash

O utiliza la instalación manual con docker compose como se describe en la página de instalación.

---

Configuración del Firewall

UFW (Linux)

sudo ufw allow 22/tcp    # SSH
sudo ufw allow 27021/tcp # Servidor RoqueOS
sudo ufw enable

Firewall del Proveedor

En proveedores como Oracle Cloud, AWS, GCP y Azure, también necesitas abrir el puerto en su panel web:

1. Ve a la configuración de red de tu instancia.
2. Añade una Regla de Ingreso.
3. Permite el tráfico TCP en el puerto 27021 (origen: 0.0.0.0/0).

---

Cómo Acceder

Una vez que el servidor esté en funcionamiento y el firewall esté abierto, tienes dos formas de conectarte:

Opción 1: Conexión Directa

Accede utilizando la IP pública del VPS:

http://TU_IP_VPS:27021

ADVERTENCIA DE CONTENIDO MIXTO

Si usas RoqueOS a través de la versión web oficial HTTPS (https://roqueos.com.br), el navegador bloqueará conexiones HTTP puras. Usa un túnel de Cloudflare o configura HTTPS para eludir esto.

Opción 2: Túneles de Cloudflare (Recomendado)

Para mayor seguridad y conveniencia. El túnel le da a tu servidor un dominio seguro (https://...) sin exponer puertos en el firewall. El propio Servidor RoqueOS tiene integración nativa con los Túneles de Cloudflare directamente desde el Panel de Administración.

Resultado: https://tu-tunel.trycloudflare.com

Para configurar, ve al Panel de Administración → Cloudflare y sigue las instrucciones en la interfaz.

---

Consejos de Rendimiento y Estabilidad

Crear un Archivo Swap

Si tu VPS tiene poca RAM (1–2 GB), el Swap es esencial para evitar caídas:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Configurar Reinicio Automático

Asegúrate de que tu docker-compose.yml incluya restart: unless-stopped en todos los servicios. El script de instalación automática lo configura por defecto.

Copias de Seguridad Regulares

Realiza copias de seguridad regulares de la carpeta ./data donde se encuentra el docker-compose.yml. Esta contiene:

• La base de datos SQLite con Claves API y configuraciones
• Metadatos de los contenedores y preferencias del administrador

tar -czf roqueos-backup-$(date +%Y%m%d).tar.gz ./data