Ackfield

Technical Union · Ackfield

Ackfield-Receive para Windows

Instale el servidor MQTT y el panel de la oficina con un asistente guiado. Descargue un .exe, elija carpeta, inicie sesión con su token — el asistente configura Docker, MQTT y firewall. Sin PowerShell de su parte.

Descargar asistente (v1.0.0)AckfieldInstall-…-setup.exe · Windows 10/11Avanzado: descargar kit zipTeléfonos de campo: descargar Ackfield-Send para Android

Antes de empezar

  • Windows 10 u 11 en el PC de la oficina
  • Docker Desktop instalado y en ejecución
  • Clave de licencia de Technical Union (ACKF-…)
  • Usuario y token de Technical Union — los ingresa en la página Iniciar sesión del asistente

Docker Desktop debe estar instalado y en ejecución antes de abrir el asistente.

Red y seguridad

  • IP fija en la LAN

    Configure una reserva DHCP o IP estática en el PC de la oficina para que su dirección (p. ej. 192.168.1.50) no cambie tras reiniciar. Los teléfonos con Ackfield-Send necesitan una dirección estable en su Wi‑Fi.

  • MQTT cifrado (puerto 8883)

    Si usa TLS, asegúrese de que el antivirus o software de seguridad no bloquee el puerto 8883 ni intercepte tráfico TLS local (inspección SSL). Excluya el PC de la oficina o los puertos MQTT del escaneo SSL si fallan las conexiones.

Asistente de instalación

Ejecute AckfieldInstall-…-setup.exe (Ejecutar como administrador si Windows lo pide). El asistente lo guía paso a paso.

  1. Bienvenida — Pulse Siguiente para comenzar.
  2. Carpeta de instalación — Elija dónde instalar (C:\AckfieldInstall por defecto está bien).
  3. Iniciar sesión — Use el usuario y token proporcionados por su proveedor. Descargan Ackfield-Receive — no son su contraseña de Windows. Puede pegar en el campo del token.
  4. Instalando — El asistente crea carpetas MQTT, inicia sesión en el registro de contenedores, inicia Mosquitto y Ackfield-Receive y abre puertos LAN (3000, 1883, 8883). Espere a que termine.
  5. Finalizado — Abra la URL que aparece al terminar (p. ej. http://192.168.1.50:3000).
  6. En el navegador — Complete la configuración de la oficina:
    • Conexión → Licencia — acepte la EULA, ingrese la clave y active
    • Conexión — guarde el broker; genere un código de emparejamiento para teléfonos Ackfield-Send
    • Usuarios — agregue usuarios MQTT → Aplicar al broker

Qué ejecuta el asistente automáticamente

PasoAcción
MQTTCrea C:\mqtt\config y C:\mqtt\data desde la plantilla del kit
DockerInicia sesión con su token e inicia Mosquitto + Ackfield-Receive
FirewallAbre puertos LAN 3000, 1883, 8883
Instalación manual y mantenimiento (opcional)

Kit zip: descomprima AckfieldInstall y haga doble clic en Install Ackfield.cmd como administrador.

Inicializar carpetas MQTT:

powershell -ExecutionPolicy Bypass -File scripts\init-mqtt-config.ps1

Confirme que .env.docker tiene MQTT_CONFIG_DIR=C:/mqtt y ACKFIELD_RECEIVE_IMAGE configurado (viene en el kit), luego:

docker login ghcr.io
docker compose -f docker-compose.customer.yml --env-file .env.docker up -d
docker ps

Firewall (administrador):

powershell -ExecutionPolicy Bypass -File scripts\allow-lan-ports.ps1

Detener o reiniciar (desde la carpeta de instalación):

powershell -ExecutionPolicy Bypass -File .\install-office.ps1 -Stop
powershell -ExecutionPolicy Bypass -File .\install-office.ps1 -Restart

Solución de problemas

ProblemaQué revisar
Docker no está en ejecuciónInicie Docker Desktop y vuelva a ejecutar el asistente
pull access deniedVuelva a ejecutar el asistente e ingrese usuario + token en la página Iniciar sesión
El asistente falló a mitadAbra la carpeta de instalación (p. ej. C:\AckfieldInstall), revise install-log.txt, confirme que Docker está en ejecución y haga doble clic en Install Ackfield.cmd
Mosquitto se detienedocker logs mosquitto — revise certificados TLS si el puerto 8883 está activo; confirme que el antivirus no bloquea el 8883
Fallo TLS / MQTT cifradoLa inspección SSL del antivirus puede bloquear el puerto 8883 — agregue una exclusión para el PC de la oficina o desactive el escaneo SSL para MQTT local
El teléfono no conectaVuelva a ejecutar el asistente como administrador; en Conexión genere un código de emparejamiento; en el teléfono use la dirección del PC + código; use IP LAN (no localhost); confirme reserva DHCP o IP estática
Fallo de licenciaAcceso a internet a key.tu.biz; una instalación por clave de licencia