Génération sans serveur d'un code QR Microsoft permanent

Introduction générale

serverless-qrcode-hub est un outil open source conçu pour résoudre le problème des échecs fréquents des codes QR dans les chats de groupe WeChat. Il est basé sur les travailleurs Cloudflare et la base de données D1, sans avoir besoin de serveurs traditionnels pour fonctionner. Les utilisateurs peuvent générer un code QR de groupe WeChat valide en permanence pour faciliter la gestion du chat de groupe, tout en prenant en charge n'importe quel lien long vers un lien court. Le projet fournit un backend de gestion qui permet aux utilisateurs de mettre à jour le code QR ou le contenu du lien court à tout moment, et prend en charge les styles personnalisés et la protection par mot de passe. Le déploiement est simple, le quota gratuit est suffisant pour une utilisation quotidienne, et convient aux individus, aux équipes ou aux développeurs. Le code est disponible publiquement sur GitHub, et la communauté est libre de l'optimiser et de l'étendre.

Liste des fonctions

• Générer un code QR valide en permanence pour le chat de groupe WeChat afin de résoudre le problème de l'échec.
• Convertir les liens longs en liens courts pour faciliter le partage et la distribution.
• Prise en charge des styles de codes QR personnalisés, y compris les couleurs, les bordures et les logos.
• Fournir un backend de gestion pour mettre à jour le contenu du code QR ou du lien court à tout moment.
• La protection par mot de passe permet de restreindre l'accès non autorisé.
• Basé sur les travailleurs de Cloudflare et la base de données D1, aucun serveur n'est nécessaire.
• Code source ouvert avec prise en charge des modifications et des extensions par les utilisateurs.
• Nettoie automatiquement les données périmées afin de préserver l'efficacité de votre système.

Utiliser l'aide

Installation et déploiement

serverless-qrcode-hub fonctionne sur la plateforme Cloudflare Workers et ne nécessite pas de serveur traditionnel. Voici les étapes détaillées du déploiement :

1. Ouvrir un compte Cloudflare
   Visitez le site web de Cloudflare pour vous inscrire à un compte gratuit. Les comptes existants peuvent être connectés directement.
2. Création d'une base de données D1
   Connectez-vous au tableau de bord de Cloudflare et allez dans Workers and Pages > D1 > Create Database.
   • Nommez la base de données, par exemple qrcode-db.
   • Copiez l'identifiant de la base de données après la création et utilisez-le ultérieurement.
3. Créer un dépôt GitHub
   entretiens Entrepôt de projetsCliquez ensuite sur le bouton "Fork" dans le coin supérieur droit pour copier le dépôt sur votre compte GitHub.
4. compilateur wrangler.toml
   Dans votre référentiel Fork, ouvrez le fichier wrangler.toml cliquez sur le bouton Modifier. Recherchez le champ [d1_databases] Il s'agit notamment de database_id Remplacer par l'ID de la base de données D1 copiée à l'étape 2. exemple :

   [[d1_databases]]
   binding = "DB"
   database_name = "qrcode-db"
   database_id = "<你的数据库ID>"
   

   Sauvegardez et validez les modifications.

5. Création d'un serveur Cloudflare
   Retournez au tableau de bord de Cloudflare et sélectionnez Workers and Pages > Create Worker.
   • Nom du travailleur, par exemple qrcode-hub.
   • Cliquez sur Configuration > Git Integration et sélectionnez le dépôt GitHub avec lequel vous travaillez.
   • Cliquez sur "Enregistrer et déployer".
6. Lier des noms de domaine personnalisés (optionnel)
   Après un déploiement réussi, Cloudflare fournit l'option par défaut *.workers.dev Nom de domaine. Si un accès plus rapide ou une image de marque est nécessaire :
   • Allez dans "Travailleurs" > "Déclencheurs" > "Ajouter un domaine personnalisé".
   • Entrez un sous-domaine hébergé sur Cloudflare (par ex. qr.example.com).
   • Suivez les invites pour terminer la configuration DNS.
7. Définition d'un mot de passe d'accès
   Dans le tableau de bord de Cloudflare, allez à Worker Settings et trouvez la section Environment Variables. Ajoutez la variable PASSWORDla valeur est un mot de passe personnalisé (une combinaison de lettres et de chiffres est recommandée, par exemple deux chaînes UUID telles que a1b2c3d4-e5f6g7h8). Après avoir sauvegardé, vous devez saisir ce mot de passe pour accéder au backend d'administration.
