UnityのWebゲームを自前サーバーで公開する（Caddyの設定と実測）

Unity の Web ビルドを、自分のサーバーに置いて公開しました。unityroom や itch.io に上げるのではなく、自分のドメインで配る形です。

やってみて分かったのは、これでした。

必要な設定は、ほぼ「圧縮済みファイルに正しいヘッダーを返すこと」だけ。

Caddy なら10行ほどです。ただし、そこを外すとブラウザは無言で読み込みに失敗します。

構成

ゲームのビルドは git に入れていません。約10MB あり、ビルドのたびに中身が変わるからです。サーバーの公開用フォルダに置いて、Caddy から静的に配るだけにしています。

肝心の設定（これだけ）

# /play/<ゲーム> → /play/<ゲーム>/（handle_path の前に置く）
@gameNoSlash path_regexp gameNoSlash ^/play/([a-z0-9-]+)$
redir @gameNoSlash /play/{re.gameNoSlash.1}/ 308

handle_path /play/* {
    root * /srv/games

    @br path *.br
    header @br Content-Encoding br
    @wasm path *.wasm *.wasm.br
    header @wasm Content-Type application/wasm
    @js path *.js.br
    header @js Content-Type application/javascript
    @data path *.data *.data.br
    header @data Content-Type application/octet-stream

    header Cache-Control "no-cache"
    file_server
}

ポイントは3つです。

1. 1

   .br には Content-Encoding: br を付ける

   Unity の Brotli ビルドは WebGL.wasm.br のような圧縮済みファイルを出す。サーバーが「圧縮されている」と伝えないと、ブラウザはただのバイナリとして受け取って失敗する
2. 2

   中身に合った Content-Type も付ける

   .wasm.br は放っておくと application/octet-stream になる。application/wasm を返さないと、高速な読み込み経路（ストリーミングコンパイル）が使えない
3. 3

   末尾スラッシュのリダイレクトは handle_path の外に置く

   handle_path の中では接頭辞 /play が外れているので、中に書くと接頭辞の落ちた URL に飛ぶ

実測したヘッダー

分かったこと。

• file_server は、先に header で入れた Content-Type を上書きしませんでした。 期待どおりの動きです
• 前段の Caddy に encode gzip zstd があっても、すでに Content-Encoding: br が付いた応答は二重に圧縮されませんでした

設定ファイルはフォルダごとマウントする

Docker で Caddy を動かすとき、最初は Caddyfile を1ファイルだけマウントしていました。

volumes:
- ./Caddyfile:/etc/caddy/Caddyfile

volumes:
- ./caddy:/etc/caddy

反映にかかった時間

アップロードは tar で固めてそのまま展開する形にしています。差分同期ではなく毎回まるごと置き換えですが、10MB 程度ならこのほうが事故が少ないです。

サイズの話

公開した時点では、WebGL.wasm.br が 7.3MB（展開すると 38.3MB）、全体で約 10.1MB ありました。スマホの回線では重いので、このあと削っています。

検索に出す/出さないの整理

ゲーム本体のページ（/play/…）は X-Robots-Tag: noindex を付けて検索に出していません。中身は Unity が生成した HTML で、説明も見出しもないからです。検索に出すのは、制作の記録を書いた紹介ページのほうにしています。

代わりに、ゲームを直接開いた人のために、上部に戻る帯を差し込んでいます。ビルドのたびに index.html は作り直されるので、アップロードのスクリプトの中で毎回差し込む形にしました。

このゲームを作った過程はブロック崩しのページに、環境まわりで踏んだ問題はWindowsの落とし穴14個にあります。