ホスティングと配信

3つの置き方

CMS の値を HTML に入れるやり方は3つあります。フォームと流入元の記録は、どれでも script だけで動きます。

ホスティング（siteon deploy）

ビルドしたフォルダ（dist/ など）を、コマンド1つで公開します。Free プラン でも公開でき、有料プラン（Lite・Standard・Business）では容量が増え、独自ドメイン 近日 とバッジの非表示が使えます。追加の料金はかかりません。

• 公開先は https://<サブドメイン>.siteun.com/ です
• HTML は配信の前に CMS の値を埋め込みます。中継のファイルも data-embed も要りません。script タグはフォームと流入元の記録のためにそのまま入れます
• 操作は CLI と MCP サーバー から行います。API キーには deploy:write の権限が要ります
• Free プランのサイトも https://<サブドメイン>.siteun.com/ で公開でき、検索エンジンにも載ります。ページの隅に小さな「Made with Siteon」のバッジが付きます（有料プランでは付きません）。Free の公開は1日20回までで、公開のたびに自動で検査します（疑わしい版は公開せずに保留します）
• 独自ドメインとバッジの非表示は、有料プラン（月500円から）で使えます

はじめての公開

siteon hosting enable --site hanaya     # 初回だけ。サブドメインを決める
siteon deploy ./dist --site hanaya      # 公開。URL が表示されます

• サブドメインは、何も指定しなければサイト ID になります
• サブドメインに使えるのは、英小文字・数字・ハイフンの 3〜63 文字です（先頭と末尾にハイフンは不可）。www・admin・mail などの予約語や、銀行・決済・大手のブランド名を含む名前は使えません
• サイト ID が条件に合わないときは subdomain_required で止まります。--subdomain 別の名前 を付けて実行し直します
• 一度使われていたサブドメインは、解放から 90 日間、ほかのアカウントでは使えません（リンク先の乗っ取りを防ぐため）
• サブドメインの変更は 1 サイトにつき月 3 回までです。管理画面の「ホスティング」→「サブドメイン」からも変えられます
• --site を省くと、sitekit/site.json の id を使います

deploy で起きること

1. フォルダの中のファイルを読み、ファイルごとの sha256 を計算します
2. サーバーにまだ無いファイルだけを送ります（6 本並列）。前回から変わっていないファイルは送りません
3. 全部届いたら、公開中の版を一度に切り替えます。途中で失敗しても、公開中のサイトは前の版のままです

通信が切れたときは CLI が同じ操作として送り直すので、二重に公開されることはありません。失敗したときは、途中まで送った分の予約を取り消してから終わります。

置けるファイル

容量は、保持している版が使っているファイルの合計です。同じ中身のファイルは、版をまたいで1つとして数えます。写真（管理画面からアップロードしたもの）の容量とは別です。

URL とファイルの対応

1 つのページに URL が 1 つだけになるよう、揺れは 301 でそろえます。サイト内のリンクに .html が付いていてもページには着きますが、リンクは拡張子の無い形で書くのがおすすめです。

sitemap.xml と robots.txt の自動生成: サイトに置いていなければ、公開中の HTML（404.html・_ で始まるテンプレート・noindex のページを除く）と記事ごとのページから sitemap.xml を作ります。robots.txt はすべてを許可し、sitemap.xml の場所を書いたものを返します。自分で置いたファイルは上書きしません。

• 記事ごとのページ・タグページ・多言語のパスは、中継と同じ書き方で動きます（記事ごとのページ）
• 言語の接頭辞は schema.json の locales から決まります。先頭の言語が /、ほかは /<言語コード> です（例: ["ja", "en"] なら ja:/,en:/en）。記事ページのパスは news です。どちらも変える手段は準備中です 近日

反映までの時間とキャッシュ

公開の切り替え・rollback・管理画面での保存・停止は、15 秒以内に全ページへ反映されます。ブラウザに残っているファイルは、次の期間まで古いまま見えることがあります。

ビルドツールの「ファイル名にハッシュを付ける」設定を使うと、公開した瞬間から新しいファイルが届きます。保存した直後の見え方は、管理画面のプレビューで確かめます。

前の版に戻す（rollback）

siteon deploys --site hanaya              # 版の一覧（* が公開中）
siteon rollback --site hanaya             # 1 つ前の版に戻す
siteon rollback <deploy_id> --site hanaya # 指定した版に戻す

戻せるのは保持している版だけです（保持する版の数は上の表）。古い版は、新しい公開に押し出されると消えます（deploy_not_retained）。

検索エンジンとの関係

表示が止まるとき・止まらないとき

支払いが遅れても、解約しても、上限を超えても、配信は止めません。 止まるのは次のときだけです。

• 停止中でも deploy は受け付けます（直してから申し立てるため）。公開は停止が解けてから反映されます
• 未払いの 8〜30 日目は、新しい deploy ができません（402）。解約・未払い 31 日目以降は Free と同じ扱いになり、Free の上限の範囲で公開できます。どの場合も公開中の版はそのまま配信します（支払いの状態ごとの動きは プランと上限）

独自ドメイン 近日