8. Validation du déploiement
   Une fois le déploiement terminé, l'accès à l'application *.workers.dev ou un domaine personnalisé. Si la page de connexion s'affiche, le déploiement a réussi.

Instructions de mise à niveau

L'ancienne version du projet (basée sur Cloudflare KV, version ≤ v1.2.0) n'est plus recommandée en raison des restrictions de quotas libres. La nouvelle version est basée sur la base de données D1 et prend en charge 5 millions de lectures pour des performances plus stables.

• Guide de migration: Référence MIGRATE.md.
• Ancienne version du document: Voir README.v1.md.

Utilisation des fonctions principales

Une fois le déploiement terminé, les utilisateurs peuvent accéder à l'outil via leur navigateur. Vous trouverez ci-dessous la procédure d'utilisation détaillée :

Générer un code QR Microsoft permanent

1. Accès à l'historique de la gestion
   Ouvrez le domaine des travailleurs (par exemple https://qrcode-hub.<你的账户>.workers.dev) ou un nom de domaine personnalisé. Saisissez le mot de passe défini pour vous connecter.
2. Ajouter un lien WeChat
   Dans l'arrière-plan de l'administration, cliquez sur "Add WeChat QR Code".
   • Saisissez le lien original du chat de groupe WeChat (généralement un lien temporaire de type code QR).
   • En option, vous pouvez télécharger un logo (format PNG/JPG recommandé, moins de 100x100 pixels).
   • Ajustez la couleur ou la bordure du code QR (par défaut, avant-plan noir, arrière-plan blanc).
   • Cliquez sur "Générer".
3. Obtenir le code QR et le lien court
   Le système renvoie des images de codes QR et des liens courts (par ex. https://qr.example.com/abc123) Scannez le code QR pour rejoindre directement le groupe de discussion, et le lien court peut être partagé sur WeChat ou d'autres plateformes.
4. Mise à jour du lien de chat de groupe
   Si le lien de chat de groupe d'origine ne fonctionne pas, accédez à l'arrière-plan de l'administration, trouvez l'enregistrement du code QR correspondant et mettez-le à jour avec un nouveau lien de chat de groupe. Après la mise à jour, le code QR et le lien court restent inchangés, de sorte que les utilisateurs n'ont pas besoin de les partager à nouveau.

Service de raccourcissement d'URL

1. Ajouter un lien long
   Dans le panneau d'administration, cliquez sur "Ajouter un lien court commun".
   • Collez n'importe quel lien long (article, adresse de téléchargement d'un fichier, etc.).
   • Suffixes de liens courts personnalisables en option (par ex. abc123).
   • Cliquez sur "Générer".
2. Obtenir un lien court
   Le système renvoie un lien court sur lequel il faut cliquer pour vérifier s'il renvoie à la page d'origine. Les liens courts peuvent être utilisés dans les médias sociaux, les courriels et d'autres scénarios.
3. Gestion des liens courts
   Afficher tous les liens courts dans le backend de l'administrateur, prendre en charge la modification, la suppression ou l'affichage des enregistrements de sauts.

Style de code QR personnalisé

1. Ajustement de l'apparence
   Lorsque vous ajoutez un code QR, cliquez sur "Options avancées".
   • Télécharger le logo (pour renforcer la marque)
   • Sélectionnez les couleurs de l'avant-plan et de l'arrière-plan (pour assurer un contraste élevé et faciliter la numérisation).
   • Définir la largeur de la bordure ou l'effet de coin arrondi.
2. Prévisualisation et sauvegarde
   Cliquez sur "Aperçu" pour voir l'effet, et confirmez pour générer le code QR final.

Gestion de la protection par mot de passe

• Chaque fois que vous accédez au backend d'administration, vous devez saisir le mot de passe que vous avez défini au moment du déploiement.
• Pour changer votre mot de passe, mettez-le à jour dans le tableau de bord de Cloudflare. PASSWORD et redéployer le travailleur.

mise en garde

• rationLes comptes gratuits de Cloudflare Workers offrent 100 000 requêtes par jour et la base de données D1 prend en charge 5 millions de lectures, ce qui est suffisant pour un usage personnel. Pour les scénarios à fort trafic, vous pouvez passer à un plan payant.
• sauvegarderLa base de données D1 stocke toutes les données relatives aux codes QR et aux liens courts et il est recommandé d'exporter régulièrement des sauvegardes (via le tableau de bord Cloudflare).
• Vitesse du domaine: Défaut *.workers.dev Le nom de domaine dans certaines zones d'accès est lent, il est recommandé de lier un nom de domaine personnalisé.
• cautionLes mots de passe doivent être suffisamment complexes pour éviter les fuites. Le contenu des liens courts et des codes QR doit être légal et conforme.

opération d'échantillonnage

• Créer des liens courts: Entrée https://example.com/long-urlGénérer https://qr.example.com/xyz789cliquez sur le saut de test.
• Créer un code QR WeChatPour cela, il suffit d'entrer le lien du chat de groupe, de télécharger le logo, de générer le code QR, puis d'enregistrer l'image pour la partager avec le groupe WeChat ou le cercle d'amis.
• mettre à jour un enregistrementLe code QR est enregistré dans l'arrière-plan de gestion, le lien invalide est remplacé et l'utilisateur peut continuer à utiliser le code QR d'origine.

Avec ces étapes, les utilisateurs peuvent rapidement déployer serverless-qrcode-hub pour générer des codes QR permanents ou des liens courts. Le backend de gestion est intuitif et ne nécessite aucune expérience en programmation pour démarrer.

scénario d'application

1. Gestion du groupe WeChat
   Les administrateurs de groupes ont besoin de partager le code QR du groupe de discussion pendant une longue période. serverless-qrcode-hub génère un code QR permanent qui évite les changements fréquents, et les membres peuvent scanner le code pour se joindre à tout moment.
2. Activités de marketing
   Les commerçants peuvent transformer les liens d'inscription aux événements en liens courts et en codes QR, les imprimer sur des prospectus ou les publier sur les médias sociaux. Les logos personnalisés renforcent l'image de marque et le panneau d'administration permet de mettre à jour les liens à tout moment.
3. Partage de contenu
   Les blogueurs ou les créateurs raccourcissent les liens vers les articles et les vidéos, génèrent des codes QR et les intègrent dans des cartes de visite ou des affiches pour que les fans puissent y accéder facilement.
4. Éducation et formation
   Les organismes de formation transforment les liens vers les cours en codes QR et les impriment dans les manuels ou les publicités. Les étudiants peuvent scanner le code pour s'inscrire, et les mises à jour des liens n'affectent pas l'utilisation du code QR.
5. Promotion des projets open source
   Les développeurs transforment les liens des dépôts GitHub en liens courts, génèrent des codes QR et les partagent avec des communautés ou des documents pour en faciliter l'accès.

QA

1. Le code QR généré sera-t-il invalidé ?
   Tant que Cloudflare Workers et la base de données D1 fonctionnent correctement, le code QR est valide pour toujours. Même si le lien original du chat de groupe ne fonctionne pas, il peut être mis à jour via le backend de l'administrateur et le code QR n'a pas besoin d'être remplacé.
2. Ai-je besoin d'une expérience en programmation pour déployer le système ?
   Aucun besoin. Le déploiement se fait étape par étape, et l'interface de gestion du backend est conviviale et adaptée aux utilisateurs de base.
3. Un compte gratuit suffit-il ?
   Le quota gratuit de Cloudflare (100 000 requêtes/jour, 5 millions de lectures de base de données) est suffisant pour un individu ou une petite équipe. Les scénarios à fort trafic peuvent envisager un plan payant.
4. Comment assurer la sécurité de vos données ?
   Les données sont stockées dans la base de données D1 et le mot de passe protège le backend d'administration. Il est recommandé de sauvegarder régulièrement la base de données et de définir des mots de passe complexes.
5. Quels sont les liens pris en charge ?
   Prend en charge toute URL légale, y compris les liens WeChat, les pages web, les téléchargements de fichiers, etc. Il est recommandé de tester la validité du lien avant de le générer.
6. Comment mettre à jour les anciens utilisateurs ?
   consultation MIGRATE.mdLa nouvelle version du code a été redéployée en migrant les données KV vers la base de données D1.