ServBay 配置檔案位置與管理

ServBay 作為強大的本機 Web 開發環境，其核心價值在於各類套件（如 Web 伺服器、資料庫、程式語言執行環境等）的彈性設定。為了便利管理並維持環境穩定性，ServBay 將所有套件的設定檔案集中存放，並採用明確的目錄結構。本文將詳細介紹 ServBay 配置檔案存放的位置，並指引開發者如何查找與檢視這些重要檔案。

重要提示：請勿人工修改配置檔案

ServBay 的配置檔案由應用程式根據您的設定（透過 UI 介面）自動產生。請勿直接人工編輯 ServBay 配置目錄下的檔案。

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

人工修改極可能在 ServBay 更新、重啟服務或您以 UI 介面進行其他設定變更時被覆寫，導致您的修改遺失甚至出現不可預期錯誤。

所有設定變更都應透過 ServBay 提供的圖形界面 (UI) 或官方推薦的指令工具進行，以確保更改是持久且系統穩定。本文僅提供檔案路徑資訊，主要協助您瞭解 ServBay 的內部結構與故障排查用途。

目錄結構概述

ServBay 的配置檔案主要集中於以下幾個核心目錄，並依套件名稱及版本分類：

主要設定目錄：

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

這是 ServBay 最重要的設定檔目錄，包含多數 Web 伺服器（如 Nginx、Caddy、Apache）、程式語言執行環境（如 PHP 的 php.ini）、資料庫（如 MySQL、MariaDB 的設定片段），以及其他服務（如 Redis、Memcached）的配置檔。

資料庫目錄：

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

此目錄主要儲存資料庫相關的資料檔案，也包含如 PostgreSQL 的存取控制檔等少數資料庫專屬設定檔。

共用套件目錄：

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

此目錄用於儲存共用性質的套件，例如 OpenSSL，其設定檔也位於這裡。

套件配置檔案位置說明

以下列出 ServBay 中常用套件配置檔的存放路徑示例：

Web 伺服器 (Web Servers)

Web 伺服器的配置檔多位於 ServBay 主設定目錄，並以套件名稱作為子目錄。ServBay 支援多版本並存，因此各版本配置檔會進一步分類。

• Nginx: 配置檔主目錄：

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  例如 Nginx 1.25 版本的配置檔路徑可能為：

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  其他相關設定檔（如網站設定、SSL 設定等）通常也在此目錄或其子目錄。

• Caddy: 配置檔主目錄：

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  Caddy 的主要配置檔路徑為：

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• Apache: 配置檔主目錄：

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  例如 Apache 2.4 版本的配置檔路徑可能為：

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  虛擬主機設定等通常放在 extra 子目錄。

語言執行環境 (Language Runtimes)

各種程式語言執行環境（如 PHP、Python、Node.js、Go、Java 等）的配置也多集中於主要設定目錄下，依語言名稱與版本分類。

• PHP: 配置檔主目錄：

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  例如 PHP 8.2 版本的 php.ini 路徑為：

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  PHP-FPM 的配置檔通常也在同一版本目錄下。

• Python: Python 配置通常以環境變數或專案內檔案管理，ServBay 所提供 Python 環境主要執行檔位置如下：

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  其全域設定一般不透過 ServBay 主目錄管理。

• Node.js、Go、Java、Ruby、Rust、.NET: 類似 Python，這些語言的配置多仰賴專案、環境變數或各自工具鏈慣例，ServBay 主要提供語言的執行環境或 SDK，其全域設定檔不會集中在 ServBay 主目錄。

資料庫 (Databases)

資料庫的配置檔分散於 ServBay 主目錄與資料目錄。

• MySQL / MariaDB: 配置檔主目錄：

  • macOS: /Applications/ServBay/etc/mysql （或 /Applications/ServBay/etc/mariadb）
  • Windows: C:\ServBay\etc\mysql （或 C:\ServBay\etc\mariadb）

  例如 MySQL 8.0 的配置檔路徑可能為：

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

  此檔案通常包含主要的資料庫設定參數。

• PostgreSQL: 主要配置檔位置如下，並依版本分類：

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  例如 PostgreSQL 16 的配置檔路徑為：

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  而與用戶端認證相關的配置檔 pg_hba.conf、pg_ident.conf 則在資料庫目錄，依版本區分：

  • macOS: /Applications/ServBay/db/postgresql/16/pg_hba.conf
  • macOS: /Applications/ServBay/db/postgresql/16/pg_ident.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_hba.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_ident.conf

• MongoDB、Redis: 這些資料庫的配置檔通常也在主目錄下，按名稱與版本分類。

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  例如 Redis 的配置檔路徑可能為：

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

其他服務與共用套件

