Guía de despliegue

Instalar Huginn en un VPS: automatización self-hosted

Desplegar en un VPS Cloud →

Tutorial

Instalar Huginn en un VPS: automatización self-hosted

Automatización3 min de lectura6 pasos

Huginn es una plataforma de agentes autónomos: usted crea «agentes» que vigilan páginas web, flujos RSS o API, y que después disparan acciones (correo electrónico, webhook, scraping) en cadena. Es una alternativa self-hosted a los servicios de automatización propietarios. Le mostramos cómo desplegarlo en un VPS con Docker, base de datos y reverse proxy seguro.

Contenido· Por qué autoalojar Huginn en un VPS1/4
  1. 01Por qué autoalojar Huginn en un VPS
  2. 02Los beneficios concretos del autoalojamiento
  3. 03Requisitos de hardware y software
  4. 04Despliegue paso a paso

Por qué autoalojar Huginn en un VPS

Allí donde Node-RED orquesta flujos mediante arrastrar y soltar, Huginn razona en términos de agentes que se suscriben y emiten «events». Su gran fuerza es la vigilancia de la web: un Website Agent extrae el contenido de una página mediante selectores CSS o XPath, detecta los cambios y dispara otro agente cuando se cumple una condición. Se utiliza para seguir un precio, vigilar una disponibilidad, agregar fuentes RSS o recibir una alerta cuando una página cambia, sin depender de IFTTT o Zapier, que cobran y limitan las ejecuciones. Autoalojado en un VPS, Huginn funciona de forma permanente, mantiene sus escenarios y sus credenciales en privado, y no tiene ningún límite impuesto en el número de agentes o de comprobaciones.

Los beneficios concretos del autoalojamiento

  • Agentes de vigilancia web mediante selectores CSS/XPath, con detección de cambios.
  • Escenarios en cadena: un event de un agente dispara la acción de otro.
  • Alertas por correo electrónico, webhook, Telegram o SMS según una condición personalizada.
  • Agregación de flujos RSS y de múltiples API en un único panel.
  • Sin límite de ejecuciones ni facturación por tarea, al contrario que en los SaaS.
  • Credenciales y escenarios de vigilancia conservados en privado en su VPS.

Requisitos de hardware y software

Huginn es una aplicación Ruby on Rails acompañada de una base de datos (MySQL/MariaDB o PostgreSQL) y de workers en segundo plano, lo que lo hace más exigente que Node-RED. Prevea un VPS de 2 vCPU y 2 GB de RAM como mínimo, y más bien 4 GB si ejecuta numerosos agentes en paralelo. Calcule de 10 a 20 GB de disco para la aplicación, la base de datos y el historial de events. En cuanto al software: Ubuntu 22.04, Docker y Docker Compose (la vía más sencilla, que incluye app + base de datos + worker), una cuenta SMTP para las notificaciones por correo electrónico y un subdominio del tipo agents.mondomaine.com.

Despliegue paso a paso

  1. Preparar la stack

    Por SSH, instale Docker y Docker Compose. Obtenga el docker-compose.yml oficial de Huginn, que define tres servicios: la aplicación web, la base de datos y el worker que ejecuta los agentes a intervalos regulares.

  2. Configurar las variables de entorno

    Indique las variables críticas: APP_SECRET_TOKEN (generado con openssl rand -hex 64), DOMAIN=agents.mondomaine.com y los parámetros SMTP (SMTP_USER_NAME, SMTP_PASSWORD, SMTP_SERVER) para activar las notificaciones y la creación de cuentas.

  3. Arrancar e inicializar la base de datos

    Inicie con docker compose up -d. En el primer arranque, Huginn crea el esquema de la base de datos y una cuenta de administrador por defecto (admin / password): conéctese y cambie esa contraseña de inmediato.

  4. Verificar el worker

    Compruebe que el worker funciona con docker compose logs -f. Es él quien despierta a los agentes según su planificación (schedule): sin un worker activo, sus agentes de vigilancia no se ejecutan nunca.

  5. Poner el reverse proxy y el SSL

    Coloque Caddy o Nginx delante del puerto 3000 expuesto por Huginn para agents.mondomaine.com, con certificado Let's Encrypt. Compruebe que DOMAIN se corresponde con el dominio público, de lo contrario los enlaces de los correos electrónicos estarán rotos.

  6. Crear un primer agente

    En la interfaz, cree un Website Agent que vigile una página, configure la extracción CSS y enlácelo después con un Email Agent. Lance un «Dry Run» para validar la extracción antes de activar la planificación.

Para un scraping fiable, pruebe sus selectores CSS/XPath con el «Dry Run» de cada agente antes de planificarlo: verá los events producidos sin disparar ninguna acción real. Combine un Website Agent con un Event Formatting Agent y un Trigger Agent (condición sobre un valor) para recibir una alerta únicamente cuando se cruce un umbral —por ejemplo, un precio que baja por debajo de un objetivo— en lugar de ser notificado en cada comprobación. Recuerde ajustar schedule de forma razonable (cada hora en lugar de cada minuto) para que los sitios vigilados no le bloqueen.

Despliega Huginn en tu VPS ServOrbit con un solo clic

ServOrbit despliega Huginn con PostgreSQL 16 y un worker integrado en tu VPS Cloud en minutos — credenciales de administrador autogeneradas, reverse proxy nginx configurado. Tus agentes vigilan la web 24/7 sin límites de ejecución.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva