この記事で分かること
サイトを更新・運用する方へ。ページ、公開assets、非公開ファイルの期待値を分け、繰り返せるGET確認を作る方法を紹介します。
- 200だけでは取り違えを見つけられない理由。
- 期待する本文・404・SHA256を組み合わせる方法。
- ローカルの正常例と配信違いを、同じスクリプトで試す手順。
内部確認の後に、公開URLも確認した
このサイトを更新するときは、候補コンテナの起動とページを確認してから、Caddyの公開先を切り替えています。内部のURLが正常でも、公開先が旧コンテナへ向いている場合や、違うファイルが届く場合は、利用者が新しい内容を使えません。
今回の実API有効化では、切り替え後に公開15ページと配布assets、sitemap、非公開ファイルの404を確認しました。変更した確認ページ・プライバシーページ・checker JSは、検証済みの配布ファイルと応答bytesを比較しています。
共有プロキシを使っているため、ほかの三つの既存サイトも正常応答を確認しました。ここでは、その作業のうちHTTPの読み取り確認を、小さなサンプルへ切り出しています。
何が返れば成功かを、URLごとに決める
| 対象 | 期待すること | 200だけでは分からないこと |
|---|---|---|
| ホームや記事 | 200と、そのページ特有の本文 | 共通エラーページが200で返っていないか |
| JavaScriptやCSS | 200、必要なら配布版のSHA256一致 | 旧版やHTMLのエラー本文を配信していないか |
| 消した記事 | 404、必要ならnoindex | URLがまだ残っていないか |
| .env / サーバー実装 | 404 | 機密設定や非公開の実装が公開されていないか |
リダイレクトは自動で追わず、元URLのステータスを見る方法にしました。ログインページへ302で飛ばされた結果の200を、目的のページの200と同じ成功にしないためです。移転としてリダイレクトを使うページなら、その期待値を別に定めます。
本文を丸ごとログへ出す必要はありません。URLと成否、期待と違った項目を残せば、非公開ファイルが誤って届いたときも内容を転記せずに気付けます。
正常な配信と、JSの取り違えを試す
Node.js 24系を使い、外部ライブラリは不要です。次のファイルを新しい作業フォルダへ保存してください。
node probe.mjs --demo
node probe.mjs --demo-mismatch
デモは127.0.0.1の空いているポートにだけ検証サーバーを起動し、GET確認後に終了します。認証情報は使わず、本番サイトや外部APIへはアクセスしません。
PASS / HTTP 200
PASS /assets/app.js HTTP 200
PASS /server.mjs HTTP 404
RESULT {"checked":3,"failed":0}
--demo-mismatchではサーバーが別のJSを返します。HTTPは200のままですが、SHA256が違うためasset SHA256 mismatchとなり、failed: 1と終了コード1を返します。これは意図して失敗させる確認です。
自分のサイトへ向けるときの設定
checks.example.jsonのサイト名とURLごとの期待値を、自分の配信に合わせます。指定するのは自分が確認するサイトのoriginです。認証やqueryを含むURL、Cookie、パスワードは入力しません。
[
{"path":"/","status":200,"contains":["自分のサイト名"]},
{"path":"/privacy/","status":200},
{"path":"/server.mjs","status":404},
{"path":"/.env","status":404}
]
node probe.mjs https://your-site.example checks.example.json
your-site.exampleは置き換え用の表記です。実際のサイト名と構成へ変更してから使います。たとえばサーバー実装を/server.mjsに置いていないなら、ほかの非公開パスも対象に含めます。
配信ファイルを完全一致で見るときは、対応する項目に64文字のsha256を追加します。ダイジェストは、配信するファイルのbytesから計算します。
node --input-type=module -e "import {readFileSync} from 'node:fs'; import {createHash} from 'node:crypto'; console.log(createHash('sha256').update(readFileSync('app.js')).digest('hex'));"
HTMLやJSを配信側で書き換える構成では、ローカルファイルとの完全一致を期待できません。その場合は何を配信版の根拠にするかを決めます。TLS・リダイレクト・CDNの設定も、通常の利用者が通るURLから確認します。
確認の範囲と、失敗を受けた後の手順
配布例はGETのみ、1項目5秒、本文最大1MiB、最大20項目です。結果を取得できないときは、待ち時間・DNS・証明書・接続を確認します。自動で無限に再試行せず、失敗したURLと項目を切り分けます。
| 結果 | 確認する順序 |
|---|---|
| status mismatch | 元URLの応答、公開プロキシの接続先、対象ページの存在 |
| expected text missing | サイト名や本文の変更、別ページやログイン画面の配信 |
| asset SHA256 mismatch | 配布版と配信版、キャッシュ、配信時の変換 |
| 非公開パスが200 | 公開ディレクトリとルーティング。本文をログへ転記せず設定を確認 |
この確認は、JavaScriptの動作、画面崩れ、フォームの配送、実APIの認証成功を証明しません。このサイトでも、HTTP確認とは別に画面操作と保存結果の公開POSTを確認しました。問い合わせの実配送のように外部へ作用する確認は、何を送るかを決めて別に行います。
日次の確認に使う場合も、短い周期で大量のURLを巡回する必要はありません。失敗したときの連絡先と確認手順を決め、更新時の確認と通常時の確認を分けると運用しやすくなります。
出典と確認範囲
2026年10月4日に、このサイトの公開URLのGET/HEAD確認と配信内容の比較、配布例の正常デモと意図したSHA256不一致を確認しました。配布例はNode.js 24系のfetch ↗とcryptoの公式資料 ↗を使います。
このサイトの公開先切り替えに使うCaddyの設定更新はCaddyの公式reload説明 ↗を参照しています。配布した確認スクリプトには設定変更・デプロイ・rollbackの操作は含めていません。