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

下載完成後，請依照以下步驟進行安裝：

1. 雙擊下載好的 .dmg 檔案（例如 ServBayInstaller-v1.12.0.dmg），系統會掛載該磁碟映像並開啟安裝視窗。
2. 在開啟的視窗中，您會看到 ServBay.app 圖示與「應用程式」資料夾（Applications）的捷徑。請將 ServBay.app 圖示拖曳到 應用程式 資料夾以完成安裝。
3. 安裝完成後，打開 macOS 的 應用程式 資料夾，找到並雙擊 ServBay 圖示，即可啟動程式。

初始化 ServBay

首次啟動 ServBay 時，需執行初始化設定。此過程會根據您的選擇下載及配置所需之套件。確認所有必要埠口皆未被占用之後，雙擊 ServBay 圖標啟動。

ServBay 帶來簡潔直觀的初始化介面：

1. 選擇您的角色： 在初始化介面左側，請根據主要開發需求選擇一個角色，例如「Web Developer」、「Full Stack Developer」、「PHP Developer」等。
2. 檢視預設套件： 選擇角色後，右側會顯示 ServBay 依據該角色預設推薦的套件組合，通常包括預設的 Web 伺服器（如 Nginx）、ServBay 執行時及特定版本語言環境（如 PHP、Python 等）。您可檢視這些預設選項。
3. 開始安裝： 確認角色與套件後，點擊右下角的 Start Installation 按鈕開始安裝流程。
4. 權限請求： 點擊 "Start Installation" 後，ServBay 會提示您輸入目前 macOS 使用者的密碼，以便安裝 ServBay Helper 工具。ServBay Helper 為 ServBay 管理系統服務、處理權限與埠口綁定等底層操作所必須之輔助工具。請務必授權安裝 ServBay Helper，否則 ServBay 將無法正常啟動及管理套件與網站。
5. 等待安裝完成： 請耐心等候 ServBay 完成套件的下載、安裝與配置。此過程約需幾分鐘，實際時間取決於選擇的套件數量與網路速度。
6. 進入主介面： 初始化完成後，將自動進入 ServBay 的主控面板。您現在可看到已安裝套件的狀態。

恭喜！ServBay 已成功安裝並完成初始化。

存取示範網站及管理工具

ServBay 預設配置了一個示範網站，並整合了常用資料庫管理工具（如 phpMyAdmin、Adminer）及 PHP 資訊頁（phpinfo），方便快速驗證安裝結果及管理資料庫。

ServBay 的預設網站根目錄位於 /Applications/ServBay/www。示範網站及相關工具皆儲存在此目錄中。您亦可將專案放至此目錄下的子資料夾進行開發。

• 開啟瀏覽器，造訪預設網址：https://servbay.host
  • 或可於 ServBay 主介面左側導覽列「網站」選單找到 servbay.host 網站條目，點擊旁側進入圖示即可訪問。
• 於開啟的 ServBay 示範網站頁面中，您可輕鬆找到 phpMyAdmin、Adminer 等管理工具的連結入口。

至此，您已成功安裝並初始化 ServBay，也瞭解如何訪問預設示範網站與管理工具。現在，您可以開始配置您的開發專案了！