メインコンテンツへスキップ
見出し画像

WSL2の開発サーバーをiPhoneで開けなかった、その解決方法

    スマホ向けのアプリを作っているのに、動作確認はずっとPCのブラウザでやっていました。さすがにまずいと思って、Claude Codeに「iPhoneでも開発サーバーにアクセスしたい」とそのまま投げたら、WSL2には壁が3枚あるという説明が返ってきました。

    正直、この説明を読んだ時点で自分で理解して突破するのは諦めて、解決策ごとClaude Codeに任せることにしました。

    自分の記録もかねて、詰まった構造と手順を残しておきます。

    なぜiPhone実機で確認したかったのか

    作っているのは生活記録用のPWA(ホーム画面に追加してアプリのように使えるWebアプリ)です。スマホで使う想定のアプリなのに、変更した部分をPCでしか確認できていない。

    WSL2だと素直にいかない理由(壁が3枚あります)

    1. WSL2はNATの内側にいる
      iPhoneからWindowsのIPにアクセスしても、WSL2の中のサーバーには届きません。届かせるには `netsh portproxy` の設定とファイアウォールの許可が必要で、しかもWSLを再起動してIPが変わると設定し直しになります。

    2. `http` ではService Workerが動かない
      Service Workerは `https` か `localhost` でしか登録されません。頑張ってLANの `http://192.168.x.x` で開けるようにしても、PWAのインストールやオフライン機能が動かない。私のアプリはPWAなので、これが致命的でした。

    3. 開発サーバーは `127.0.0.1` にしか応答しない
      既定では同じマシンからのアクセスしか受け付けないので、外に出すには本来バインド設定の変更も必要です。

    解決:HTTPSトンネルで外に出す

    HTTPSトンネルは、WSL2の中から localhost の開発サーバーに繋いで、外向きにHTTPSのURLを発行してくれる仕組みです。これで壁3枚がまとめて消えます。

    ・HTTPSなのでService Worker / PWAが動く
    ・Windows側の設定(portproxy・ファイアウォール)が一切不要
    ・同じWiFiにいる必要もない

    白状すると、この解決策を選んだのも設定したのもほぼClaude Codeです。人間の私がやったのは、ngrokのアカウント登録まわりと、Firebase側のドメイン追加くらい。AIができないのはアカウント作成みたいな「本人しかできない操作」だけでした。

    手順

    私が自分でやった操作は、実は4つだけです。

    1. ngrokの無料アカウントを作る(https://dashboard.ngrok.com/signup)

    2. authtokenを設定する

    3. ダッシュボードで固定ドメインを発行する(無料枠で1個)

    4. 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個もらえるので、ブックマーク運用ができます

    同じところで詰まっている方の役に立てば幸いです。

     
     

    Rainy

     
     
    Claude Codeで個人開発をしています。詰まったところと直し方を、かかった時間や失敗もそのまま書いています。環境構築・MCP・自動化まわりが中心です。

    あなたへのおすすめ