INDIE INDEX

レベル:入門

ブラウザゲームがindex.htmlで動かない|ローカルサーバーとVite

公開 2026-11-03更新 2026-11-03

ブラウザで動かすゲームの index.html をブラウザへ引っ張り込んでも動かないのは、ローカルのファイルシステム経由(file://)の読み込みが強く制限され、ゲームが画像・音声ファイル・JSON データなどを読み込むには、http://、つまりウェブサーバーが要るからです。ウェブサーバーは、サーバーだけを立てる方法と、Vite を使う方法で用意できます。Vite は、開発中に配るサーバーと、コードをまとめる build の命令を、主な2つの部分に持つビルドツールです。

このページの目次
  1. index.html が動かない理由
  2. ローカルのウェブサーバーの立て方を表で見る
  3. Vite の命令を表で見る
  4. ファイルを開いてからゲームが出るまでを図で見る
  5. Phaser の公式テンプレートで動かす手順
  6. サーバーだけ立てて動かす手順
  7. 失敗を避ける注意
  8. 公式のページの版
  9. 次に読む
  10. 情報源

index.html が動かない理由

静的な HTML のページなら、ファイルをブラウザへ引っ張り込むと、できあがりが見えます。HTML5 のゲームでは、引っ張り込んだファイルはローカルのファイルシステム経由(技術的には file://)で読み込まれ、これは強く制限されます。file:// には、ドメインの考え方もサーバー側の安全の仕組みもなく、あるのは素のファイルシステムだけです。この危険を抑えるために、ブラウザは file:// で動くとき自分を締めつけ、1ページごとを固有のローカルドメインとして扱います。

ゲームは、画像・音声ファイル・JSON データ、場合によっては別の JavaScript ファイルを読み込みます。そのためには、ブラウザの安全の制限に邪魔されずに動く必要があり、ゲームのファイルへの http:// のアクセスが要ります。そこで、ウェブサーバーが要ります。

ローカルのウェブサーバーの立て方を表で見る

ローカルのウェブサーバーには、たとえば次のものがあります。

ローカルのウェブサーバーの例と、前提・特徴

名前前提特徴と起動
WAMP.NetWindowsWindows には、Apache・PHP・MySQL のようなウェブ技術を、1つの exe からまとめて入れて設定するものが多くあります。WAMP.Net はシステムトレイにアイコンを入れ、そこからサービスの停止と再起動、Apache か Nginx の設定の変更ができます。新しいサイトの作成は、SSL 証明書つきでもできます
Mongoose(Cesanta)Windows小さなアプリで、インストールが要らず、1つの exe ファイルで動かせます
MAMPmacOSWAMP のように「all in one」で入れる方法です。無料の版と有料の版があります
Python の簡易サーバーPythonPython に組み込まれた簡易な HTTP サーバーで、ローカルの任意のフォルダのファイルを配れます。入れておく必要があるのは Python だけです。Apache の設定も、アプリのダウンロードも要りません
http-serverNode.jsnode.js 用の、設定が要らない、コマンドラインの http サーバーです
PHP の組み込みサーバーPHP 5.4.0 以降(CLI SAPI)コマンドラインの1回の呼び出しで起動します。開発の用途にだけ向き、すべてのファイルを順番に配ります
表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` です。公開用のサーバーとして作られたものではありません
表2

ファイルを開いてからゲームが出るまでを図で見る

index.html を file:// で開く場合と、ウェブサーバーから開く場合を図で見ます。

file:// で開く場合と、http:// のサーバーから開く場合

file:// で開く場合と、http:// のサーバーから開く場合1file:// で開くindex.html をブラウザへ引っ張り込むと、ローカルのファイルシステム経由で読み込まれ、強く制限されます。画像・音声ファイル・JSON データの読み込みには http:// が要ります2ウェブサーバーを立てるindex.html のあるフォルダ(web root)をサーバーが配ります3http で開く`localhost/` か `127.0.0.1/` を開くと、サーバーが index.html と画像・音声ファイル・JSON データを http:// で渡します。サーバーの立て方によっては、ポート番号も指定します
図1

Vite を使うときは、公開までを次の流れで進めます。

Vite で dist を作って公開先へ上げる流れ

Vite で dist を作って公開先へ上げる流れ1npm run dev開発用のウェブサーバーで、src フォルダのファイルを編集すると、Vite が再コンパイルしてブラウザを再読み込みします2npm run buildコードは1つの束(bundle)にまとめられ、dist フォルダに保存されます。public/assets の静的ファイルは dist/assets にコピーされます3公開先へ上げるdist フォルダの中身を全部、公開されたウェブサーバーに上げます
図2

Phaser の公式テンプレートで動かす手順

  1. Node.js を入れます。依存するパッケージを入れ、npm の命令で scripts を動かすのに、Node.js が要ります。
  2. テンプレート phaserjs/template-vite を取り込みます。このテンプレートは GitHub の「template」の設定で出ていて、「Use this template」で自分のリポジトリにコピーするか、GitHub Codespaces で開けます。リポジトリを clone したあと、プロジェクトのフォルダで npm install を実行します。
  3. npm run dev を実行します。開発用のウェブサーバーが、既定では http://localhost:8080 で動きます。src フォルダのファイルを編集すると、Vite がコードを自動で再コンパイルし、ブラウザを再読み込みします。
  4. 画像・音声・動画などの静的ファイルは、public/assets フォルダに置きます。Phaser の Loader の呼び出しでは、assets/bg.png のように assets から始まる道を書きます。
  5. npm run build を実行します。コードは1つの束(bundle)にまとめられ、import した assets か public/assets に置いた assets と一緒に、dist フォルダに保存されます。静的なファイルは、dist/assets に自動でコピーされます。公開するときは、dist フォルダの中身を全部、公開されたウェブサーバーに上げます。

サーバーだけ立てて動かす手順

  1. 上の表のサーバーのどれかを動かし、サーバーがファイルを探すフォルダ(web root)に index.html を置きます。
  2. ブラウザで localhost/ か 127.0.0.1/ を開きます。サーバーの立て方によっては、ポート番号も指定します。
  3. 画面が出ないときは、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 にゲームを出す手順にあります。

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。