Generación sin servidor de código QR microsoft permanente

Tutoriales prácticos sobre IAActualizado hace 3 meses Sharenet.ai

614 0

Introducción general

serverless-qrcode-hub es una herramienta de código abierto diseñada para resolver el problema de los frecuentes fallos de los códigos QR en los chats de grupo de WeChat. Se basa en Cloudflare trabajadores y base de datos D1 , sin necesidad de servidores tradicionales para ejecutar . Los usuarios pueden generar código QR grupo WeChat permanentemente válida para facilitar la gestión de chat de grupo , mientras que el apoyo a cualquier enlace largo a un enlace corto . El proyecto proporciona un backend de gestión que permite a los usuarios actualizar el código QR o el contenido del enlace corto en cualquier momento, y soporta estilos personalizados y protección por contraseña. El despliegue es sencillo, la cuota gratuita es suficiente para el uso diario, adecuado para individuos, equipos o desarrolladores. El código está disponible públicamente en GitHub, y la comunidad es libre de optimizarlo y ampliarlo.

Lista de funciones

Genere permanentemente un código QR válido para el chat en grupo de WeChat para resolver el problema del fallo.
Convierte enlaces largos en enlaces cortos para compartirlos y distribuirlos fácilmente.
Compatibilidad con estilos de código QR personalizados, incluidos colores, bordes y logotipos.
Proporcionar backend de gestión para actualizar el contenido del código QR o enlace corto en cualquier momento.
Admite protección por contraseña para restringir el acceso no autorizado.
Basado en Cloudflare Workers y base de datos D1, no requiere servidores.
Código fuente abierto con soporte para modificaciones y ampliaciones por parte de los usuarios.
Limpia automáticamente los datos caducados para mantener la eficiencia de tu sistema.

Utilizar la ayuda

Instalación y despliegue

serverless-qrcode-hub se ejecuta utilizando la plataforma Cloudflare Workers y no requiere un servidor tradicional. Aquí están los pasos detallados de despliegue:

Regístrese para obtener una cuenta de Cloudflare
Visite el sitio web de Cloudflare para registrarse y obtener una cuenta gratuita. Las cuentas existentes pueden iniciar sesión directamente.
Creación de una base de datos D1
Inicie sesión en el panel de control de Cloudflare y vaya a Trabajadores y páginas > D1 > Crear base de datos.
- Asigne un nombre a la base de datos, por ejemplo qrcode-db.
- Copie el ID de la base de datos después de la creación y utilícelo más tarde.
Repositorio GitHub
entrevistas Almacén de proyectosA continuación, haz clic en el botón "Fork" de la esquina superior derecha para copiar el repositorio en tu cuenta de GitHub.
compilador wrangler.toml
En su repositorio Fork, abra el archivo wrangler.toml haga clic en el botón Editar. Busque el campo [d1_databases] En parte database_id Sustitúyalo por el ID de la base de datos D1 copiado en el paso 2. ejemplo:
```
[[d1_databases]]
binding = "DB"
database_name = "qrcode-db"
database_id = "<你的数据库ID>"
```
Guarde y confirme los cambios.
Creación de un trabajador de Cloudflare
Vuelva al panel de control de Cloudflare y seleccione Trabajadores y páginas > Crear trabajador.
- Nombre del trabajador, por ejemplo qrcode-hub.
- Haz clic en Configuración > Integración Git y selecciona el repositorio de GitHub con el que estás trabajando.
- Haga clic en "Guardar y desplegar".
Vincular nombres de dominio personalizados (opcional)
Después de una implementación correcta, Cloudflare proporciona el valor predeterminado *.workers.dev Nombre de dominio. Si se requiere un acceso más rápido o la creación de una marca:
- Vaya a "Trabajadores" > "Activadores" > "Añadir dominio personalizado".
- Introduzca un subdominio alojado en Cloudflare (p. ej. qr.example.com).
- Siga las instrucciones para completar la configuración DNS.
Establecer una contraseña de acceso
En el panel de control de Cloudflare, vaya a Configuración del trabajador y busque la sección Variables de entorno. Añada la variable PASSWORDel valor es una contraseña personalizada (se recomienda una combinación de letras y números, por ejemplo, dos cadenas UUID como a1b2c3d4-e5f6g7h8). Una vez guardada, deberá introducir esta contraseña para acceder al backend de administración.
Validación de la implantación
Una vez finalizado el despliegue, el acceso a los *.workers.dev o un dominio personalizado. Si ve la página de inicio de sesión, la implantación se ha realizado correctamente.

