用語集
GitHub、Cloudflare、Workers、D1、Passkey など、このサイトで使う言葉の解説です。聞きなれない方に向けてまとめています。
普段、GitHub や Cloudflare といった言葉に聞きなれのない方向けの解説です。それぞれの言葉の意味と、goodnight-web での使われ方を説明します。
サイトが動く場所
Cloudflare
Webサイトを世界中に速く届けたり、守ったりするサービスを提供している会社です。プログラムを動かすサービスや、データを保存するサービスも提供しています。goodnight-web はご自身の Cloudflare アカウントの中で動くので、アカウントと設定はご自身で管理します。
Workers
Cloudflare のプログラムを動かすサービスです。goodnight-web は、Webサイトごとに 1 つの Worker を動かします。問い合わせフォームの API と管理画面を動かし、ビルドしたページも配信します。
Static Assets
Workers の機能のひとつで、ビルドしたページ、画像、スタイルなど、できあがったファイルを配信します。Cloudflare は、これらのファイルをプログラムを動かさずに配信します。
D1
SQLite をもとにした、Cloudflare のデータベースのサービスです。goodnight-web は、問い合わせ、フォームの設定、ログインに必要なデータを、ご自身のアカウントの D1 データベースに保存します。
Binding
Worker に、D1 データベースなどの Cloudflare のリソースを使わせるための Workers の設定です。Worker の設定に書いておくと、Worker は env.DB のように env を通してリソースを使えます。リソースのパスワードやキーを Worker に持たせる必要はありません。データベースがネットワークに公開されない理由を参照してください。
Turnstile
Cloudflare のボット対策です。問い合わせフォームで、人間と自動プログラムを見分けるために使います。Turnstile を設定するを参照してください。
Cloudflare WAF
WAF は Web Application Firewall の略です。ドメインへのリクエストを、Worker に届く前にルールで確認します。Cloudflare の任意の機能で、goodnight-web には含まれません。Cloudflare WAF を参照してください。
Cloudflare Access
管理画面の前に、もう 1 段のログインを置く Cloudflare の任意の機能です。Cloudflare Access を参照してください。
サイトの作り方
Astro
ファイルからWebサイトを作るツールです。スターターキットのページは Astro で作られていて、お知らせやブログなどの記事は Markdown のファイルに書きます。
Markdown
見出し、リスト、リンクなどを書ける、シンプルなテキストの書き方です。スターターキットのお知らせとブログは、Markdown のファイルです。
SSG
静的サイト生成（static site generation）の略です。ページを事前に一度ビルドして、できあがったファイルにしておきます。訪問のたびにサーバーでページを組み立てることはありません。スターターキットの Astro のサイトは、この方法でビルドします。
Hono
Workers の上で動く、小さな Web フレームワークです。問い合わせフォームの API と管理 API は、これで作られています。この部分は編集しません。
CMS
コンテンツ管理システム（content management system）の略で、ブラウザでWebサイトのページを編集するサービスです。goodnight-web では使いません。ファイルを編集するか、AI ツールに編集を頼みます。
サイトの管理
GitHub
Git というツールで、サイトのファイルと変更の履歴を保管するサービスです。Webサイトのファイルは、ご自身の GitHub アカウントのリポジトリ（プロジェクトのフォルダー）にあります。リポジトリは private にしてください。配布と更新のしくみを参照してください。
デプロイ
サイトの新しいバージョンを公開することです。Deploy to Cloudflare ボタンは、スターターキットをご自身の GitHub アカウントの新しいリポジトリにコピーし、ご自身の Cloudflare アカウントにサイトを用意します。はじめかたを参照してください。
Workers Builds
Cloudflare のビルドサービスです。GitHub に push すると、サイトをビルドしてデプロイします。
プルリクエスト（PR）
GitHub 上の、変更の提案です。内容を確認してからマージすると、変更が反映されます。goodnight-web の更新は、PR として届きます。保守の作業を参照してください。
Dependabot
サイトが使っているパッケージに新しいバージョンが出ると、PR を作ってくれる GitHub のツールです。
ログイン
Passkey
パスワードを使わず、指紋、顔、端末の PIN でログインする方法です。管理画面で使えるのは Passkey だけです。Passkey でのログインを参照してください。
HKDF
1 つの秘密の値から、別々の鍵をいくつも作るための標準的な方法で、RFC 5869 で定められています。goodnight-web はこれを使い、管理画面のログインセッションに署名する鍵と、IP アドレスをハッシュにする鍵を APP_SECRET から作ります。鍵ごとに決まったラベルを使うので、一方の鍵から APP_SECRET やもう一方の鍵を割り出すことはできません。