常見問題解答
本文檔匯集了用戶在使用 ServBay 本地 Web 開發環境時常遇到的問題及其解答。
什麼是 ServBay?
ServBay 是一套整合型本地網頁開發環境管理工具,專為簡化 Web 開發者在 macOS 上安裝和管理各類軟體(如網頁伺服器、資料庫、程式語言環境)的流程而設計。更多相關介紹請參考 關於 ServBay。
如何安裝 ServBay?
您可前往 ServBay 官方網站 下載安裝程式,並依照安裝精靈指示進行操作。如需更詳細的安裝步驟,請參閱 安裝 ServBay 文件。
如何卸載 ServBay?
在 macOS 上,您可直接將 ServBay 應用程式拖至「垃圾桶」,並清空垃圾桶來完成卸載。卸載前請務必備份重要資料,因為此操作將刪除 ServBay 的全部相關檔案與設定。詳情請參閱 卸載 ServBay 文件。
ServBay 是否支援自動更新?
是的,ServBay 支援自動更新功能,方便您獲取最新版本、新功能與安全補丁。請參閱升級 ServBay 文件以獲得詳情。
ServBay 是否支援 Windows/Linux?
目前 ServBay 主要支援 macOS 作業系統。Windows 及 Linux 版本正在規劃中,敬請期待。
ServBay 支援哪些語言介面?
ServBay 提供多語言界面,包含英文、簡體中文、繁體中文、西班牙文、阿拉伯文、葡萄牙文、俄文、日文、德文、法文、越南文、土耳其文、義大利文等。您可輕鬆於 ServBay 設定中切換語言。詳情請參閱 多語言支援 文件。
如何在 ServBay 備份資料?
ServBay 支援手動與自動備份您的開發環境資料,包括設定、網站檔案、資料庫內容及 SSL 憑證等關鍵資訊。除了直接手動備份 /Applications/ServBay
整個安裝目錄,ServBay 亦提供內建備份工具與選項,方便管理與復原您的資料。詳情請參閱 手動及自動備份資料 文件。
ServBay 支援哪些軟體套件?
ServBay 支援多種常見網頁開發相關套件,涵蓋網頁伺服器、資料庫、快取、程式語言及其版本管理等。主要支援套件包括但不限於:Caddy、NGINX、Apache、Mailpit、dnsmasq、各版本 PHP、Node.js、Python、Golang、Java、Ruby、Rust、.NET、MySQL、MariaDB、PostgreSQL、MongoDB、Redis、Memcached 等。這些套件皆可於 ServBay 介面輕鬆管理和設定。詳情請參閱 套件管理 文件。
如何查看 ServBay 的發佈說明?
您可於 發佈說明 頁面查閱 ServBay 之詳細發佈記錄。我們定期釋出更新,內容包括新功能說明、現有功能優化及錯誤修復。
我可以同時執行多個版本的 PHP 嗎?
可以,ServBay 其中一大優勢為同時支援安裝並運行多個 PHP 版本。您可於套件管理介面安裝和管理不同 PHP 版本,並在建立或設定網站時,為每個站點獨立選擇所需 PHP 版本。這對需維護多個(且可能依賴不同 PHP 版本)專案的開發者尤其便利。更多資訊請參考 添加第一個網站 及 如何使用 PHP 進行開發。
ServBay 是否支援 Laravel、WordPress 等框架和 CMS?
當然,ServBay 做為一套本地開發環境,充分支援主流 PHP 框架及 CMS 系統,包含但不限於 Laravel、WordPress、Symfony、CodeIgniter、Joomla、Drupal 等。您可輕鬆於 ServBay 建置與運行這些應用。相關設定與教學請參閱 如何使用 PHP 進行開發。
ServBay 是否支援 Vue、React、Next.js、Nuxt.js 等前端框架和 CMS?
可以,ServBay 支援以 Node.js 為基礎的主流 JavaScript 和 TypeScript 框架及函式庫,包括但不限於 Vue、React、Angular、Next.js、Nuxt.js、Express.js、Hapi.js 等。您可於 ServBay 管理 Node.js 版本,並靈活運行您的前端或後端專案。相關教學請參考 如何使用 Node.js 進行開發。
如何新增網站?
在 ServBay 中新增網站操作非常直觀。透過 ServBay 圖形介面,您可以指定網站根目錄、域名、選擇網頁伺服器與 PHP/Node.js 版本等。詳細新增與設定步驟,請參閱 如何添加第一個網站 文件。
ServBay 如何支援自訂網域名稱及 SSL 憑證?
為便於本地開發與測試,ServBay 提供完整的本地網路解決方案,包括本地 DNS 服務以解析自訂網域名稱(如 servbay.demo
或 yourproject.servbay.demo
),並內建私有 CA(ServBay User CA)與公共 CA(ServBay Public CA)。這些 CA 能為您本地網站產生可信任的 SSL 憑證,實現 HTTPS 存取並模擬生產環境。詳情請參閱 添加非標準頂級網域(TLDs)網站 以及 使用 SSL(HTTPS)加強網站安全 文件。
我可以在 ServBay 使用自訂網域嗎?
可以,ServBay 完善支援使用自訂網域進行本地開發,如 .test
、.local
、.servbay.demo
等作為頂級網域(TLDs)。透過 ServBay 的本地 DNS 功能,您可為每個網站設定獨立網域,並以該網域於瀏覽器直接訪問本地專案。詳細教學請參見 添加非標準頂級網域(TLDs)網站。
如何在 ServBay 為網站啟用 HTTPS?
在 ServBay 網站管理介面可輕易為您的本地網站啟用 HTTPS。ServBay 支援多種獲取與設定 SSL 憑證方式:可利用內建 ServBay User CA 或 ServBay Public CA 建立可信任之本地憑證,或透過 ACME 協議(如 Let's Encrypt、ZeroSSL)申請公認的 SSL 憑證(供公開訪問使用),也支援匯入您自有憑證。更多資訊請參考 使用 SSL(HTTPS)加強網站安全、使用 ACME 方式申請 SSL 憑證、如何從 Let's Encrypt 申請 SSL 憑證、如何從 ZeroSSL 申請 SSL 憑證、如何從 Google Trust Services 申請 SSL 憑證。
ServBay 是否支援 NGINX、Apache 或其他 Web 伺服器?
可以,ServBay 整合多種主流網頁伺服器供開發者選擇,預設包含 Caddy、NGINX 與 Apache。使用者可根據專案需求自由選擇使用任一作為網站之 Web 伺服器。詳情請參見 如何設定預設 Web 伺服器。
ServBay 最多可建立多少個網站?
ServBay 不同版本對可建立網站數有以下限制:
ServBay Free
版本最多支援 3 個網站。- 註冊使用者(免費註冊)最多可新增 5 個網站。
- ServBay Pro 及 ServBay Team 版本則支援不限數量網站建立。 您可在網站管理介面中進行新增與設定。
如何管理資料庫?
ServBay 提供方便的資料庫管理工具,助您輕鬆操作 MySQL、MariaDB、PostgreSQL 和 MongoDB。內建整合了兩大常用網頁資料庫管理工具 phpMyAdmin 與 Adminer。您可直接於 ServBay 介面存取。詳細連線資訊與管理方式請參考《資料庫管理》章節。
如何使用命令列工具?
ServBay 提供一系列命令列工具,方便您進行進階操作與自動化,例如套件管理、環境切換、PHP 模組編譯等。透過 servbayctl
命令行工具,您可靈活掌控本地開發環境。詳情請參閱 命令列支援 及 命令行工具 servbayctl 文件。
如何設定預設套件版本?
ServBay 允許您設定如 PHP、Python、Java、Go、Ruby、Rust、Node.js、MariaDB、PostgreSQL 等套件的命令列預設版本。這有助在終端或腳本中執行(像 php
、node
、mysql
等)指令時,保證採用預期版本。同時支援於專案根目錄新增 .servbay.config
,使每個專案獨立設定預設套件版本。詳細設定方法請參見 設定預設版本 及 使用 .servbay.config 文件。
我可以自訂 ServBay 的套件安裝路徑嗎?
為維持系統整潔與簡化管理成本,ServBay 將所有套件集中安裝於指定目錄結構(主要在 /Applications/ServBay
內)。目前暫不支援用戶自行調整個別套件安裝路徑。
ServBay 是否支援多用戶及權限管理?
ServBay 目前主要設計為單用戶本地開發環境,不支援傳統意義的多帳號或精細權限設定。所有 ServBay 執行的服務與網站皆在當前登入使用者環境下運行。
如何於 ServBay 查看各服務日誌?
您可於 ServBay 圖形介面輕鬆檢視各服務運作日誌。於套件管理頁,點擊特定套件右側日誌圖示,即可開啟該套件日誌檔,有助偵錯啟動問題或執行期間遇到的狀況。更多資訊請參閱 查看日誌文件。
如何於 ServBay 修改 PHP 設定?
ServBay 提供兩種常用方式調整 PHP 設定:
- 透過 ServBay UI 介面: ServBay 擁有強大圖形介面,允許您直接調整多數常見 PHP 參數,這是推薦做法。詳情參見 如何修改 PHP 設定。
- 手動編輯設定檔: 您也可編輯 PHP 的
php.ini
設定檔。不同版本 PHP 之設定檔位於/Applications/ServBay/etc/php
目錄。找到對應版本php.ini
檔進行修改。修改後,請在 ServBay 介面重啟該 PHP 服務使設定生效。詳情請參閱 查看設定檔 文件。
MySQL/MariaDB 的預設 root 帳號和密碼是?
ServBay 在安裝並啟動時會為 MySQL 與 MariaDB 設定預設 root 帳號及密碼。您可在 ServBay 資料庫管理相關文件查到這些資訊。請參閱 資料庫 root 帳號密碼及連線資訊 文件,其中也詳述如何重設密碼。
PostgreSQL 的預設 root 帳號和密碼是?
ServBay 同樣會在 PostgreSQL 安裝時配置預設的管理員帳號與密碼。詳細說明可於資料庫管理相關文件中查詢。請參閱 資料庫 root 帳號密碼及連線資訊 文件,該文亦包含密碼重設說明。
ServBay 是否支援針對不同專案使用不同版本開發語言?
可以,ServBay 提供強大的專案層級執行環境設定功能。開發者可於專案根目錄放置 .servbay.config
檔案,為不同專案指定獨立 PHP、Node.js、Python、Go、Java 等版本及環境變數。例如,您可讓專案 A 使用 PHP 8.3、Node.js 22,而專案 B 使用 PHP 8.1、Node.js 18。這種專案隔離機制確保各專案間環境互不干擾,大幅提升協同開發效率與穩定性。