Folder Guard — Protected By ZeroBot

¿Qué es Folder Guard?

Folder Guard es un pequeño paquete PHP que instalas en tu propio servidor.
Una vez que una carpeta está protegida, cada solicitud que recibe se verifica con tu cuenta de ZeroBot antes de que se cargue la página — así los bots son detenidos mientras los visitantes reales pasan sin ninguna molestia.

Se conecta a tu cuenta de ZeroBot existente mediante tu clave de licencia, de modo que tu lista blanca, lista negra, registros de tráfico y ajustes se mantienen sincronizados con tu panel principal.
No se almacena nada con terceros.

Cómo funciona la protección

Cuando un visitante abre una carpeta protegida, el guardián se ejecuta antes que tu página y le pregunta a ZeroBot si la solicitud proviene de un bot o de un humano, y luego aplica la regla que hayas elegido:

• Se carga automáticamente en cada solicitud dentro de una carpeta protegida (mediante .user.ini o .htaccess).
• Cada solicitud se decide en tiempo real consultando tu cuenta de ZeroBot — sin caché obsoleta.
• Está diseñado para fallar en modo abierto: si ZeroBot llegara a no estar disponible, tu sitio sigue funcionando con normalidad.
• Cada visita se registra en tu cuenta, por lo que aparece tanto en el paquete como en tu panel principal de ZeroBot.

Requisitos

• PHP 8.1 o más reciente.
• Apache (mod_php), o PHP-FPM / FastCGI / LiteSpeed — el paquete configura ambos automáticamente.
• Una clave de licencia de ZeroBot activa (la encuentras en tu panel, en la sección Perfil).
• Un espacio de dominio libre en tu plan.
  Folder Guard autoriza tu dominio automáticamente, lo que usa uno de los espacios de dominio de tu plan.

Autorización del dominio

Cuando conectas Folder Guard por primera vez, autoriza tu dominio automáticamente, siempre que haya un espacio libre en tu plan.
Solo añade el dominio en el momento de conectar — así que si luego lo quitas desde tu panel, el guard lo respeta: deja de proteger y muestra un aviso claro de «no protegido» en lugar de volver a añadirlo en silencio.

Autorizar un dominio usa uno de los espacios de dominio de tu plan.
Si no hay ningún espacio libre, el dominio no se puede autorizar — y hasta que lo esté, Folder Guard no puede proteger tus carpetas y los visitantes simplemente pasan.
Libera un espacio eliminando un dominio sin usar en tu panel, o mejora tu plan para añadir más.

Instala en 4 pasos

No se requiere código ni línea de comandos — solo súbelo y ábrelo en tu navegador.

Proteger una carpeta

Abre la pestaña Carpetas protegidas, introduce la ruta absoluta de la carpeta que quieres proteger (el campo viene rellenado previamente con la raíz de tu sitio) y haz clic en Proteger carpeta.
El guardián se activa de inmediato en Apache y en unos cinco minutos en PHP-FPM.

Lo que protege Folder Guard — y lo que no

Folder Guard actúa en la capa PHP: cada petición que ejecuta PHP dentro de una carpeta protegida se verifica antes de cargar la página.
Desde la v1.3.0 también puede enrutar archivos estáticos a través de PHP, cubriendo páginas y recursos de texto.

Folder Guard protege

• Páginas y scripts PHP dentro de una carpeta protegida — index.php, contact.php, paneles de administración, áreas de miembros, cualquier archivo .php.
• Páginas estáticas (.html, .htm) por defecto, más recursos de texto opcionales (.css, .js, .json, .xml, .svg, .txt) que actives en Ajustes → Extensiones protegidas — cada uno servido con su tipo de contenido correcto.
• El visitante es bloqueado, desafiado o registrado antes de enviar contenido alguno, y las páginas HTML permitidas llevan la insignia y el script de huella digital.
  Los archivos estáticos protegidos se envían con no-store: el navegador nunca guarda una copia que pueda eludir la protección.

Folder Guard no protege

• Imágenes y otros archivos binarios — imágenes, PDF, vídeos, fuentes y descargas.
  No pueden enrutarse por PHP de forma segura, así que la protección nunca se ejecuta para ellos.
• Tipos estáticos que no hayas activado — solo .html y .htm están cubiertos por defecto; el resto de recursos de texto queda sin proteger hasta activarlos en Extensiones protegidas.
• Archivos PHP fuera de la carpeta protegida, o alojamientos donde no se pudo activar el mecanismo auto-prepend.
  El enrutado de estáticos requiere además Apache o LiteSpeed — en PHP-FPM/nginx puro usa el modo Include, que solo cubre .php.
• Copias ya almacenadas por un CDN antes de activar la protección — la decisión se toma en el momento de la petición en tu servidor; purga la caché del CDN tras proteger una carpeta.

Reglas de protección

En Ajustes decides, por separado, qué ocurre con los bots y con los humanos reales:

Cuando se detecta un bot

• Bloquear — mostrar una página limpia de "acceso denegado".
• Desafiar — presentar el captcha deslizante de ZeroBot; al resolverlo, el visitante puede pasar.
• Redirigir — enviar al visitante a la URL que elijas.
• Solo registrar — anotar la visita pero no bloquear (ideal para pruebas).

Cuando visita un humano real

• No hacer nada — dejarlo pasar directamente (la opción predeterminada).
• Desafiar — pedir incluso a los humanos que resuelvan el captcha.
• Bloquear — denegar el acceso a todos (útil para cerrar por completo una carpeta).
• Redirigir — enviar a los humanos a otra URL.

El captcha de ZeroBot

Cuando la regla de desafío está activa, los presuntos bots ven el auténtico captcha deslizante de ZeroBot.
Una vez que un visitante lo resuelve, obtiene un pase de corta duración y no se le vuelve a desafiar — exactamente el mismo captcha que se usa en toda la plataforma de ZeroBot.

Huella de dispositivo (opcional)

Puedes activar el script de huella de dispositivo de ZeroBot desde Ajustes.
Recoge más de 40 señales del navegador (canvas, WebGL, audio, zona horaria y más) en las páginas protegidas para puntuar a cada visitante.
Un visitante limpio pasa sin molestias; uno de riesgo moderado ve un captcha rápido para demostrar que es humano; uno de alto riesgo se bloquea automáticamente — sin necesidad de una regla adicional.

Lista blanca & Lista negra

Permite o bloquea IPs concretas directamente desde el paquete.
Como está sincronizado con tu cuenta de ZeroBot, cada cambio se aplica en todos los lugares donde tu cuenta protege — y también aparece en tu panel principal.

Tráfico & Registros

La pestaña Tráfico muestra los veredictos en tiempo real de cada solicitud, igual que tu panel principal:

• IP, estado (bot o humano), la página visitada, el navegador, el sistema operativo y el país.
• Filtra por página, navega por el historial paginado y borra el registro cuando quieras.
• Un Registro de actividad anota cada cambio que haces en la lista blanca y en la lista negra.
• Activa Eliminar duplicados para contar cada visitante una sola vez por carpeta — una página, sus recursos (.css, .js) y las recargas rápidas desde la misma IP se agrupan en un único visitante, y los recursos se agrupan bajo su página en lugar de aparecer cada uno en su propia fila.

Activar & desactivar la protección

Un único interruptor en Ajustes pausa o reanuda la protección en todas las carpetas a la vez, sin borrar tu configuración.
Desactivada, cada visitante simplemente pasa — útil para el mantenimiento.
La protección solo funciona de verdad mientras tu dominio está autorizado: si no lo está, la tarjeta de Ajustes muestra «Activado, pero sin proteger» y cada página protegida muestra un pequeño aviso de «Protección desactivada» hasta que autorices el dominio.

Solución de problemas

Si una carpeta protegida sigue dejando pasar a los visitantes, revisa estos cuatro puntos.
Cubren los pocos casos en los que la activación necesita un pequeño empujón.

Solo protege las solicitudes PHP

Folder Guard funciona mediante auto_prepend_file de PHP, por lo que solo se activa en las solicitudes que gestiona PHP.
Las páginas estáticas .html, las imágenes o una carpeta servida sin PHP no quedan protegidas.
Apúntalo a la carpeta que ejecuta tu aplicación PHP, o añádelo al punto de entrada de esa aplicación.

Activación en cPanel / LiteSpeed

En LiteSpeed la opción vive en .user.ini y se almacena en caché durante unos 5 minutos, así que no es instantánea.
Cambiar tu versión de PHP en Seleccionar versión de PHP fuerza una nueva lectura.
Si aun así no se activa, puede que tu proveedor no respete .user.ini ni php_value en .htaccess.
Activa la extensión PHP htscanner en Seleccionar versión de PHP y Extensiones para que funcione.
Mantén también la extensión curl activada, porque Folder Guard la usa para llegar a la API.

Los bots pasan pero aparecen en los registros

Eso significa que la acción para bots está configurada en Registrar, que anota los bots sin detenerlos.
Abre Ajustes y configura la acción para bots en Bloquear, o Desafío, para detenerlos de verdad.

Conectado en el panel, pero no se registra nada

La protección lee tu licencia de un archivo llamado .env.php dentro de la carpeta de instalación, no de .env.example, que es solo una muestra y nunca debe editarse.
El panel puede parecer conectado gracias a la sesión de tu navegador aunque falte este archivo.
Si moviste o renombraste la carpeta de instalación, solo abre Ajustes una vez y Folder Guard vuelve a guardar la licencia automáticamente.

Gracias

¿Necesitas ayuda?
Contáctanos en nuestro canal de Telegram o en support@zerobot.info — estaremos encantados de ayudarte con la configuración.