• OpenSSL: OpenSSL 配置檔位於共用套件目錄下，依版本分類：

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  例如 OpenSSL 3.2 的配置檔路徑為：

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME（用於 SSL 憑證自動申請）: ACME 相關的設定與憑證儲存多位於下列目錄：

  • macOS: /Applications/ServBay/etc/acme 或 /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme 或 C:\ServBay\db\acme

查找與檢視配置檔案內容

雖然不建議人工編輯，開發者有時需查看設定內容以瞭解當前環境或進行故障排查。可依下列步驟查找並檢視配置檔：

1. 導覽到配置檔目錄： 使用命令列工具導向相應的配置目錄。

   macOS（使用 Terminal、iTerm2 等）：

   # 查看 Nginx 的配置檔目錄
   cd /Applications/ServBay/etc/nginx/
   
   # 查看 PostgreSQL 16 的 pg_hba.conf 所在目錄
   cd /Applications/ServBay/db/postgresql/16

   Windows（用 PowerShell 或 命令提示字元 Command Prompt）：

   # 查看 Nginx 的配置檔目錄
   cd C:\ServBay\etc\nginx\
   
   # 查看 PostgreSQL 16 的 pg_hba.conf 所在目錄
   cd C:\ServBay\db\postgresql\16

2. 列出目錄檔案： 檢視目錄下檔案清單：

   macOS：

   ls

   Windows：

   # PowerShell
   Get-ChildItem
   # 或簡寫
   ls
   
   # 命令提示字元
   dir

3. 檢視檔案內容： 使用純文字檢視工具或編輯器（僅供檢視，勿保存修改）打開並查看設定內容。

   macOS：

   # 查看 Nginx 的 nginx.conf
   cat nginx.conf
   # 或用 less 分頁檢視
   less nginx.conf
   
   # 檢視 PHP 8.2 的 php.ini
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows：

   # PowerShell - 查看 Nginx 的 nginx.conf
   Get-Content nginx.conf
   # 或用 more 分頁查閱
   more nginx.conf
   
   # 查看 PHP 8.2 的 php.ini
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # 命令提示字元
   type nginx.conf
   more nginx.conf

4. 重啟服務（若透過 ServBay UI 變更）： 若您以 ServBay UI 變更了設定，通常需重啟相關服務使其生效。可透過 ServBay 管理界面或 servbayctl 指令工具重啟。

   macOS：

   # 重啟 Nginx 服務
   servbayctl restart nginx -all
   
   # 重啟 PHP 8.2 服務
   servbayctl restart php 8.2
   
   # 重啟全部服務
   servbayctl restart all

   Windows：

   # 重啟 Nginx 服務
   servbayctl.exe restart nginx -all
   
   # 重啟 PHP 8.2 服務
   servbayctl.exe restart php 8.2
   
   # 重啟全部服務
   servbayctl.exe restart all

常見問題 (FAQ)

• 問：我能人工修改配置檔以測試進階設定嗎？

  答：極度不建議這麼做。ServBay UI 已涵蓋絕大部分常用的設定選項。如果需要 ServBay UI 未支援的深度客製化，請參閱 ServBay 進階設定文件或連絡社群討論。人工修改極易遭系統覆寫。

• 問：ServBay 如何管理多版本套件的配置檔？

  答：如本文所述，ServBay 會在設定目錄（macOS：/Applications/ServBay/etc 或 /Applications/ServBay/db；Windows：C:\ServBay\etc 或 C:\ServBay\db）下，依每個套件的各版本創建獨立子目錄，讓版本設定互不干擾。

• 問：若我誤刪或損毀設定檔怎麼辦？

  答：ServBay 會根據內建範本與您的設定自動重生設定檔，一般只要在 ServBay UI 對相關套件稍作設定（即便是微調），ServBay 即會嘗試重新生成檔案。萬一仍無法復原，建議嘗試重置該套件設定或聯絡 ServBay 支援。

總結

ServBay 採用集中且結構化的配置檔管理方式，於不同作業系統平台皆遵循一致目錄結構：

• macOS：主要存放於 /Applications/ServBay/etc 目錄，其次有 /Applications/ServBay/db 與 /Applications/ServBay/package/common
• Windows：主要存放於 C:\ServBay\etc 目錄，其次有 C:\ServBay\db 與 C:\ServBay\package\common

此一致的結構設計，讓 ServBay 能在不同平台上自動管理設定檔，也方便開發者查找與排除故障。

瞭解這些檔案位置，有助於掌握 ServBay 的運作原理與進行問題排查。請再次注意，所有設定更改都須透過 ServBay 官方介面或工具，切勿直接人工編輯設定檔，以確保 ServBay 環境穩定可靠。