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

Tutoriels pratiques sur l'IAMise à jour il y a 4 mois Cercle de partage de l'IA

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 :

Ouvrir un compte Cloudflare
Visitez le site web de Cloudflare pour vous inscrire à un compte gratuit. Les comptes existants peuvent être connectés directement.
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.
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.
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.
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".
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.
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.
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

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.
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".
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.
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

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".
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.
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é

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.
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

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.
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.
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.
É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.
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

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é.
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.
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.
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.
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.
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.