
WSL2の開発サーバーをiPhoneで開けなかった、その解決方法
スマホ向けのアプリを作っているのに、動作確認はずっとPCのブラウザでやっていました。さすがにまずいと思って、Claude Codeに「iPhoneでも開発サーバーにアクセスしたい」とそのまま投げたら、WSL2には壁が3枚あるという説明が返ってきました。
正直、この説明を読んだ時点で自分で理解して突破するのは諦めて、解決策ごとClaude Codeに任せることにしました。
自分の記録もかねて、詰まった構造と手順を残しておきます。
なぜiPhone実機で確認したかったのか
作っているのは生活記録用のPWA(ホーム画面に追加してアプリのように使えるWebアプリ)です。スマホで使う想定のアプリなのに、変更した部分をPCでしか確認できていない。
WSL2だと素直にいかない理由(壁が3枚あります)
WSL2はNATの内側にいる
iPhoneからWindowsのIPにアクセスしても、WSL2の中のサーバーには届きません。届かせるには `netsh portproxy` の設定とファイアウォールの許可が必要で、しかもWSLを再起動してIPが変わると設定し直しになります。`http` ではService Workerが動かない
Service Workerは `https` か `localhost` でしか登録されません。頑張ってLANの `http://192.168.x.x` で開けるようにしても、PWAのインストールやオフライン機能が動かない。私のアプリはPWAなので、これが致命的でした。開発サーバーは `127.0.0.1` にしか応答しない
既定では同じマシンからのアクセスしか受け付けないので、外に出すには本来バインド設定の変更も必要です。
解決:HTTPSトンネルで外に出す
HTTPSトンネルは、WSL2の中から localhost の開発サーバーに繋いで、外向きにHTTPSのURLを発行してくれる仕組みです。これで壁3枚がまとめて消えます。
・HTTPSなのでService Worker / PWAが動く
・Windows側の設定(portproxy・ファイアウォール)が一切不要
・同じWiFiにいる必要もない
白状すると、この解決策を選んだのも設定したのもほぼClaude Codeです。人間の私がやったのは、ngrokのアカウント登録まわりと、Firebase側のドメイン追加くらい。AIができないのはアカウント作成みたいな「本人しかできない操作」だけでした。
手順
私が自分でやった操作は、実は4つだけです。
ngrokの無料アカウントを作る(https://dashboard.ngrok.com/signup)
authtokenを設定する
ダッシュボードで固定ドメインを発行する(無料枠で1個)
Firebaseの承認済みドメインに固定ドメインを追加する(Firebase認証を使っている場合のみ・Google Cloudコンソールから)
コマンドはこうなります(WSL内で実行)。
# 1) ngrok 導入
curl -fsSL -o /tmp/ngrok.tgz https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-amd64.tgz
tar xzf /tmp/ngrok.tgz -C ~/.local/bin && chmod +x ~/.local/bin/ngrok
# 2) authtoken 設定(ダッシュボードでコピーしたものを貼る)
ngrok config add-authtoken <あなたのトークン>
# 3) ダッシュボード https://dashboard.ngrok.com/domains で固定ドメイン発行
# 4) 起動(5173 は開発サーバーのポート番号に合わせてください)
ngrok http --url=your-domain.ngrok-free.dev 5173あとはiPhoneのSafariで `https://your-domain.ngrok-free.dev` を開くだけです。URLは毎回同じなので、ブックマークしておけます。
※ authtokenは `~/.config/ngrok/ngrok.yml` に保存されます。秘密情報なので、リポジトリやスクリプトには書かないよう注意してください。
日々の起動は、開発サーバーとngrokをまとめて立ち上げるシェルスクリプトをclaude codeにつくってもらい、`start` / `stop` / `status` の1コマンドにしました(二重起動しないようにしてあります)。
使ってみて
一言でいうと、楽です。
URLが変わらないので、Safariに数文字打てば補完してくれます。PC側は手順書のコマンドを1個実行するだけ。「実機確認しようかな」と思ってから10秒後にはiPhoneでアプリが開いている感覚です。
ひとつ注意点があって、Firebase認証を使っている場合は、トンネルのドメインをFirebaseの「承認済みドメイン」に追加する必要があります(Google Cloudコンソールから)。私はここを追加してからiPhoneでログインできるようになりました。
まとめ
WSL2の開発サーバーをスマホ実機で見たいなら、LANで頑張るよりHTTPSトンネルが最短でした
PWA(Service Worker)を作っているなら、`http` のLAN共有では動かないのでトンネル一択だと思います
ngrokは無料で固定ドメインが1個もらえるので、ブックマーク運用ができます
同じところで詰まっている方の役に立てば幸いです。