ServBay よくある質問（FAQ）
ServBayのローカルWeb開発環境を使っていると、開発者は様々な問題に直面することがあります。本ドキュメントでは、その中でも特に多い「ServBay Runtimeのアップグレード方法」と「ClashX Proなどのプロキシツール利用時にローカルサイトへアクセスできなくなる問題」について解説します。
ServBay Runtimeをアップグレードする方法は？
ServBay RuntimeはServBayの中核を担うコンポーネントであり、ServBayや関連サービスを安定的に動作させるために欠かせません。新バージョンがリリースされると、ServBayは起動時にアップグレードの案内を表示します。Runtimeを適時アップデートすることで、パフォーマンスや安定性、互換性が向上します。
ServBay Runtimeをアップグレードするには、次の手順で操作してください：
- ServBayアプリケーションを起動します。
- サイドバー（左側ナビゲーション）から ソフトウェアパッケージ > 共通サービス を選択します。
- 右側のパネルから ServBay Runtime 項目を見つけます。
- ServBay Runtimeに利用可能なアップデートがある場合は、黄色のアップグレード通知またはアップグレードボタンが表示されます。黄色いアップグレードボタンをクリックしてください。
- ServBayが最新のRuntimeバージョンをダウンロードし、インストールを開始します。アップデートが完了するまでしばらくお待ちください。
アップグレードが完了すると、ServBay Runtimeは最新版で動作し、より高い安定性とパフォーマンスが得られます。
ClashX Pro（または他のプロキシツール）を利用した後、ServBayのローカルサイトにアクセスできなくなるのはなぜですか？
多くの開発者はServBayを使ってローカルで開発・テストを行い、servbay.demo や myproject.servbay.demo のようなカスタムドメインを設定しています。これらのドメインは通常、ローカルループバックアドレス 127.0.0.1 に解決されます。
ClashX Proや他のVPN／プロキシ（Surge、Quantumult Xなど）を使用すると、そのツールがDNSリクエストを横取りしたりリダイレクトすることで、全てのドメイン解決をプロキシサーバー経由に強制することがあります。こうした挙動は、OS自体のDNS解決やローカルhostsファイル（通常ServBayのローカルドメイン解決はこれに依存）を迂回してしまい、ServBayで設定したローカル開発用ドメインが正しくローカルIPに解決されず、あなたのローカルサイトへアクセスできなくなる原因となります。
この問題を解決するには、プロキシツールの設定で対象となるローカル開発用ドメインについて「プロキシをバイパスする」または「DNSリクエストの横取りを除外する」ルールを追加しましょう。これは一般的に「プロキシをスキップ」、「プロキシを無視」、「ホワイトリスト」、「除外リスト」といった設定項目で実現できます。
ClashX Pro を例に、以下の手順で設定してください：
- ClashX Proアプリケーションを起動します。
- macOSのメニューバーにあるClashX Proアイコンをクリックし、その他の設定 を選択します。
- 開いた設定ウィンドウで 一般 タブに移動します。
- これらのホストとドメインのプロキシ設定を無視（または類似の名称）の入力欄を見つけます。
- 利用しているローカル開発用ドメインをこのリストへ追加します。ServBayに多いローカルドメインに対応するために、
localhost、127.0.0.1、およびServBayで使用中の具体的なドメインまたはワイルドカードドメイン（例：.servbay.demoを使っている場合は*.servbay.demo）を追加しましょう。複数の項目は英語カンマ,または改行で区切ります。典型的な設定例は以下の通りです：localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo - 設定を保存し、ClashX Proの指示に従って再読み込みや適用を行ってください。
(図: ClashX Proでプロキシ除外するホスト・ドメインを設定)
この設定を完了すると、ClashX Proはこれら指定したローカルドメインのDNS解決に干渉しなくなり、ServBayのローカルサイトに正常にアクセスできるようになります。それでも問題が解決しない場合は、ServBayの サイト 設定でドメインが正しく登録されているか、ServBayの関連サービス（CaddyやNginxなど）が正常稼働しているかをご確認ください。また、ping yourproject.servbay.demo や dig yourproject.servbay.demo といったターミナルコマンドで、ドメイン解決状態を診断することも可能です。