ServBay 安裝指南:在 macOS 上快速建立本地 Web 開發環境
ServBay 是一款專為開發者打造的本地 Web 開發環境工具,旨在簡化於 macOS 上建置及管理多種技術棧(如 PHP、Node.js、Python、Go、Java、Ruby、Rust 等)以及資料庫(如 MySQL、PostgreSQL、MongoDB、Redis)的過程。ServBay 的安裝流程極為簡單快速,這正是其核心特色之一。
與其他同類型工具相比,ServBay 安裝檔容量小巧(通常僅約 20MB),整個從安裝到初始化的過程,只需簡單幾個步驟,在短短幾分鐘內即可完成,讓您能迅速投入開發工作。
影片教學
本教學影片提供了 ServBay 的安裝步驟演示。您也可以直接造訪 YouTube 觀看。
重要提示與安裝前提條件
ServBay 目前主要支援 macOS 作業系統。
在安裝與初始化 ServBay 前,請注意以下幾點重要事項:
- 埠口衝突: 作業系統中的埠口是唯一資源,同一時間僅能由一個程序占用。ServBay 執行所需的核心服務(如 Web 伺服器、資料庫)需要占用特定埠口。為確保 ServBay 能正常啟動與運作,請在安裝前務必關閉任何可能占用 ServBay 所需埠口的現有程式。 常見容易發生衝突的埠口包括但不限於:
- Web 服務埠口:80 (HTTP)、443 (HTTPS)(常見占用程式:Apache、Nginx、Caddy、其他本地 Web 伺服器)
- MySQL/MariaDB 資料庫埠口:3306
- PostgreSQL 資料庫埠口:5432
- MongoDB 資料庫埠口:27017
- Redis 服務埠口:6379
- DNS 服務埠口:53(常見占用程式:dnsmasq、其他本地 DNS 服務) 您可於終端機使用
lsof -i :[埠口號碼]
指令(例如lsof -i :80
)檢查特定埠口是否被占用。
下載 ServBay 安裝檔
您可於 ServBay 官方網站下載頁面取得最新版安裝檔。ServBay 的安裝包容量通常很小,下載速度極快。
請前往 ServBay 下載頁面 下載支援 macOS 的 .dmg
安裝檔。檔案命名格式通常為 ServBayInstaller-vX.Y.Z.dmg
,其中 X.Y.Z
代表版本號。
安裝 ServBay
下載完成後,請依照以下步驟進行安裝:
- 雙擊下載好的
.dmg
檔案(例如ServBayInstaller-v1.12.0.dmg
),系統會掛載該磁碟映像並開啟安裝視窗。 - 在開啟的視窗中,您會看到 ServBay.app 圖示與「應用程式」資料夾(Applications)的捷徑。請將
ServBay.app
圖示拖曳到應用程式
資料夾以完成安裝。 - 安裝完成後,打開 macOS 的
應用程式
資料夾,找到並雙擊 ServBay 圖示,即可啟動程式。
初始化 ServBay
首次啟動 ServBay 時,需執行初始化設定。此過程會根據您的選擇下載及配置所需之套件。確認所有必要埠口皆未被占用之後,雙擊 ServBay 圖標啟動。
ServBay 帶來簡潔直觀的初始化介面:
- 選擇您的角色: 在初始化介面左側,請根據主要開發需求選擇一個角色,例如「Web Developer」、「Full Stack Developer」、「PHP Developer」等。
- 檢視預設套件: 選擇角色後,右側會顯示 ServBay 依據該角色預設推薦的套件組合,通常包括預設的 Web 伺服器(如 Nginx)、ServBay 執行時及特定版本語言環境(如 PHP、Python 等)。您可檢視這些預設選項。
- 開始安裝: 確認角色與套件後,點擊右下角的
Start Installation
按鈕開始安裝流程。 - 權限請求: 點擊 "Start Installation" 後,ServBay 會提示您輸入目前 macOS 使用者的密碼,以便安裝
ServBay Helper
工具。ServBay Helper
為 ServBay 管理系統服務、處理權限與埠口綁定等底層操作所必須之輔助工具。請務必授權安裝ServBay Helper
,否則 ServBay 將無法正常啟動及管理套件與網站。 - 等待安裝完成: 請耐心等候 ServBay 完成套件的下載、安裝與配置。此過程約需幾分鐘,實際時間取決於選擇的套件數量與網路速度。
- 進入主介面: 初始化完成後,將自動進入 ServBay 的主控面板。您現在可看到已安裝套件的狀態。
恭喜!ServBay 已成功安裝並完成初始化。
存取示範網站及管理工具
ServBay 預設配置了一個示範網站,並整合了常用資料庫管理工具(如 phpMyAdmin、Adminer)及 PHP 資訊頁(phpinfo),方便快速驗證安裝結果及管理資料庫。
ServBay 的預設網站根目錄位於 /Applications/ServBay/www
。示範網站及相關工具皆儲存在此目錄中。您亦可將專案放至此目錄下的子資料夾進行開發。
- 開啟瀏覽器,造訪預設網址:https://servbay.host
- 或可於 ServBay 主介面左側導覽列「
網站
」選單找到servbay.host
網站條目,點擊旁側進入圖示即可訪問。
- 或可於 ServBay 主介面左側導覽列「
- 於開啟的 ServBay 示範網站頁面中,您可輕鬆找到 phpMyAdmin、Adminer 等管理工具的連結入口。
至此,您已成功安裝並初始化 ServBay,也瞭解如何訪問預設示範網站與管理工具。現在,您可以開始配置您的開發專案了!