Cómo instalar el Fing Agent en Docker para Linux

Esta guía te guiará por el proceso de instalación de la imagen de Fing-Agent en un dispositivo que admite contenedores Docker.  Sigue estas instrucciones paso a paso para instalar correctamente la imagen de Docker y configurar el contenedor de Fing-Agent.

Requisitos previos

• Asegúrate de que Docker esté instalado y en ejecución. Para las instrucciones, consulta la guía de instalación de Docker.
• Una conexión activa a Internet.

Actualmente, la imagen de Fing Agent es compatible con ARM-64 y AMD-64 mediante una única imagen multi-arquitectura. En el futuro podrían añadirse arquitecturas adicionales a medida que el producto evolucione y mejore.

Antes de comenzar

Ten en cuenta lo siguiente antes de continuar con la instalación:

• Sistemas operativos no compatibles: Las instalaciones de Fing Agent en Docker no están soportadas en Windows ni macOS.
• Un solo agente por dispositivo: Solo puede ejecutarse una instancia de Fing Agent por dispositivo. Si ya tienes Fing Agent instalado mediante Snap en el mismo equipo, debes desinstalarlo antes de usar la versión Docker.
• Limitaciones de migración desde Snap: Actualmente no se admite la migración de la versión Snap de Fing Agent a Docker. Si estás ejecutando un Fing Agent con Snap en el mismo dispositivo, debes desactivarlo, desinstalar la versión Snap e instalar la versión Docker desde cero.

Instalar y ejecutar la imagen de Docker usando Docker Compose

Fing Agent puede descargarse y configurarse automáticamente usando instrucciones definidas en un archivo de Docker Compose. 

• Verifica que puedes ejecutar definiciones de Docker Compose ejecutando el siguiente comando: 

docker compose (para versiones recientes de Docker)
docker-compose (para versiones antiguas de Docker)

• Abre una shell en tu dispositivo —o accede mediante una shell remota— y ejecuta el siguiente comando para instalar el contenedor Docker de Fing Agent:

curl https://get.fing.com/fing-docker/compose.yaml -o compose.yaml
docker compose up -d (para versiones recientes de Docker)
docker-compose up -d (para versiones antiguas de Docker)

Este comando:

• Descargará el archivo de docker compose: el archivo define todo lo necesario para ejecutar el servicio.
• Lanzará el nuevo contenedor: se creará un nuevo contenedor tras descargar la última imagen de Fing-Agent y se ejecutará como servicio en segundo plano.

Instalar la imagen de Docker manualmente

• Abre una shell en tu dispositivo —o accede mediante una shell remota— y ejecuta el siguiente comando para instalar el contenedor Docker de Fing Agent:

sudo docker run --network=host --cap-add NET_ADMIN --publish 44444:44444 \
  -d --restart=always --name FingAgent \
  -v fing-data-volume:/app/fingdata fing/fing-agent:latest

Este comando:

• Descargará la última imagen: la imagen de la cuenta oficial de Fing se descarga de forma segura desde DockerHub.
• Modo de red: Ejecuta el contenedor en modo de red host para capacidades de red óptimas. Esto le otorgará acceso al sistema de red subyacente, necesario para que el agente funcione correctamente.
• Capacidades: Añade la capacidad NET_ADMIN necesaria para la administración de red.
• Mapeo de puertos: Publica el puerto 44444 para anunciar su estado mediante UPnP.
• Persistencia de volumen: Usa el volumen fing-data-volume para conservar datos (configuración y registros) entre reinicios del contenedor.

Tras la instalación, Fing Agent se iniciará automáticamente y quedará disponible para su activación.

Desinstalar la versión Snap

Si estás migrando desde una instalación previa con Snap, sigue estos pasos:

• Desactiva el Fing Agent basado en Snap en tu cuenta. Desde la app móvil, abre la lista de redes y mantén pulsado o desliza para mostrar las acciones sobre esa red. Selecciona «Deactivate» para desactivar la imagen Snap.
• Desinstala la versión Snap:

sudo snap remove fing-agent

• Continúa con la instalación en Docker usando las instrucciones anteriores.

Cómo activar tu Fing Agent

Ya has iniciado correctamente el contenedor ejecutando la imagen de Fing Agent en tu dispositivo. Para activar el agente necesitarás:

• La App de Fing funcionando en tu móvil
• Una suscripción activa

Abre la App de Fing en tu móvil, selecciona la pestaña Cuenta, toca Agregar unidad de monitoreo y sigue las instrucciones en pantalla para iniciar el procedimiento de activación.

Mantener tu Fing Agent actualizado

Los contenedores Docker se crean a partir de imágenes Docker, que son instantáneas del sistema de archivos que incluyen el sistema operativo y los paquetes preinstalados de Fing Agent. Estas imágenes base se actualizan periódicamente para incorporar parches de seguridad, correcciones y mejoras.

Sin embargo, una vez construido un contenedor Docker, no hereda automáticamente las actualizaciones de su imagen base. Como resultado, los contenedores pueden quedar desactualizados y potencialmente vulnerables si no se actualizan manualmente. Automatizar el proceso de actualización ayuda a mantener los contenedores seguros y eficientes sin intervención constante. 

Recomendamos encarecidamente instalar una solución para automatizar las actualizaciones de imágenes base de contenedores Docker, como Watchtower.