Documentación

Instalar, usar, eliminar.

Todo lo que necesitas para usar RainServer 1.0. Breve, porque el programa se explica solo por el camino.

Instalación

Entra en el panel, pulsa «Add server» y ejecuta en el servidor el comando que aparece. El token funciona una vez y caduca a las 24 horas.

Ejecútalo como usuario con sudo
curl -fsSL https://raincleaner.eu/rainserver/install.sh | sudo sh -s -- --token YOUR_TOKEN

Añade --dry-run para ver qué haría sin cambiar nada. El instalador:

  • comprueba el sistema: Linux, systemd, x86_64 o ARM64
  • descarga un binario por HTTPS y verifica su firma Ed25519 y su SHA-256
  • instala /usr/local/bin/rainserver y el servicio rainserver-agent
  • vincula el servidor a tu cuenta y arranca el agente

Compatible: Ubuntu 20.04+, Debian 11+, Rocky Linux, AlmaLinux y RHEL 8+. Clave pública para tus propias comprobaciones: rainserver-signing.pub

Primeros pasos

  1. 1sudo rainserver abre el panel de terminal.
  2. 2sudo rainserver fix lista en qué puede ayudar; sudo rainserver fix ID explica un hallazgo y pregunta antes de aplicarlo.
  3. 3sudo rainserver clean lista qué se puede eliminar y qué riesgo tiene.
  4. 4Abre el panel web: todos los servidores, alertas, historial, automatización y facturación.

Comandos

rainserverPanel de terminal
rainserver statusResumen en una pantalla
rainserver scan [--json]Escaneo completo: métricas, hallazgos, candidatos a limpieza
rainserver fix [ID] [--yes]Listar hallazgos con corrección, o explicar y aplicar uno
rainserver clean [--safe] [--item ID] [--yes] [--confirm ID]Listar o eliminar elementos de limpieza; DANGER necesita --confirm con el id del elemento
rainserver security | services | docker | backups | netUna sección del escaneo
rainserver history [N]Las últimas N acciones registradas
rainserver backup add NAME PATH HOURSVigilar una ubicación de copias (carpeta o patrón)
rainserver critical add UNITNo reiniciar nunca esta unit sin una persona
rainserver mute ID / unmute IDOcultar o mostrar un hallazgo
rainserver link TOKEN / unlinkVincular o desvincular de tu cuenta
rainserver update [--check]Instalar la última versión firmada
rainserver uninstallEliminar RainServer por completo

Teclado

La app de terminal está pensada para el teclado. El pie siempre muestra las teclas que funcionan en la pantalla actual.

Tab / ← →Cambiar de sección
↑ ↓Moverse
1Panel
FFix My Server
CLimpieza
USeguridad
VServicios
DDocker
NRed
BCopias
LLogs
SEscaneo completo
SpaceSeleccionar un elemento de limpieza
EnterEjecutar la corrección o limpieza seleccionada (pregunta antes)
HAyuda
QSalir

Niveles de riesgo

Cada hallazgo y cada acción tiene uno de estos niveles. El nivel decide cuánto pregunta RainServer antes de ejecutar nada.

SAFEUna confirmación para el grupo. La lista de elementos está a una tecla.
REVIEWAbres la categoría y la confirmas por separado.
DANGERNunca automático. Muestra el impacto; en los críticos hay que escribir el nombre.
MANUAL ONLYRainServer no lo ejecutará. Explica el hallazgo y te deja la decisión.

Copias

RainServer no hace copias de seguridad. Indícale dónde acaban tus copias y qué antigüedad puede tener el archivo más reciente:

Alerta cuando el archivo más reciente tiene más de 26 horas
sudo rainserver backup add db-nightly /var/backups/db 26

Automatización

En el panel, en Automation: un nivel de aprobación, una ventana de mantenimiento y las tareas que permite tu plan. REVIEW, DANGER y MANUAL nunca son automáticos. Protege una unit de reinicios automáticos con:

Nunca se reinicia sin una persona
sudo rainserver critical add mysql

Alertas

Los canales se configuran en Settings: email para propietarios y administradores, un bot de Telegram, un webhook de Discord o tu propio webhook HTTPS (JSON). Una alerta se abre cuando el problema aparece en dos informes seguidos, y un servidor cuenta como fuera de línea tras 5 minutos sin informe.

API

Los planes Business y Agency pueden crear tokens en Settings. Envíalos como token Bearer. Límite: 600 peticiones por hora.

GET /api/v1/serversTodos los servidores con estado, CPU, discos y hallazgos
GET /api/v1/servers/IDUn servidor con su última instantánea completa
GET /api/v1/alertsAlertas abiertas
POST /api/v1/servers/ID/actionsEncolar una acción (Agency, token de escritura): scan, service.restart, docker.restart, updates.security
Ejemplo
curl -H "Authorization: Bearer rsk_..." https://raincleaner.eu/rainserver/app/api/v1/servers

Archivos y datos

/usr/local/bin/rainserverEl programa (un único binario estático)
/etc/systemd/system/rainserver-agent.serviceEl agente en segundo plano
/etc/rainserver/config.jsonAjustes: copias, units críticas, hallazgos ocultos, vínculo con tu cuenta
/var/lib/rainserver/history.jsonlHistorial local de acciones (solo se añade)

Actualizar y desinstalar

Comprueba el manifiesto de versión firmado y la suma de comprobación, sustituye el binario y reinicia el agente
sudo rainserver update
Detiene el agente y elimina el binario, el servicio, la configuración y el historial
sudo rainserver uninstall

Comprobaciones que puedes hacer hoy

RainServer no es magia. La mayoría de sus comprobaciones parten de comandos que ya conoces: los ejecuta, lee juntas las salidas y explica el resultado. Aquí tienes algunos. Solo leen; ninguno cambia nada.

Uso de disco e inodos
df -h / /var && df -i /
Cuánto espacio ocupa el journal de systemd
journalctl --disk-usage
Espacio usado por imágenes, contenedores, volúmenes y caché de build
docker system df
Units que están caídas ahora mismo
systemctl --failed
Qué escucha, en qué puerto y qué proceso lo tiene
ss -tulpn
La configuración de SSH que realmente está en vigor
sshd -T | grep -Ei '^(permitrootlogin|passwordauthentication)'
Empezar

Funcionando en tu servidor en dos minutos.

  1. Crea una cuentaEntra con tu email. La prueba de 7 días para un servidor empieza en el acto; sin tarjeta.
  2. Añade tu servidorCopia el comando de instalación del panel y ejecútalo con sudo. Muestra qué va a instalar y comprueba la firma de la descarga.
  3. ÁbreloEjecuta sudo rainserver para el panel de terminal, o abre el panel web.
Prueba gratis
El comando que te da el panel
curl -fsSL https://raincleaner.eu/rainserver/install.sh | sudo sh -s -- --token YOUR_TOKEN

¿Quieres leerlo antes? install.sh · Documentación de instalación

  • Ubuntu, Debian, Rocky, AlmaLinux, RHEL
  • x86_64 y ARM64
  • Se elimina por completo con un comando