お店のドメイン（www.example.jp）で公開できます（受け付けは準備中です）。

• www を本体にし、www.example.jp を CNAME で Siteon に向けます。所有の確認のため TXT レコードも追加します
• example.jp（www の無い形）は www への転送にします
• 使える数は Lite 1・Standard 3・Business 10 です（www と www の無い形の組で 1 つ）
• 独自ドメインが有効になると、共通サブドメインは検索に載らない設定になり、独自ドメインを正規の URL として示します

DNS に入れるレコード・DNS の会社ごとの入れ方・状態とエラーの意味は 独自ドメインとフォームの許可ドメイン にあります。

公開前の検査と通報

deploy のたびに、HTML を自動で検査します。パスワードの入力欄・ほかのサイトへ送信するフォーム・ブランド名とログインを促す語の組み合わせが見つかると、Free プランでは公開せず 422 check_failed で止めます（公開中の版はそのまま配信します）。Free プランは、さらに公開の前に URL の検査を通します。有料プランでは公開したうえで、検査に回します。

悪用（フィッシングなど）されているサイトは、https://siteun.com/report の通報フォームから知らせられます。

Cloudflare Pages の中継

置くファイル

サイトの functions/ に中継のファイルを2つ置きます。

functions/_middleware.ts
functions/_cms/render.ts

• _cms/render.ts は生成物です。編集しません（編集すると、更新のときに食い違います）
• 外部向けの配布の手段（ダウンロード・CLI）は準備中です 近日

環境変数

Pages プロジェクトの vars（wrangler.jsonc か Cloudflare のダッシュボード）で設定します。

CMS_SITE か CMS_ORIGIN が無いと、中継は何もせず静的な HTML をそのまま返します。

{
  "name": "hanaya",
  "compatibility_date": "2026-08-01",
  "pages_build_output_dir": "public",
  "vars": {
    "CMS_SITE": "hanaya",
    "CMS_ORIGIN": "https://cdn.siteon.dev",
    "CMS_LOCALES": "ja:/,en:/en",
    "CMS_NEWS_PATH": "news"
  }
}

言語の判定

CMS_LOCALES は ja:/,en:/en,zh-tw:/zh-tw のように書きます。先頭が主言語です。パスの最長一致で言語が決まります。

Accept-Language は見ません。同じ URL は誰が見ても同じ言語です。

検索避け（CMS_INDEXABLE_HOSTS）

プレビュー用のホスト（*.pages.dev など）と本番のホストで同じ中身を配ると、重複したページとして扱われ、プレビューのほうが検索結果に出ることがあります。CMS_INDEXABLE_HOSTS に本番のホストだけを書くと、それ以外のホストで返す HTML に X-Robots-Tag: noindex が付きます。

"CMS_INDEXABLE_HOSTS": "www.example.jp,example.jp"

• 完全一致です（www.example.jp を書いても a.www.example.jp は許可されない）。大文字・小文字は区別しません
• 付くのは HTML だけです（画像や CSS には付けない）
• サイト側が _headers などで X-Robots-Tag を出している場合は上書きしません

反映までの時間

公開 JSON は 60 秒キャッシュされ、中継が返す HTML も max-age=60 です。お店の人が「公開」を押してから最長1分で全ページに反映されます。サイトの再デプロイは要りません。

CMS が止まっているとき

静的な HTML をそのまま返します。 取得の失敗・タイムアウト（5秒）・壊れた JSON のどれでも、埋め込みをしなかったページを返すだけで、サイトは止まりません。

例外は記事ページだけです。取得に成功したうえで ID が見つからないときは 404 を返します。取得できなかったときは雛形をそのまま返します。

動いているかの確かめ方

中継が値を埋め込むと、レスポンスヘッダに x-sitekit-rendered: 1 が付きます。GET で確かめます。curl -I（HEAD）では付きません。

curl -sD - -o /dev/null https://example.com/ | grep -i sitekit
curl -s https://example.com/ | grep -o 'data-sk-rendered="1"'

付いていなければ、環境変数の設定漏れか、CMS に届いていないか、そのページが HTML（200）ではありません。

ほかのホスティング（data-embed）

Cloudflare Pages 以外（関数を動かせない静的ホスティングなど）では、script に data-embed を付けます。

<script src="https://cdn.siteon.dev/sitekit.js" data-site="hanaya" data-embed defer></script>

• 表示のあとに公開 JSON を取得して、data-cms 系の印に値を入れます
• document.body の中身を丸ごと置き換えます。 body の要素に付けたイベントは消えます（フォームは自動で付け直します）。サイト独自の JavaScript がある場合は避けてください
• 取得に失敗したときは何もしません。静的な HTML が残ります
• 記事ごとのページ（/news/<id>）・タグページ・記事の url は中継の機能なので使えません

中継を使うサイトでは data-embed を付けません。 埋め込みは2回実行できません（1回目の値を2回目が上書きします）。中継済みのページには data-sk-rendered="1" が付いていて script 側は何もしませんが、そもそも併用しないでください。data-embed の無い script は中継と併用します（フォームと流入元の記録に要ります）。