free-dynamic-qr
Generador de códigos QR dinámicos y acortador de URLs auto-hospedado en Cloudflare Workers y KV. Permite cambiar destinos sin reimprimir códigos físicos.
Ficha actualizada 22 sept 2026, 16:14 · upstream 10 sept 2026, 12:46 · release sin release detectada
Qué es free-dynamic-qr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Free Dynamic QR es una solución de código abierto para crear un sistema propio de generación de códigos QR dinámicos y acortamiento de URLs, ejecutándose completamente sobre la infraestructura gratuita de Cloudflare Workers y Cloudflare KV. A diferencia de los servicios comerciales que requieren suscripciones o tienen límites estrictos, esta herramienta permite gestionar enlaces redireccionables sin coste alguno, aprovechando la red global de edge de Cloudflare para una latencia mínima en las redirecciones.
La arquitectura se basa en un Worker de JavaScript que gestiona la lógica de redirección y el almacenamiento persistente se realiza mediante un namespace KV. El sistema incluye un panel de administración protegido por contraseña, lo que permite a los usuarios crear, editar, descargar y eliminar códigos QR desde una interfaz web sencilla. Una característica clave es la capacidad de actualizar la URL de destino en cualquier momento sin necesidad de generar un nuevo código QR físico, lo cual es ideal para campañas de marketing o promociones temporales.
El despliegue no utiliza contenedores Docker ni archivos de composición, sino que se configura directamente a través del panel de control de Cloudflare. El usuario debe crear una cuenta, configurar un namespace KV y pegar el código fuente en el editor del Worker. Aunque la complejidad técnica es baja, requiere conocimientos básicos para vincular las variables de entorno y configurar los bindings correctamente.
- Crear códigos QR dinámicos para campañas de marketing que puedan redirigirse a diferentes ofertas sin cambiar el código impreso.
- Gestionar un acortador de URLs propio para compartir enlaces personales o de organización con control total sobre la redirección.
- Implementar una solución de autenticación o acceso mediante códigos QR en eventos, donde el destino del enlace pueda actualizarse dinámicamente.
- Proveer a clientes o socios un sistema de seguimiento de tráfico básico sin depender de servicios externos de pago.
- Códigos QR verdaderamente dinámicos: la URL de destino puede modificarse en cualquier momento desde el panel de administración sin necesidad de generar nuevos códigos.
- Coste cero de alojamiento: utiliza el plan gratuito de Cloudflare Workers, que incluye hasta 100.000 peticiones diarias y almacenamiento KV ilimitado en el tier gratuito.
- Alta disponibilidad y rendimiento: las redirecciones se procesan en los puntos de presencia (PoP) globales de Cloudflare, garantizando baja latencia para los usuarios finales.
- Panel de administración seguro: acceso protegido por contraseña para gestionar todos los enlaces y códigos QR desde una interfaz web intuitiva.
- Dependencia del servicio gratuito de Cloudflare: el rendimiento puede verse afectado si se superan los límites de peticiones diarias del plan gratuito (100.000 peticiones/día).
- Configuración manual requerida: no existe un botón único para desplegar; es necesario configurar manualmente el Worker, el namespace KV y las variables de entorno en el panel de Cloudflare.
- Sin persistencia de datos externa: los datos se almacenan exclusivamente en Cloudflare KV. Si la cuenta de Cloudflare se suspende o borra, los códigos QR dejan de funcionar.
- No incluye autenticación avanzada: la protección del panel depende únicamente de una contraseña simple configurada por el usuario, sin integración con OAuth o SSO.
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.
Desplegar en Cloudflare Workers y Pages. Requiere crear un namespace KV y vincularlo como variable QR_KV en las bindings del Worker. El código fuente debe pegarse manualmente en el editor de Workers. Configurar una contraseña maestra en la primera visita para proteger el panel de administración. No requiere Docker ni archivos de composición.
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.