永続的なマイクロソフトQRコードのサーバーフリー生成

はじめに

serverless-qrcode-hubは、WeChatのグループチャットでQRコードが頻繁に失敗する問題を解決するために設計されたオープンソースツールです。Cloudflare WorkersとD1データベースをベースとしており、従来のサーバーを必要としません。ユーザーは永久に有効なWeChatグループQRコードを生成し、グループチャットの管理を容易にすることができます。このプロジェクトは、ユーザーがいつでもQRコードやショートリンクの内容を更新できる管理バックエンドを提供し、カスタマイズされたスタイルとパスワード保護をサポートしています。デプロイは簡単で、個人、チーム、開発者に適した、毎日の使用には無料のクォータで十分です。コードはGitHubで公開されており、コミュニティは自由に最適化や拡張を行うことができる。

機能一覧

• WeChatグループチャットで永久に有効なQRコードを生成し、失敗の問題を解決します。
• 長いリンクを短いリンクに変換して、共有や配布を簡単に。
• カラー、ボーダー、ロゴなど、カスタムQRコードスタイルをサポート。
• 管理バックエンドを提供し、QRコードやショートリンクの内容をいつでも更新できる。
• 不正アクセスを制限するパスワード保護に対応。
• Cloudflare WorkersとD1データベースをベースにしており、サーバーは不要です。
• ユーザーによる修正や拡張をサポートするオープンソースコード。
• 期限切れのデータを自動的にクリーンアップし、システムを効率的に保ちます。

ヘルプの使用

インストールと展開

serverless-qrcode-hubはCloudflare Workersプラットフォームを使って動作するため、従来のサーバーは必要ありません。以下は詳細なデプロイ手順です：

1. Cloudflareアカウントにサインアップする
   Cloudflareのウェブサイトにアクセスして、無料アカウントにサインアップしてください。既存のアカウントは直接ログインできます。
2. D1データベースの作成
   Cloudflareダッシュボードにログインし、Workers and Pages > D1 > Create Databaseに進みます。
   • データベースに名前を付ける。 qrcode-db.
   • 作成後にデータベースIDをコピーし、後で使用する。
3. GitHubリポジトリをフォークする
   インタビュー プロジェクト倉庫そして、右上の "Fork "ボタンをクリックすると、GitHubアカウントにリポジトリがコピーされます。
4. コンパイラ wrangler.toml
   Forkリポジトリで wrangler.toml ファイルの編集ボタンをクリックする。ファイル名の [d1_databases] その一部は、次のようなものだ。 database_id ステップ2でコピーしたD1データベースIDに置き換える：

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

   変更を保存してコミットする。

5. Cloudflare Workerの作成
   Cloudflare ダッシュボードに戻り、Workers and Pages > Create Worker を選択します。
   • 労働者の名前を挙げる。 qrcode-hub.
   • Configuration > Git Integrationをクリックし、使用するGitHubリポジトリを選択します。
   • Save and Deploy "をクリックする。
6. カスタムドメイン名のバインド（オプション）
   デプロイに成功すると、Cloudflareはデフォルトの *.workers.dev ドメイン名。より高速なアクセスやブランディングが必要な場合：
   • Workers">"Triggers">"Add Custom Domain "に進む。
   • Cloudflareでホストされているサブドメインを入力する（例 qr.example.com).
   • プロンプトに従ってDNS設定を完了します。
7. アクセスパスワードの設定
   Cloudflareダッシュボードで、Worker Settingsに行き、Environment Variablesセクションを見つける。変数 PASSWORDのような2つのUUID文字列など）。 a1b2c3d4-e5f6g7h8).保存後、管理バックエンドにアクセスするにはこのパスワードを入力する必要があります。
8. 配備の確認
   配備が完了すると、割り当てられた *.workers.dev ドメインまたはカスタムドメインを指定します。ログインページが表示されたら、デプロイは成功です。

アップグレード手順

旧バージョンのプロジェクト（Cloudflare KVベース、バージョン≦v1.2.0）は、フリークォータ制限のため推奨されなくなりました。新バージョンはD1データベースをベースとし、500万リードをサポートし、より安定したパフォーマンスを実現します。

• マイグレーションガイド参考 MIGRATE.md.
• 旧バージョンのドキュメントを見る README.v1.md.

主要機能の使用

導入が完了すると、ユーザーはブラウザ経由でツールにアクセスできるようになる。以下、詳しい操作手順を説明する：

永久マイクロソフトQRコードを生成する

1. 経営背景へのアクセス
   ワーカーズドメインを開く（例 https://qrcode-hub.<你的账户>.workers.devまたはカスタムドメイン名）。設定したパスワードを入力してログインします。
2. WeChatのリンクを追加する
   管理画面で「WeChat QRコードを追加」をクリックする。
   • WeChatグループチャットのオリジナルリンク（通常は一時的なQRコードリンク）を入力します。
   • オプションで、ロゴ（PNG/JPG形式、100x100ピクセル以下を推奨）をアップロードすることができます。
   • QRコードの色や枠を調整します（デフォルトでは前景が黒、背景が白）。
   • 生成」をクリックする。
3. QRコードとショートリンクを入手する
   このシステムは、QRコード画像と短いリンク（例． https://qr.example.com/abc123)QRコードをスキャンするとグループチャットに直接参加でき、ショートリンクはWeChatやその他のプラットフォームで共有できます。
4. グループチャットのリンクを更新
   元のグループチャットリンクが機能していない場合、管理背景に移動し、対応するQRコードのレコードを見つけ、新しいグループチャットリンクに更新します。更新後、QRコードとショートリンクは変更されませんので、ユーザーは再共有する必要はありません。

