Cómo instalar ALMC SHIELD, paso a paso

¿No has usado nunca una consola? Tranquilo. Son 4 pasos y te explicamos cada uno como si fuera la primera vez.

1. Consigue tu «llave» (API key)

   Entra en tu panel de ALMC SHIELD → Ajustes. Verás un código que empieza por ab_live_…. Esa es tu API key: cópiala, la usarás en el paso 3. ¿Aún no tienes cuenta? Créala gratis aquí.

2. Entra en tu servidor

   «Entrar en el servidor» significa abrir una ventana negra donde se escriben comandos. Tienes dos formas:

   • Si tu servidor tiene panel (aaPanel, Plesk, cPanel, ISPConfig…): busca el botón «Terminal» y ábrelo. Ya estás dentro.
   • Si no tienes panel: en tu ordenador abre una terminal y escribe ssh root@LA-IP-DE-TU-SERVIDOR (sustituye por la IP que te dio tu proveedor). Te pedirá la contraseña.

   En Windows usa PowerShell (ya viene incluido) o el programa gratuito PuTTY. En Mac/Linux, la app «Terminal».

3. Pega este único comando

   Copia la línea de abajo, cambia ab_live_XXXXXXX por tu API key del paso 1, pégala en la ventana y pulsa Enter:

   Copiarcurl -sSL https://almc.es/abuse-shield/install.sh | sudo bash -s -- --api-key=ab_live_XXXXXXX

   Eso es todo. El instalador hace el resto solo: detecta tu sistema, instala el agente, lo arranca y lo deja vigilando.

4. Comprueba que funciona

   Escribe esto para ver si está en marcha (debe decir active (running)):

   Copiarsystemctl status almc-shield

   O más fácil: vuelve a tu panel de ALMC SHIELD → sección Servidores. En menos de un minuto verás aparecer tu servidor en la lista. 🎉

   ¡Listo! Tu servidor ya comparte y recibe IPs atacantes de toda la red ALMC SHIELD.

Copiar[agent]
api_key = ab_live_XXXXXXX
api_url = https://almc.es/api/v1/abuse
hostname = web-01.example.com

[fail2ban]
log_path = /var/log/fail2ban.log
poll_seconds = 30
report_jails = sshd, nginx-botsearch, recidive
default_bantime = 3600

[blocklist]
download_enabled = true
refresh_seconds = 600
output_file = /etc/almc-shield/blocklist.txt
on_update_command = /usr/sbin/ipset restore -! < /etc/almc-shield/blocklist.txt

[network]
timeout_seconds = 30
retry_max = 5
proxy = 

Copiar# docker-compose.yml
services:
  almc-shield:
    image: ghcr.io/almc-security/almc-shield:1.0
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/log/fail2ban.log:/var/log/fail2ban.log:ro
      - /etc/almc-shield:/etc/almc-shield:ro
      - almc-shield-state:/var/lib/almc-shield
    environment:
      - ALMC_API_KEY=ab_live_XXXXXXX
volumes:
  almc-shield-state:

Copiarcurl -sSL https://almc.es/abuse-shield/uninstall.sh | sudo bash

Cinco pasos sencillos. Cada uno con su captura real para que no te pierdas.

1. Crea tu cuenta gratis y copia tu API key

   Regístrate sin tarjeta en ALMC SHIELD. Una vez dentro, en Ajustes verás tu API key (empieza por ab_live_…). Cópiala: la pegarás en el paso 4.

   

2. Descarga el plugin

   Descarga el archivo .zip del plugin (es gratis y de código abierto). No descomprimas el zip, WordPress lo necesita tal cual.

   Descargar plugin WordPress

3. Súbelo a WordPress y actívalo

   En tu panel de WordPress ve a Plugins → Añadir nuevo → Subir plugin, elige el zip que descargaste y pulsa Instalar ahora. Cuando termine, pulsa Activar.

   

   

4. Pega tu API key y conecta

   En el menú lateral entra en ALMC Shield, pega la API key del paso 1 en su casilla y pulsa Guardar / Probar conexión. En unos segundos sincroniza la lista de IPs.

   

5. Enciende el firewall (y no te dejes fuera)

   Activa el interruptor del firewall. Antes, añade tu propia IP al Allowlist para no bloquearte a ti mismo (de todas formas, el plugin nunca bloquea el panel de administración: es anti-lockout por diseño).

   

   ¡Listo! Las IPs maliciosas reciben un 403 antes de cargar tu web. Sin frenar a tus visitantes reales.

Cinco pasos con capturas reales del back office de PrestaShop.

1. Crea tu cuenta gratis y copia tu API key

   Regístrate sin tarjeta en ALMC SHIELD y copia tu API key (ab_live_…) desde Ajustes.

   

2. Descarga el módulo

   Descarga el .zip del módulo. No lo descomprimas: PrestaShop lo sube tal cual.

   Descargar módulo PrestaShop

3. Súbelo desde el Gestor de módulos

   En el back office ve a Módulos → Gestor de módulos y pulsa «Subir un módulo» (arriba a la derecha). Elige el zip y espera a que se instale.

   

4. Configura y pega tu API key

   Pulsa «Configurar» en el módulo, pega tu API key y guarda. El módulo sincroniza la lista de IPs al instante.

   

5. Enciende el firewall

   Activa el firewall y añade tu IP al allowlist. El back office (/admin…) nunca se bloquea: anti-lockout por diseño.

   

   ¡Listo! Tu tienda bloquea bots y fuerza bruta antes de que toquen PrestaShop.

Magento instala sus módulos por línea de comandos. Son 3 órdenes; te las damos listas para copiar.

1. Crea tu cuenta gratis y copia tu API key

   Regístrate sin tarjeta en ALMC SHIELD y copia tu API key (ab_live_…) desde Ajustes.

   

2. Copia el módulo a tu Magento

   Descarga el módulo y copia su contenido en app/code/Almc/Shield dentro de tu instalación de Magento (por FTP/SSH).

   Descargar módulo Magento 2

3. Actívalo con 3 comandos

   Desde la carpeta raíz de Magento, en la consola del servidor, ejecuta:

   Copiarphp bin/magento module:enable Almc_Shield
   php bin/magento setup:upgrade
   php bin/magento cache:flush

   Si tu tienda está en modo producción, añade php bin/magento setup:di:compile después de setup:upgrade.

4. Configura y pega tu API key

   En el panel de Magento ve a Stores → Configuration → ALMC Shield, pega tu API key y guarda. Sincroniza la reputación de IPs al instante.

   

5. Enciende el firewall

   Activa el firewall y añade tu IP al allowlist. El área /admin de Magento nunca se bloquea: anti-lockout por diseño.

   

   ¡Listo! Tu Magento bloquea IPs maliciosas en el hook más temprano, sin penalizar el rendimiento.