Server-freie Erzeugung eines permanenten Microsoft QR-Codes

Allgemeine Einführung

serverless-qrcode-hub ist ein Open-Source-Tool, das entwickelt wurde, um das Problem des häufigen Ausfalls von QR-Codes in WeChat-Gruppenchats zu lösen. Es basiert auf Cloudflare Workers und D1-Datenbank, ohne die Notwendigkeit für traditionelle Server zu laufen. Benutzer können dauerhaft gültige WeChat-Gruppen-QR-Codes generieren, um die Verwaltung von Gruppenchats zu erleichtern, und dabei jeden langen Link zu einem kurzen Link unterstützen. Das Projekt bietet ein Management-Backend, mit dem die Benutzer den QR-Code oder den Inhalt des Kurzlinks jederzeit aktualisieren können, und unterstützt benutzerdefinierte Stile und Passwortschutz. Die Bereitstellung ist einfach, ein kostenloses Kontingent reicht für den täglichen Gebrauch, geeignet für Einzelpersonen, Teams oder Entwickler. Der Code ist öffentlich auf GitHub verfügbar, und die Community kann ihn frei optimieren und erweitern.

Funktionsliste

• Generieren Sie dauerhaft gültige QR-Codes für WeChat-Gruppenchats, um das Fehlerproblem zu lösen.
• Wandeln Sie lange Links in kurze Links um, damit sie leicht geteilt und verbreitet werden können.
• Unterstützung für benutzerdefinierte QR-Code-Stile, einschließlich Farben, Rahmen und Logos.
• Bieten Sie ein Management-Backend, um den Inhalt von QR-Codes oder Kurzlinks jederzeit zu aktualisieren.
• Unterstützt Passwortschutz, um unbefugten Zugriff zu verhindern.
• Basierend auf Cloudflare Workers und D1-Datenbank, keine Server erforderlich.
• Offener Quellcode mit Unterstützung für Benutzeränderungen und -erweiterungen.
• Bereinigt automatisch abgelaufene Daten, um Ihr System effizient zu halten.

Hilfe verwenden

Installation und Einsatz

serverless-qrcode-hub läuft über die Cloudflare Workers-Plattform und benötigt keinen herkömmlichen Server. Hier sind die detaillierten Bereitstellungsschritte:

1. Registrieren Sie sich für ein Cloudflare-Konto
   Besuchen Sie die Cloudflare-Website, um sich für ein kostenloses Konto zu registrieren. Bestehende Konten können direkt eingeloggt werden.
2. Erstellen einer D1-Datenbank
   Melden Sie sich im Cloudflare-Dashboard an und gehen Sie zu Workers and Pages > D1 > Create Database.
   • Benennen Sie die Datenbank, z. B. qrcode-db.
   • Kopieren Sie die Datenbank-ID nach der Erstellung und verwenden Sie sie später.
3. GitHub-Repository aufgabeln
   Interviews Projekt LagerhausKlicken Sie dann auf die Schaltfläche "Fork" in der oberen rechten Ecke, um das Repository in Ihr GitHub-Konto zu kopieren.
4. Compiler wrangler.toml
   Öffnen Sie in Ihrem Fork-Repository die wrangler.toml Datei, klicken Sie auf die Schaltfläche Bearbeiten. Suchen Sie die [d1_databases] Zum Teil wird sie database_id Ersetzen Sie durch die in Schritt 2 kopierte D1-Datenbank-ID. Beispiel:

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

   Speichern und bestätigen Sie die Änderungen.

5. Erstellen eines Cloudflare Workers
   Kehren Sie zum Cloudflare-Dashboard zurück und wählen Sie Workers and Pages > Create Worker.
   • Benennen Sie den Arbeitnehmer, z. B. qrcode-hub.
   • Klicken Sie auf Konfiguration > Git-Integration und wählen Sie das GitHub-Repository aus, mit dem Sie arbeiten.
   • Klicken Sie auf "Speichern und bereitstellen".
6. Benutzerdefinierte Domänennamen binden (optional)
   Nach einer erfolgreichen Bereitstellung stellt Cloudflare die Standard *.workers.dev Domänenname. Wenn schnellerer Zugriff oder Branding erforderlich ist:
   • Gehen Sie zu "Workers" > "Triggers" > "Add Custom Domain".
   • Geben Sie eine auf Cloudflare gehostete Subdomain ein (z. B. qr.example.com).
   • Folgen Sie den Aufforderungen, um die DNS-Konfiguration abzuschließen.
7. Festlegen eines Zugangspassworts
   Gehen Sie im Cloudflare-Dashboard zu Worker Settings und suchen Sie den Abschnitt Environment Variables. Fügen Sie die Variable PASSWORDist der Wert ein benutzerdefiniertes Passwort (empfohlen wird eine Kombination aus Buchstaben und Zahlen, z. B. zwei UUID-Zeichenfolgen wie a1b2c3d4-e5f6g7h8). Einmal gespeichert, ist dieses Passwort für den Zugang zum Verwaltungs-Backend erforderlich.
