ServBay 常見問題解答

在使用 ServBay 本機 Web 開發環境時，開發者可能會遇到一些狀況。本文解答了其中兩個常見疑問：ServBay Runtime 如何升級，以及如何排查因使用 ClashX Pro 等代理工具導致本地網站無法開啟的問題。

如何升級 ServBay Runtime？

ServBay Runtime 是 ServBay 的核心元件，對於確保 ServBay 以及其中託管服務的穩定運作非常關鍵。當有新版本發布時，ServBay 會在啟動時提醒用戶進行升級。即時更新 Runtime 有助於提升平台整體效能與穩定性，確保各服務相容。

升級 ServBay Runtime 的步驟如下：

1. 開啟 ServBay 應用程式。
2. 在 ServBay 視窗左側導覽列，選擇 軟體包 > 通用服務。
3. 在右側面板找到 ServBay Runtime 項目。
4. 若 ServBay Runtime 有新版本可用，會出現黃色更新提醒或升級按鈕。點擊此一黃色升級按鈕。
5. ServBay 會自動下載並安裝最新版 Runtime，請耐心等待升級完成。

升級完成後，ServBay Runtime 便會運行於最新版本，帶來更佳的穩定性與效能。

為什麼使用 ClashX Pro（或其他代理工具）後，ServBay 的本機網站無法訪問？

許多開發者會利用 ServBay 在本地進行開發與測試，並自訂本地域名（如 servbay.demo、myproject.servbay.demo 等），這些名稱通常都指向本機回圈位址 127.0.0.1。

當你啟用 ClashX Pro 這類 VPN/代理（如 Surge、Quantumult X 等）時，這些工具多半會攔截或重新導向 DNS 請求，將所有域名解析都經由代理伺服器處理。此舉會繞過 macOS 系統本身的 DNS 流程與本地 hosts 檔設定（ServBay 之本地域名解析亦依賴於此），導致你以 ServBay 設定的本地開發域名無法正確指向本機 IP，也就無法瀏覽你的本機網站。

你需要於代理工具的設定中，為本地開發域名新增規則，使這些域名在訪問時「不走代理」或「不攔截其 DNS 請求」。此通常可透過設定「繞過代理」、「忽略代理」、「白名單」或「排除清單」來達成。

以 ClashX Pro 為例，請依下列步驟設定：

1. 啟動 ClashX Pro 應用程式。
2. 在 macOS 功能表列找到 ClashX Pro 圖示，點選之後選擇 更多設定。
3. 在彈出的設定視窗，進入 通用 分頁。
4. 找到名為 忽略這些主機與域的代理設定（或類似名稱）的輸入欄位。
5. 將你的本地開發域名新增至此清單。為涵蓋 ServBay 常見域名，建議包含 localhost、127.0.0.1，以及你在 ServBay 用到的具體域名與萬用字元域名。例如，若你以 .servbay.demo 作為域名後綴，可新增 *.servbay.demo。多筆資料通常以英文逗號 , 或換行隔開。典型的設定範例如下：

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. 儲存設定；依 ClashX Pro 頁面提示，或許須重新載入或套用設定改動。

(圖示：於 ClashX Pro 設定忽略代理的主機及域名)

完成上述配置後，ClashX Pro 將不再干擾這些本地域名的解析，ServBay 本地網站便能順利訪問。若仍有疑慮，請檢查你已於 ServBay 的 網站 設定正確新增該域名，且 ServBay 相關服務（如 Caddy 或 Nginx）運作正常。你也可於終端機執行指令 ping yourproject.servbay.demo 或 dig yourproject.servbay.demo 來檢測域名的解析結果。