Instrucciones de actualización

La versión antigua del proyecto (basada en Cloudflare KV, versión ≤ v1.2.0) ya no se recomienda debido a las restricciones de cuota libre. La nueva versión se basa en la base de datos D1 y admite 5 millones de lecturas para un rendimiento más estable.

Guía de migración: Referencia MIGRATE.md.
Versión antigua del documento: Ver README.v1.md.

Utilización de las funciones principales

Una vez completado el despliegue, los usuarios pueden acceder a la herramienta a través de su navegador. A continuación se detalla el procedimiento de funcionamiento:

Generar código QR microsoft permanente

Acceso al fondo de gestión
Abra el dominio Trabajadores (por ejemplo https://qrcode-hub.<你的账户>.workers.dev) o un nombre de dominio personalizado. Introduzca la contraseña establecida para iniciar sesión.
Añadir enlace WeChat
En el fondo de administración, haz clic en "Añadir código QR de WeChat".
- Introduce el enlace original al chat de grupo de WeChat (normalmente un enlace de código QR temporal).
- Opcionalmente, puede cargar un logotipo (se recomienda el formato PNG/JPG, de menos de 100x100 píxeles).
- Ajuste el color o el borde del código QR (por defecto, primer plano negro, fondo blanco).
- Haga clic en "Generar".
Obtener código QR y enlace corto
El sistema devuelve la imagen del código QR y un enlace corto (p. ej. https://qr.example.com/abc123) Escanea el código QR para unirte directamente al chat de grupo, y el enlace corto se puede compartir en WeChat u otras plataformas.
Actualizar enlace de chat de grupo
Si el enlace original del chat de grupo no funciona, ve al fondo de administración, busca el registro del código QR correspondiente y actualízalo a un nuevo enlace de chat de grupo. Tras la actualización, el código QR y el enlace corto permanecen inalterados, por lo que los usuarios no necesitan volver a compartirlos.

Servicio de acortamiento de URL

Añadir enlace largo
En el panel de administración, haga clic en "Añadir enlace corto común".
- Pegue cualquier enlace largo (por ejemplo, un artículo o la dirección de descarga de un archivo).
- Sufijos de enlaces cortos opcionalmente personalizables (p. ej. abc123).
- Haga clic en "Generar".
Obtener enlace corto
El sistema devuelve un enlace corto en el que hacer clic para comprobar si salta a la página original. Los enlaces cortos pueden utilizarse en redes sociales, correo electrónico y otros escenarios.
Gestión de enlaces cortos
Ver todos los enlaces cortos en el backend de administración, admitir la edición, eliminación o visualización de registros de salto.

Estilos de códigos QR personalizados

Ajuste de la apariencia
Cuando añada un código QR, haga clic en "Opciones avanzadas".
- Cargar logotipo (para mejorar la imagen de marca)
- Seleccione los colores de primer plano y de fondo (para garantizar un alto contraste y facilitar el escaneado).
- Ajuste la anchura del borde o el efecto de esquinas redondeadas.
Previsualizar y guardar
Haga clic en "Vista previa" para ver el efecto y confirme para generar el código QR final.

Gestión de la protección mediante contraseña

Cada vez que acceda al backend de administración, deberá introducir la contraseña que estableció en el momento de la implantación.
Para cambiar su contraseña, actualícela en el panel de control de Cloudflare PASSWORD y volver a desplegar el trabajador.

advertencia

ración: Las cuentas gratuitas de Cloudflare Workers ofrecen 100.000 peticiones al día y la base de datos D1 soporta 5 millones de lecturas, suficiente para uso personal. Para escenarios de alto tráfico, puede actualizar a un plan de pago.
copia de seguridadLa base de datos D1 almacena todos los datos de códigos QR y enlaces cortos y se recomienda exportar copias de seguridad regularmente (a través de las acciones del panel de control de Cloudflare).
Velocidad del dominio: Default *.workers.dev El nombre de dominio en algunas zonas de acceso es lento, se recomienda vincular un nombre de dominio personalizado.
fianzaLas contraseñas deben ser lo suficientemente complejas para evitar filtraciones. El contenido de los enlaces cortos y los códigos QR debe ser legal y conforme a la normativa.

operación de muestreo

Crear enlaces cortos: Entrada https://example.com/long-urlGenere https://qr.example.com/xyz789, haga clic en el salto de prueba.
Crear un código QR para WeChat: Introduzca el enlace del chat de grupo, cargue el logotipo, genere el código QR y, a continuación, guarde la imagen para compartirla con el grupo WeChat o el círculo de amigos.
actualizar un registro: Busque el registro del código QR en el fondo de gestión, sustituya el enlace no válido y confirme que el usuario puede seguir utilizando el código QR original.

Con estos pasos, los usuarios pueden desplegar rápidamente serverless-qrcode-hub para generar códigos QR permanentes o enlaces cortos. El backend de gestión es intuitivo y no requiere experiencia en programación para empezar.

escenario de aplicación

Gestión de grupos WeChat
Los administradores de grupos necesitan compartir el código QR del chat de grupo durante mucho tiempo. serverless-qrcode-hub genera un código QR permanente que evita la molestia de los cambios frecuentes, y los miembros pueden escanear el código para unirse en cualquier momento.
Actividades de marketing
Los comerciantes pueden convertir los enlaces de inscripción en enlaces cortos y códigos QR, imprimirlos en folletos o publicarlos en las redes sociales. Los logotipos personalizados mejoran la imagen de marca y el panel de administración permite actualizar los enlaces en cualquier momento.
Compartir contenidos
Los blogueros o creadores acortan los enlaces a artículos y vídeos, generan códigos QR y los incrustan en tarjetas de visita o carteles para facilitar el acceso de los seguidores.
Educación y formación
Las organizaciones de formación convierten los enlaces de los cursos en códigos QR y los imprimen en libros de texto o anuncios. Los alumnos pueden escanear el código para matricularse, y las actualizaciones de los enlaces no afectan al uso del código QR.
Promoción de proyectos de código abierto
Los desarrolladores convierten los enlaces a repositorios de GitHub en enlaces cortos, generan códigos QR y los comparten con comunidades o documentos para facilitar el acceso.

CONTROL DE CALIDAD

¿Se invalidará el código QR generado?
Mientras Cloudflare Workers y la base de datos D1 funcionen correctamente, el código QR será válido para siempre. Incluso si el enlace original del chat de grupo no funciona, se puede actualizar a través del backend de administración y no es necesario sustituir el código QR.
¿Necesito experiencia en programación para implantarlo?
No es necesario. La instalación se realiza sólo paso a paso, y la interfaz de backend de gestión es amigable y apta para usuarios cero básicos.
¿Es suficiente una cuenta gratuita?
La cuota gratuita de Cloudflare (100.000 solicitudes/día, 5 millones de lecturas de bases de datos) es suficiente para un individuo o un equipo pequeño. Los escenarios con mucho tráfico pueden considerar un plan de pago.
¿Cómo protege sus datos?
Los datos se almacenan en la base de datos D1 y la contraseña protege el backend de administración. Se recomienda hacer copias de seguridad periódicas de la base de datos y establecer contraseñas complejas.
¿Qué enlaces son compatibles?
Admite cualquier URL legal, incluidos enlaces WeChat, páginas web, descargas de archivos, etc. Se recomienda comprobar la validez del enlace antes de generarlo.
¿Cómo se actualizan los usuarios antiguos?
consulta MIGRATE.mdLa nueva versión del código se volvió a desplegar migrando los datos de KV a la base de datos D1.