URL短縮サービス

1. 長いリンクを追加する
   管理パネルで "Add Common Shortlink "をクリックする。
   • 長いリンク（記事やファイルのダウンロードアドレスなど）を貼り付ける。
   • オプションでカスタマイズ可能な短いリンクサフィックス（例 abc123).
   • 生成」をクリックする。
2. ショートリンク
   システムは、元のページにジャンプするかどうかをテストするためにクリックする短いリンクを返します。短いリンクは、ソーシャルメディア、電子メール、その他のシナリオで使用することができます。
3. ショートリンクの管理
   管理者バックエンドですべてのショートリンクを表示し、ジャンプ記録の編集、削除、表示をサポートします。

カスタマイズされたQRコードスタイル

1. 外観の調整
   QRコードを追加する場合は、「詳細オプション」をクリックしてください。
   • ロゴのアップロード（ブランディングの強化）
   • 前景色と背景色を選択する（コントラストを高くし、スキャンしやすくするため）。
   • ボーダー幅や角丸効果を設定します。
2. プレビューと保存
   プレビュー」をクリックして効果を確認し、確定して最終的なQRコードを生成します。

パスワード保護管理

• 管理バックエンドにアクセスするたびに、デプロイ時に設定したパスワードを入力する必要があります。
• パスワードを変更するには、Cloudflareダッシュボードで更新してください。 PASSWORD 環境変数を設定し、ワーカーを再デプロイします。

ほら

• レーションCloudflare Workersの無料アカウントは、1日あたり10万リクエスト、D1データベースは500万リードをサポートしており、個人利用には十分です。高トラフィックシナリオの場合は、有料プランにアップグレードできます。
• バックアップD1データベースには、すべてのQRコードとショートリンクのデータが保存されています。定期的にバックアップをエクスポートすることをお勧めします（Cloudflareのダッシュボードから操作します）。
• ドメイン・スピードデフォルト *.workers.dev ドメイン名でのアクセスは遅いので、カスタムドメイン名をバインドすることをお勧めします。
• 確実性パスワードは漏洩を避けるために十分に複雑である必要がある。ショートリンクやQRコードの内容は、合法的でコンプライアンスに準拠したものでなければならない。

サンプル操作

• 短いリンクの作成入力 https://example.com/long-url生成する https://qr.example.com/xyz789テストジャンプをクリックしてください。
• WeChat用のQRコードを作成するグループチャットのリンクを入力し、ロゴをアップロードしてQRコードを生成し、画像を保存してWeChatグループや友達の輪に共有します。
• レコードの更新管理背景のQRコードレコードを検索し、無効なリンクを置き換えて、ユーザーが元のQRコードを引き続き使用できることを確認します。

以上の手順で、ユーザーはserverless-qrcode-hubを素早く導入し、恒久的なQRコードやショートリンクを生成することができる。管理バックエンドは直感的で、プログラミングの経験がなくても始められます。

アプリケーションシナリオ

1. WeChatグループ管理
   serverless-qrcode-hubは、グループ管理者がグループチャットのQRコードを長期間共有する必要があります。serverless-qrcode-hubは、頻繁に変更する手間を省く永久的なQRコードを生成し、メンバーはいつでもコードをスキャンして参加することができます。
2. マーケティング活動
   加盟店は、イベント登録リンクをショートリンクやQRコードにしたり、チラシに印刷したり、ソーシャルメディアに投稿したりすることができます。カスタマイズされたロゴはブランディングを強化し、管理パネルはいつでもリンクの更新をサポートします。
3. コンテンツ共有
   ブロガーやクリエイターは、記事や動画へのリンクを短縮してQRコードを生成し、名刺やポスターに埋め込むことで、ファンが簡単にアクセスできるようにする。
4. 教育とトレーニング
   研修機関は、コースのリンクをQRコードに変換し、テキストや広告に印刷します。受講者はコードをスキャンして登録することができ、リンクの更新がQRコードの使用に影響することはない。
5. オープンソースプロジェクトの推進
   開発者はGitHubのリポジトリリンクをショートリンクに変え、QRコードを生成し、コミュニティやドキュメントと共有することで、簡単にアクセスできる。

品質保証

1. 生成されたQRコードは無効になりますか？
   Cloudflare WorkersとD1データベースが正常に動作している限り、QRコードは永久に有効です。元のグループチャットリンクが機能しない場合でも、管理者バックエンドから更新することができ、QRコードを置き換える必要はありません。
2. 配備にプログラミングの経験は必要ですか？
   必要ありません。導入はステップ・バイ・ステップの操作だけで、管理バックエンドのインターフェイスはフレンドリーで、ゼロ・ベーシック・ユーザーに適しています。
3. 無料アカウントで十分ですか？
   Cloudflareの無料クォータ（100,000リクエスト/日、500万データベースリード）は個人または小規模チームには十分です。高トラフィックシナリオでは有料プランをご検討ください。
4. データの安全性はどのように確保されていますか？
   データはD1データベースに保存され、パスワードは管理バックエンドを保護します。データベースを定期的にバックアップし、複雑なパスワードを設定することをお勧めします。
5. どのようなリンクに対応していますか？
   WeChatのリンク、ウェブページ、ファイルのダウンロードなど、あらゆる合法的なURLをサポートします。生成する前にリンクの有効性をテストすることをお勧めします。
6. 旧ユーザーのアップグレード方法は？
   協議 MIGRATE.md新バージョンのコードは、KVデータをD1データベースに移行することで再展開された。