friendly-lite-server
Servidor autoalojado ligero para Friendly Captcha, compatible con PHP 7.4+, ideal para proyectos pequeños y no comerciales. Ofrece verificación básica de captchas con soporte Docker y Composer.
Ficha actualizada 18 sept 2026, 18:47 · upstream 2 feb 2024, 10:52 · release 0.2.1
Qué es friendly-lite-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una implementación ligera del servicio Friendly Captcha para autoalojamiento. Está diseñado específicamente para proyectos pequeños o hobby que requieren verificación de captchas sin depender completamente del servicio comercial. La solución utiliza PHP 7.4 o superior con soporte de sodium y apcu, permitiendo verificar desafíos de captcha localmente en tu infraestructura.
La implementación incluye endpoints para puzzle.php y siteverify.php, reemplazando las llamadas a la API oficial de Friendly Captcha. Soporta contenedores Docker con variables de entorno configurables como SECRET, API_KEY, LOG_FILE y opciones de escalabilidad. El software está licenciado bajo Apache 2.0 con cláusula de atribución Commons, permitiendo uso no comercial o interno.
Las características principales incluyen verificación de firmas, puzzles, timestamps, detección de replay attacks y escalado básico de dificultad. Los tests se ejecutan con PHPUnit y XDebug para cobertura de código. Es importante verificar la disponibilidad de LibSodium y APCU antes del despliegue.
- Proyectos personales o hobby que requieren captchas sin depender del servicio comercial
- Implementaciones internas en empresas para proyectos no comerciales
- Autoalojamiento en servidores pequeños con recursos limitados
- Pruebas de concepto para integración con Friendly Captcha
- Educación y aprendizaje sobre implementación de sistemas anti-spam
- Licencia Apache 2.0 con cláusula de atribución, permitiendo uso no comercial
- Soporte nativo para Docker y docker-compose con variables de entorno configurables
- Verificación completa: firmas, puzzles, timestamps y replay attacks
- Escalado básico de dificultad según probabilidad de usuario real
- Tests automatizados con PHPUnit y reporte de cobertura de código
- Requisitos claros: PHP 7.4+, sodium, apcu documentados
- Solo para proyectos no comerciales o internos (licencia restrictiva)
- Requiere infraestructura propia con PHP 7.4+ instalado
- Dependencia de LibSodium y APCU que deben estar disponibles
- Escalabilidad limitada comparado con la versión comercial
- Sin soporte oficial ni SLA garantizado
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar en servidor web con PHP 7.4+. Configurar Env.php copiando desde Env.template.php. Asegurar disponibilidad de LibSodium y APCU. Para Docker: docker build -t friendly-lite-server . Luego docker run -d -p 80:80 -e "SECRET=..." -e "API_KEY=..." friendly-lite-server. Verificar logs en /puzzle.php manualmente si hay errores.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.