ブラウザゲームがindex.htmlで動かない|ローカルサーバーとVite
ブラウザで動かすゲームの index.html をブラウザへ引っ張り込んでも動かないのは、ローカルのファイルシステム経由(file://)の読み込みが強く制限され、ゲームが画像・音声ファイル・JSON データなどを読み込むには、http://、つまりウェブサーバーが要るからです。ウェブサーバーは、サーバーだけを立てる方法と、Vite を使う方法で用意できます。Vite は、開発中に配るサーバーと、コードをまとめる build の命令を、主な2つの部分に持つビルドツールです。
このページの目次
index.html が動かない理由
静的な HTML のページなら、ファイルをブラウザへ引っ張り込むと、できあがりが見えます。HTML5 のゲームでは、引っ張り込んだファイルはローカルのファイルシステム経由(技術的には file://)で読み込まれ、これは強く制限されます。file:// には、ドメインの考え方もサーバー側の安全の仕組みもなく、あるのは素のファイルシステムだけです。この危険を抑えるために、ブラウザは file:// で動くとき自分を締めつけ、1ページごとを固有のローカルドメインとして扱います。
ゲームは、画像・音声ファイル・JSON データ、場合によっては別の JavaScript ファイルを読み込みます。そのためには、ブラウザの安全の制限に邪魔されずに動く必要があり、ゲームのファイルへの http:// のアクセスが要ります。そこで、ウェブサーバーが要ります。
ローカルのウェブサーバーの立て方を表で見る
ローカルのウェブサーバーには、たとえば次のものがあります。
ローカルのウェブサーバーの例と、前提・特徴
| 名前 | 前提 | 特徴と起動 |
|---|---|---|
| WAMP.Net | Windows | Windows には、Apache・PHP・MySQL のようなウェブ技術を、1つの exe からまとめて入れて設定するものが多くあります。WAMP.Net はシステムトレイにアイコンを入れ、そこからサービスの停止と再起動、Apache か Nginx の設定の変更ができます。新しいサイトの作成は、SSL 証明書つきでもできます |
| Mongoose(Cesanta) | Windows | 小さなアプリで、インストールが要らず、1つの exe ファイルで動かせます |
| MAMP | macOS | WAMP のように「all in one」で入れる方法です。無料の版と有料の版があります |
| Python の簡易サーバー | Python | Python に組み込まれた簡易な HTTP サーバーで、ローカルの任意のフォルダのファイルを配れます。入れておく必要があるのは Python だけです。Apache の設定も、アプリのダウンロードも要りません |
| http-server | Node.js | node.js 用の、設定が要らない、コマンドラインの http サーバーです |
| PHP の組み込みサーバー | PHP 5.4.0 以降(CLI SAPI) | コマンドラインの1回の呼び出しで起動します。開発の用途にだけ向き、すべてのファイルを順番に配ります |
Windows では、ここに挙げた以外にも、Microsoft IIS と Apache を単体でダウンロードできます。どのサーバーでも、サーバーがファイルを探すフォルダ(web root)に index.html を置きます。WAMP なら、システムトレイのアイコンから「www directory」を選ぶと場所が分かります。ほかのサーバーは、場所の調べ方が別です。
Vite の命令を表で見る
Phaser のテンプレートがあるバンドラーには、Vite・Rollup・Parcel・Webpack・ESBuild・Import Map・Bun があります。Vite の命令と、Phaser の Vite テンプレートの命令を並べます。
Vite の命令と、配られるアドレス
| 命令 | すること |
|---|---|
| `npm create vite@latest` | 新しい Vite のプロジェクトを作ります。Vite には Node.js の 20.19+、22.12+ の版が要り、テンプレートによっては、さらに高い版が要ります。名前と `--template` を渡すときは、npm 7 以降では余分な二重ダッシュが要ります |
| `npx vite` | `npm install -D vite` で入れて、index.html を作ったあとに動かすと、index.html が `http://localhost:5173` で配られます |
| `npm run dev` | Phaser の Vite テンプレートでは、開発用のウェブサーバーを起動します。既定は `http://localhost:8080` です |
| `npm run build` | Phaser の Vite テンプレートでは、本番用のビルドを dist フォルダに作ります |
| `npm run preview` | scripts に `"preview": "vite preview"` がある package.json で、dist の中身を配る手元の静的ウェブサーバーを起動し、既定は `http://localhost:4173` です。公開用のサーバーとして作られたものではありません |
ファイルを開いてからゲームが出るまでを図で見る
index.html を file:// で開く場合と、ウェブサーバーから開く場合を図で見ます。
file:// で開く場合と、http:// のサーバーから開く場合
Vite を使うときは、公開までを次の流れで進めます。
Vite で dist を作って公開先へ上げる流れ
Phaser の公式テンプレートで動かす手順
- Node.js を入れます。依存するパッケージを入れ、npm の命令で scripts を動かすのに、Node.js が要ります。
- テンプレート phaserjs/template-vite を取り込みます。このテンプレートは GitHub の「template」の設定で出ていて、「Use this template」で自分のリポジトリにコピーするか、GitHub Codespaces で開けます。リポジトリを clone したあと、プロジェクトのフォルダで
npm installを実行します。 npm run devを実行します。開発用のウェブサーバーが、既定ではhttp://localhost:8080で動きます。src フォルダのファイルを編集すると、Vite がコードを自動で再コンパイルし、ブラウザを再読み込みします。- 画像・音声・動画などの静的ファイルは、public/assets フォルダに置きます。Phaser の Loader の呼び出しでは、
assets/bg.pngのように assets から始まる道を書きます。 npm run buildを実行します。コードは1つの束(bundle)にまとめられ、import した assets か public/assets に置いた assets と一緒に、dist フォルダに保存されます。静的なファイルは、dist/assets に自動でコピーされます。公開するときは、dist フォルダの中身を全部、公開されたウェブサーバーに上げます。
サーバーだけ立てて動かす手順
- 上の表のサーバーのどれかを動かし、サーバーがファイルを探すフォルダ(web root)に index.html を置きます。
- ブラウザで
localhost/か127.0.0.1/を開きます。サーバーの立て方によっては、ポート番号も指定します。 - 画面が出ないときは、F12 を押してデバッグのコンソールを出し、出ているエラーを見ます。多くのブラウザで F12 で出せます。ファイルが見つからないという簡単なエラーなら、フォルダの名前を確かめて再読み込みします。
失敗を避ける注意
- Phaser の Vite テンプレートの
npm run devとnpm run buildは、log.js を動かして、gryzor.co というドメインへ、サイレントな API 呼び出しを1回行います。このドメインは Phaser Studio Inc. が所有しています。送るデータは、使っているテンプレートの名前(vue・react など)、ビルドが dev か prod か、Phaser の版です。送りたくないときは、npm run dev-nologとnpm run build-nologを使います。log.js のファイルを消し、package.json の scripts にある log.js を呼ぶ部分を消しても、log.js は実行されなくなります。 - 公開先の公開パスを前もって知らないときは、設定の
baseを"./"か""にすると、生成された URL が各ファイルからの相対になります。相対のbaseにはimport.metaへの対応が要り、import.metaに対応しないブラウザを使う人がいるときは、legacy プラグインを使えます。
公式のページの版
表の Node.js の版の条件は、Vite v8.3.4 のものです。phaserjs/template-vite は、Phaser 4.0.0 と Vite 6.3.1 に向けて更新されています。
次に読む
ブラウザ向けのゲームを itch.io に出す手順は、itch.io にゲームを出す手順にあります。
情報源
- Working with Phaser(Phaser の公式ドキュメント)https://docs.phaser.io/phaser/getting-started/set-up-dev-environment確認日 2026-11-03
- Project Templates(Phaser の公式ドキュメント)https://docs.phaser.io/phaser/getting-started/project-templates確認日 2026-11-03
- phaserjs/template-vite(Phaser の公式の GitHub リポジトリ)https://github.com/phaserjs/template-vite確認日 2026-11-03
- Getting Started(Vite の公式ドキュメント)https://vite.dev/guide/確認日 2026-11-03
- Building for Production(Vite の公式ドキュメント)https://vite.dev/guide/build確認日 2026-11-03
- Deploying a Static Site(Vite の公式ドキュメント)https://vite.dev/guide/static-deploy確認日 2026-11-03