以前に公開されたコードは、夜遅くまで起きていたため、コードを書く際に最も基本的な論理エラーを犯しました。本来ならば、if（kv 環境変数が設定されている場合に判断する）とするべきでしたが、昨日はどうしてか分からないが、脳がショートしてしまい、if の条件文を逆に書いてしまいました。つまり、if（kv 環境変数が設定されていない場合に判断する）としてしまいました。しかし、明らかに kv 環境変数が設定されていない場合、kv ストレージに書き込むことはできません。そのため、昨日、一部のエラーが発生しました：Error 1101 Worker threw exception。kv 環境変数が設定されている場合、プログラムは正常に実行されますが、バックエンドの管理では画像が記録されません。私はこのことを非常に申し訳なく思っており、皆さんにご迷惑をおかけしました。問題は修正されたはずなので、皆さんには最新バージョンのコードをデプロイしていただきたいと思います。また、@雾山 @mikj521 @那山很优雅 @3514088137 @hiing @telnetpig @mourner などの皆さんのフィードバックに感謝します。数日間連続で夜を徹していたため、昨日は体力がもう持ちませんでしたので、寝てしまい、返信が遅れました。申し訳ありません。
以前に GitHub で 500 以上のスターがついたら画像管理機能を更新すると言ったことがありましたが、小さな画像ホスティングプログラムでは 500 以上のスターはありえないと思っていましたが、皆さんがとても熱心だったので、なんと数ヶ月も経たないうちに 600 以上のスターをつけていただきました。約束したことなので、仕方がありません。画像管理機能を作りました。
開発の過程で多くの困難に直面し、予想以上に時間がかかり、公開も延期されました。数日間連続で夜を徹していた後、春節前にこの更新を公開することができました。また、この新年の時期に皆さんに春節をお祝いします！新しい年には自分の願いを叶えることができるように！
余計なことは言わずに、直接コードを紹介します：
https://github.com/cf-pages/Telegraph-Image
まだデプロイしていない方は、このリポジトリをフォークして Cloudflare Pages のバックエンドでデプロイすることができます。
以下では、今回の更新の主な内容を紹介します：
-
皆さんが待ち望んでいた画像管理機能が追加されました。デフォルトでは無効になっていますが、有効にする場合はデプロイ後にバックエンドに移動し、「設定」->「関数」->「KV 名前空間のバインド」->「バインドの編集」->「変数名」に img_url を入力し、「KV 名前空間」に事前に作成した KV ストレージを選択してください。有効にすると、http (s)://yourdomain/admin にアクセスするとバックエンド管理ページが開きます。
画像 [1]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
画像 [2]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
（KV ストレージの作成方法については、https://github.com/xyTom/Url-Shorten-Worker/#%E5%8E%BBworkers-kv%E4%B8%AD%E5%88%9B%E5%BB%BA%E4%B8%80%E4%B8%AA%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4 を参照してください） -
バックエンド管理ページにログイン認証機能が追加されました。デフォルトでは無効になっていますが、有効にする場合はデプロイ後にバックエンドに移動し、「設定」->「環境変数」->「プロダクション環境の変数を定義する」->「変数の編集」
「変数名」 「値」
BASIC_USER = <バックエンド管理ページのログインユーザー名>
BASIC_PASS = <バックエンド管理ページのログインユーザーパスワード>
画像 [3]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
もちろん、これらの値を設定しない場合、バックエンド管理ページにアクセスする際に認証は必要ありません。この設計により、Cloudflare Access を組み合わせて使用し、メールの確認コードログイン、Microsoft アカウントログイン、Github アカウントログインなどの機能をサポートし、ドメイン上の既存のログイン方法と統合することができます。再度バックエンドのアカウントとパスワードを覚える必要はありません。Cloudflare Access の追加方法については、公式ドキュメントを参照してください。また、チュートリアルの共有も歓迎します。ただし、パスは /admin および /api/manage/* を保護する必要があります。
-
画像の総数の統計が追加されました。画像管理機能を有効にすると、バックエンドのトップに画像の数を表示することができます。
画像 [4]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース -
画像ファイル名の検索機能が追加されました。画像管理機能を有効にすると、バックエンドの検索ボックスで画像ファイル名を使用して、管理する必要のある画像を素早く検索できます。
画像 [5]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース -
画像のステータス表示が追加されました。画像管理機能を有効にすると、バックエンドで画像の現在のステータスを表示できます {"ListType": "None", "TimeStamp": 1673984678274}。ListType は画像が現在ブラックリストまたはホワイトリストにあるかどうかを示し、None はブラックリストまたはホワイトリストのいずれにもないことを示します。White はホワイトリストに、Block はブラックリストにあることを示します。TimeStamp は画像の最初の読み込み時のタイムスタンプです。画像の検閲 API を有効にしている場合、ここにはラベルで結果が表示されます。
画像 [6]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
-
ブラックリスト機能が追加されました。画像管理機能を有効にすると、バックエンドで画像を手動でブラックリストに追加することができます。ブラックリストに追加された画像は常に読み込まれません。
画像 [7]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース -
ホワイトリスト機能が追加されました。画像管理機能を有効にすると、バックエンドで画像を手動でホワイトリストに追加することができます。ホワイトリストに追加された画像は常に正常に読み込まれ、画像の検閲 API の結果をバイパスします。
画像 [8]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース -
レコードの削除機能が追加されました。画像管理機能を有効にすると、バックエンドで画像のレコードを手動で削除できます。これにより、その画像がバックエンドに表示されなくなります。ただし、アップロードした元の画像は telegraph のサーバー上に保存されているため、アップロードした元の画像を削除することはできません。画像の読み込みをブロックするために、上記のブラックリスト機能を使用する必要があります。
-
新しい実行モード「ホワイトリストモード」が追加されました。画像管理機能を有効にすると、デフォルトモード以外に、新しい実行モードが追加されました。このモードでは、ホワイトリストに追加された画像のみが読み込まれ、アップロードされた画像は承認された後に表示されます。不適切な画像の読み込みを最大限に防ぐためのものです。有効にするには、環境変数に WhiteList_Mode == "true" と設定してください。
-
バックエンドでの画像プレビュー機能が追加されました。画像管理機能を有効にすると、バックエンドでドメインを介して読み込まれた画像をプレビューすることができます。画像をクリックすると、拡大、縮小、回転などの操作ができます。
画像 [9]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
今回の更新内容は多岐にわたり、かなり重要な更新となりました。バックエンドのコードはほぼすべて書き直され、かなりの時間がかかりました。皆さんが使いやすいと思っていただければ、私が連続して夜遅くまで頑張ったことに感謝し、GitHub で無料のスターをつけていただけると嬉しいです。また、多くの人に共有していただけると幸いです。ありがとうございます！
すでにデプロイしている場合、どのように更新しますか？
実際、更新は非常に簡単です。上記の更新内容に従って、まず Cloudflare Pages のバックエンドに移動し、必要な環境変数を事前に設定し、KV 名前空間にバインドします。次に、以前にフォークしたリポジトリに移動し、「Sync fork」->「Update branch」を選択します。しばらくお待ちいただくと、Cloudflare Pages 側でリポジトリの更新を検出し、最新のコードを自動的にデプロイします。
いくつかの注意事項：
- Cloudflare KV には 1 日あたり 1000 回の無料の書き込みクォータがあります。新しい画像が読み込まれるたびに、この書き込みクォータが消費されます。クォータを超えると、画像管理バックエンドは新しい画像を記録できなくなります。
- 1 日あたり最大 100,000 回の無料の読み取り操作があります。画像が読み込まれるたびに、このクォータが消費されます（キャッシュがヒットしない場合、ドメインが Cloudflare でキャッシュが有効になっている場合は、キャッシュがヒットしない場合にのみクォータが消費されます）。ブラックリストやホワイトリストなどの機能が機能しなくなる可能性があります。
- 1 日あたり最大 1,000 回の無料の削除操作があります。画像のレコードが 1 つ作成されるたびに、このクォータが消費されます。クォータを超えると、画像のレコードを削除できなくなります。
- 1 日あたり最大 1,000 回の無料のリスト操作があります。バックエンドの /admin を開いたり更新したりするたびに、このクォータが消費されます。クォータを超えると、バックエンドの画像管理が行われなくなります。
ほとんどの場合、この無料のクォータは十分に使えるはずであり、少し超えることもできます。クォータが超えたからといってすぐに停止されるわけではありません。また、各クォータは個別に計算されるため、1 つの操作がクォータを超えた場合でも、他の機能には影響しません。つまり、私の無料の書き込みクォータが使い果たされても、読み取り機能は影響を受けず、画像は正常に読み込まれます。ただし、新しい画像は画像管理バックエンドで表示されなくなります。
無料のクォータが十分でないと感じる場合は、Cloudflare Workers の有料版を購入することもできます。月額 $5 から始まり、使用量に応じて料金がかかりますが、上記のクォータ制限はありません（なぜか Cloudflare の広告をしているような気がする？Cloudflare、早くお金を払って広告費を支払ってください /doge 手動犬頭）
上記の注意事項は、数日間の反復テストによって得られた結論です。基本的には成立するはずですが、後に Cloudflare が突然ポリシーを変更する可能性は排除できません。また、今回の更新で公開されたすべての機能は、何度も反復テストを行った結果です。使用中にバグに遭遇した場合、Cloudflare やブラウザのキャッシュの問題が原因かもしれませんので、キャッシュをクリアしてから再試行してみてください。また、環境変数に変更を加えた場合は、再デプロイすることを忘れないでください。
画像 [11]-Telegraph-Image 無料のカスタム画像ホスティングにバックエンドの画像管理機能が追加されました - 百科リソース
キャプション：https://im.gurl.eu.org/