8. Validierung des Einsatzes
   Nach Abschluss der Bereitstellung ist der Zugriff auf die zugewiesenen *.workers.dev Domäne oder eine benutzerdefinierte Domäne. Wenn Sie die Anmeldeseite sehen, war die Bereitstellung erfolgreich.

Upgrade-Anweisungen

Die alte Version des Projekts (basierend auf Cloudflare KV, Version ≤ v1.2.0) wird aufgrund von Beschränkungen der freien Quote nicht mehr empfohlen. Die neue Version basiert auf der D1-Datenbank und unterstützt 5 Millionen Lesevorgänge für eine stabilere Leistung.

• Leitfaden zur Migration: Referenz MIGRATE.md.
• Alte Version des Dokuments: Ansicht README.v1.md.

Verwendung der Hauptfunktionen

Sobald die Bereitstellung abgeschlossen ist, können die Benutzer über ihren Browser auf das Tool zugreifen. Nachstehend finden Sie eine detaillierte Beschreibung der Vorgehensweise:

Dauerhaften microsoft QR-Code generieren

1. Zugang zum Hintergrund der Verwaltung
   Öffnen Sie die Workers-Domäne (z. B. https://qrcode-hub.<你的账户>.workers.dev) oder einen benutzerdefinierten Domänennamen. Geben Sie das festgelegte Passwort ein, um sich anzumelden.
2. WeChat-Link hinzufügen
   Klicken Sie im Verwaltungshintergrund auf "WeChat QR-Code hinzufügen".
   • Geben Sie den ursprünglichen Link zum WeChat-Gruppenchat ein (normalerweise ein temporärer QR-Code-Link).
   • Optional können Sie ein Logo hochladen (PNG/JPG-Format empfohlen, kleiner als 100x100 Pixel).
   • Passen Sie die Farbe oder den Rahmen des QR-Codes an (standardmäßig schwarzer Vordergrund, weißer Hintergrund).
   • Klicken Sie auf "Erzeugen".
3. QR-Code und Kurzlink abrufen
   Das System liefert QR-Code-Bilder und kurze Links (z. B. https://qr.example.com/abc123) Scannen Sie den QR-Code, um dem Gruppenchat direkt beizutreten, und der kurze Link kann auf WeChat oder anderen Plattformen geteilt werden.
4. Gruppenchat-Link aktualisieren
   Wenn der ursprüngliche Gruppenchat-Link nicht funktioniert, gehen Sie zum Verwaltungshintergrund, suchen Sie den entsprechenden QR-Code-Datensatz und aktualisieren Sie ihn auf einen neuen Gruppenchat-Link. Nach der Aktualisierung bleiben der QR-Code und der Kurzlink unverändert, so dass die Nutzer sie nicht erneut freigeben müssen.

URL-Verkürzungsdienst

1. Langen Link hinzufügen
   Klicken Sie in der Verwaltungskonsole auf "Gemeinsamen Shortlink hinzufügen".
   • Fügen Sie einen langen Link ein (z. B. einen Artikel oder die Adresse eines Dateidownloads).
   • Optional anpassbare kurze Link-Suffixe (z. B. abc123).
   • Klicken Sie auf "Erzeugen".
2. Kurzlink erhalten
   Das System gibt einen kurzen Link zurück, der angeklickt werden kann, um zu testen, ob er auf die Originalseite springt. Kurzlinks können in sozialen Medien, E-Mails und anderen Szenarien verwendet werden.
3. Verwaltung von Kurzlinks
   Anzeige aller Kurzlinks im Admin-Backend, Unterstützung beim Bearbeiten, Löschen oder Anzeigen von Sprungdatensätzen.

Maßgeschneiderte QR-Code-Stile

1. Anpassung des Aussehens
   Wenn Sie einen QR-Code hinzufügen, klicken Sie auf "Erweiterte Optionen".
   • Logo hochladen (um das Branding zu verbessern)
   • Wählen Sie die Vorder- und Hintergrundfarben (um einen hohen Kontrast und eine gute Lesbarkeit zu gewährleisten).
   • Legen Sie die Randbreite oder den Effekt der abgerundeten Ecken fest.
2. Vorschau und Speichern
   Klicken Sie auf "Vorschau", um den Effekt zu sehen, und bestätigen Sie, um den endgültigen QR-Code zu erzeugen.

Verwaltung des Passwortschutzes

• Jedes Mal, wenn Sie auf das Verwaltungs-Backend zugreifen, müssen Sie das Passwort eingeben, das Sie zum Zeitpunkt der Bereitstellung eingerichtet haben.
• Um Ihr Passwort zu ändern, aktualisieren Sie es im Cloudflare Dashboard PASSWORD Umgebungsvariable und setzen Sie den Worker erneut ein.

caveat

• rationCloudflare Workers: Kostenlose Konten bieten 100.000 Anfragen pro Tag und die D1-Datenbank unterstützt 5 Millionen Lesevorgänge, was für den persönlichen Gebrauch ausreichend ist. Für Szenarien mit hohem Datenverkehr können Sie auf einen kostenpflichtigen Plan upgraden.
• unterstützendDie D1-Datenbank speichert alle QR-Code- und Kurzlink-Daten und es wird empfohlen, regelmäßig Backups zu exportieren (über das Cloudflare-Dashboard).
• Bereich Geschwindigkeit: Standard *.workers.dev Der Domänenname ist in einigen Bereichen des Zugangs langsam, es wird empfohlen, einen benutzerdefinierten Domänennamen zu binden.
• BürgschaftPasswörter müssen so komplex sein, dass sie nicht entwendet werden können. Der Inhalt von Kurzlinks und QR-Codes sollte legal und konform sein.

Probebetrieb

• Erstellen kurzer Links: Eingabe https://example.com/long-urlErzeugen Sie https://qr.example.com/xyz789klicken Sie auf den Testsprung.
• Einen QR-Code für WeChat erstellen: Geben Sie den Gruppenchat-Link ein, laden Sie das Logo hoch, generieren Sie den QR-Code und speichern Sie das Bild, um es an die WeChat-Gruppe oder den Freundeskreis weiterzugeben.
• einen Datensatz aktualisierenSuchen Sie den QR-Code-Datensatz im Verwaltungshintergrund, ersetzen Sie den ungültigen Link und bestätigen Sie, dass der Benutzer den ursprünglichen QR-Code weiterhin verwenden kann.

Mit diesen Schritten können Benutzer serverless-qrcode-hub schnell einsetzen, um dauerhafte QR-Codes oder kurze Links zu erzeugen. Das Verwaltungs-Backend ist intuitiv und erfordert für den Einstieg keine Programmierkenntnisse.

Anwendungsszenario

1. WeChat Gruppenmanagement
   Gruppenadministratoren müssen den QR-Code des Gruppenchats lange Zeit freigeben. serverless-qrcode-hub generiert einen permanenten QR-Code, der häufige Änderungen überflüssig macht, und die Mitglieder können den Code scannen, um jederzeit beizutreten.
2. Marketing-Aktivitäten
   Händler können Links zur Veranstaltungsregistrierung in Kurzlinks und QR-Codes umwandeln, sie auf Flyer drucken oder in sozialen Medien posten. Benutzerdefinierte Logos verbessern das Branding, und das Admin-Panel unterstützt jederzeit Link-Updates.
3. Gemeinsame Nutzung von Inhalten
   Blogger oder Kreative kürzen Links zu Artikeln und Videos, generieren QR-Codes und betten sie in Visitenkarten oder Poster ein, damit Fans sie leicht finden können.
4. Bildung und Ausbildung
   Bildungseinrichtungen verwandeln Kurslinks in QR-Codes und drucken sie in Lehrbüchern oder Anzeigen ab. Die Teilnehmer können den Code scannen, um sich anzumelden, und Aktualisierungen der Links haben keine Auswirkungen auf die Verwendung des QR-Codes.
5. Förderung von Open-Source-Projekten
   Entwickler wandeln GitHub-Repository-Links in kurze Links um, generieren QR-Codes und teilen sie mit Communities oder Dokumenten für einen einfachen Zugriff.

QA

1. Wird der generierte QR-Code ungültig?
   Solange Cloudflare Workers und die D1-Datenbank ordnungsgemäß funktionieren, ist der QR-Code für immer gültig. Selbst wenn der ursprüngliche Gruppenchat-Link nicht mehr funktioniert, kann er über das Admin-Backend aktualisiert werden und der QR-Code muss nicht ersetzt werden.
2. Benötige ich für die Bereitstellung Programmierkenntnisse?
   Kein Bedarf. Die Bereitstellung erfolgt Schritt für Schritt, und die Verwaltungsschnittstelle im Backend ist benutzerfreundlich und auch für Nicht-Benutzer geeignet.
3. Ist ein kostenloses Konto ausreichend?
   Das kostenlose Kontingent von Cloudflare (100.000 Anfragen/Tag, 5 Millionen Datenbanklesungen) ist für eine Einzelperson oder ein kleines Team ausreichend. Szenarien mit hohem Datenverkehr können einen kostenpflichtigen Plan in Betracht ziehen.
4. Wie können Sie Ihre Daten sicher aufbewahren?
   Die Daten werden in der D1-Datenbank gespeichert und das Passwort schützt das Verwaltungs-Backend. Es wird empfohlen, die Datenbank regelmäßig zu sichern und komplexe Passwörter festzulegen.
5. Welche Links werden unterstützt?
   Unterstützt jede legale URL, einschließlich WeChat-Links, Webseiten, Dateidownloads usw. Es wird empfohlen, die Gültigkeit des Links vor der Erstellung zu prüfen.
6. Wie kann ich ein Upgrade für ältere Benutzer durchführen?
   Beratung MIGRATE.mdDie neue Version des Codes wurde durch die Migration der KV-Daten in die D1-Datenbank erneut eingesetzt.