ServBay 配置檔案位置與管理

ServBay 作為一套強大的本地 Web 開發環境，其核心優勢之一在於能靈活管理各種套件（如 Web 伺服器、資料庫、語言執行時等）的設定。為了方便管理並維持穩定運作，ServBay 將所有套件的設定檔案集中管理，並採用清楚的目錄結構。本文將詳細介紹 ServBay 設定檔的存放位置，並指引開發者如何查找和檢視這些重要的檔案。

重要提示：切勿手動修改配置檔案

ServBay 的設定檔是由應用程式根據您的設定（透過 UI 介面）自動產生。請勿直接手動編輯 /Applications/ServBay/etc 或其他 ServBay 目錄下的設定檔。

手動修改設定檔極有可能在 ServBay 更新、重啟服務，或您透過 UI 調整設定時被覆蓋，導致自訂調整遺失或產生不可預期錯誤。

所有設定變更應以 ServBay 提供的圖形介面 (UI) 或官方推薦指令工具進行，以確保變更持久且系統穩定。本文僅提供檔案路徑資訊，目的是協助您理解 ServBay 的內部結構，或於除錯時瀏覽之用。

目錄結構概覽

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

/Applications/ServBay/etc：ServBay 主要的設定檔目錄，大多數 Web 伺服器（如 Nginx、Caddy、Apache）、語言執行時（如 PHP 的 php.ini）、資料庫（如 MySQL、MariaDB 的設定片段），及其他服務（如 Redis、Memcached）的設定檔皆置於此。
/Applications/ServBay/db：主要用於存放資料庫相關的資料檔案，有些資料庫也會在此夾帶部分專屬設定檔，如 PostgreSQL 的存取控制檔案。
/Applications/ServBay/package/common：此目錄包含了像 OpenSSL 這類通用軟體套件，其設定檔也會存放在這裡。

各軟體套件設定檔位置說明

以下整理 ServBay 常用軟體套件的設定檔存放路徑範例：

Web 伺服器 (Web Servers)

Web 伺服器的主要設定檔皆置於 /Applications/ServBay/etc，並以套件名稱作為子目錄，支援多版本共存，因此路徑會再細分版本號。

Nginx: 主設定檔目錄：/Applications/ServBay/etc/nginx 例如，Nginx 1.25 版本的設定檔路徑可能為：
```
/Applications/ServBay/etc/nginx/1.25/nginx.conf
```
1
其他相關設定檔（如網站設定、SSL 設定等）通常亦於此目錄或其下層目錄統整。
Caddy: 主設定檔目錄：/Applications/ServBay/etc/caddy Caddy 主要設定檔路徑為：
```
/Applications/ServBay/etc/caddy/Caddyfile
```
1
Apache: 主設定檔目錄：/Applications/ServBay/etc/apache 例如，Apache 2.4 版本的設定檔路徑可能為：
```
/Applications/ServBay/etc/apache/2.4/httpd.conf
```
1
虛擬主機等細部設定通常組織於 extra 子目錄下。

語言執行時 (Language Runtimes)

各種語言執行時（例如 PHP、Python、Node.js、Go、Java 等）的設定檔也多存於 /Applications/ServBay/etc，並根據語言名稱與版本編排。

PHP: 主設定檔目錄：/Applications/ServBay/etc/php 例如，PHP 8.2 版本的 php.ini 檔案路徑為：
```
/Applications/ServBay/etc/php/8.2/php.ini
```
1
PHP-FPM 的設定檔亦多數於該版本目錄下。
Python: Python 的設定由環境變數或專案內部檔案管理為主，ServBay 提供的 Python 環境之主要執行檔位於 /Applications/ServBay/package/python/{version}/bin，而其全域設定多不透過 ServBay /etc 統一管理。
Node.js, Go, Java, Ruby, Rust, .NET: 與 Python 類似，上述語言主要仰賴專案、環境變數，或各自工具鏈的慣例設定。ServBay 主要負責這些語言的執行時或 SDK 安裝，全域設定檔並不統一收納於 /Applications/ServBay/etc 下。

資料庫 (Databases)

資料庫的設定檔分別置於 /Applications/ServBay/etc 及 /Applications/ServBay/db 兩個目錄。

MySQL / MariaDB: 主設定檔目錄：/Applications/ServBay/etc/mysql（或 /Applications/ServBay/etc/mariadb）例如，MySQL 8.0 的設定檔路徑為：
```
/Applications/ServBay/etc/mysql/8.0/my.cnf
```
1
此檔案通常包含主要資料庫設定參數。
PostgreSQL: PostgreSQL 主要設定檔位於 /Applications/ServBay/etc/postgresql，亦依版本分類。例如，PostgreSQL 16 的設定檔路徑為：
```
/Applications/ServBay/etc/postgresql/16/postgresql.conf
```
1
但與用戶端認證相關設定（如 pg_hba.conf、pg_ident.conf）則在 /Applications/ServBay/db/postgresql 下，同樣依版本分類：
```
/Applications/ServBay/db/postgresql/16/pg_hba.conf
/Applications/ServBay/db/postgresql/16/pg_ident.conf
```
1
2
MongoDB, Redis: 這些資料庫的設定檔通常於 /Applications/ServBay/etc 依名稱與版本分類存放。例如，Redis 設定檔可能路徑如下：
```
/Applications/ServBay/etc/redis/redis.conf
```
1

其他服務與共用套件

OpenSSL: OpenSSL 的設定檔位於 /Applications/ServBay/package/common/openssl，並依版本分類。例如，OpenSSL 3.2 的設定檔路徑為：
```
/Applications/ServBay/package/common/openssl/3.2/openssl.cnf
```
1
ACME（用於 SSL 憑證自動申請）: ACME 相關設定及憑證存放通常於 /Applications/ServBay/etc/acme 或 /Applications/ServBay/db/acme 目錄中。

查找與檢視配置檔案內容

雖然官方強烈不建議手動編輯，但有時開發者為了瞭解現行設定或診斷問題，可能需要查閱設定檔內容。您可依下列步驟操作：

進入設定檔目錄： 使用終端（Terminal、iTerm2 等）命令行導航至相應配置目錄。例如查看 Nginx 設定所在目錄：
bash
```
cd /Applications/ServBay/etc/nginx/
```
1
若要進入 PostgreSQL 16 的 pg_hba.conf 所在目錄：
bash
```
cd /Applications/ServBay/db/postgresql/16
```
1
列出目錄檔案： 使用 ls 命令瀏覽目錄內檔案列表：
bash
```
ls
```
1
瀏覽檔案內容： 使用檔案瀏覽工具（如 cat、less、more）或純粹用於檢視的編輯器（如 vim、nano - 僅供檢視，請勿儲存更動）開啟設定檔。例如，檢視 Nginx 的 nginx.conf：
bash
```
cat nginx.conf
# 或用 less 分頁檢視
less nginx.conf
```
1
2
3
檢視 PHP 8.2 的 php.ini：
bash
```
less /Applications/ServBay/etc/php/8.2/php.ini
```
1
（如用 ServBay UI 調整設定）重新啟動服務： 若您是透過 ServBay UI 變更設定，通常需重啟對應的套件服務，讓設定生效。可用 ServBay 管理介面或 servbayctl 指令工具。例如重啟 Nginx 服務：
bash
```
servbayctl restart nginx -all
```
1
重啟 PHP 8.2 服務：
bash
```
servbayctl restart php 8.2
```
1
重新啟動所有服務：
bash
```
servbayctl restart all
```
1

常見問題集 (FAQ)

問：我可以手動修改設定檔以嘗試某些進階設定嗎？
答：強烈建議不要這麼做。ServBay UI 已提供大多數常見設定的調整選項。如需 UI 未涵蓋的深度自訂，請參閱 ServBay 進階設定文件或尋求社群協助。由於設定檔容易被自動覆蓋，手改無法保證持久。
問：ServBay 如何管理多版本套件的設定檔？
答：如本文所示，ServBay 於 /Applications/ServBay/etc 及 /Applications/ServBay/db 下，為每個套件、每個版本分別建立獨立子目錄存放設定檔，確保不同版本互不干擾。
問：若我誤刪或毀損了設定檔該怎麼辦？
答：ServBay 會依據內建範本和您的選項自動產生設定檔。一般情況下，您只需透過 ServBay UI 做一次（即便極細微的）設定更動，即會自動重新產生設定檔。若發生極端狀況，可嘗試重置該套件設定，或聯絡 ServBay 支援。

小結

ServBay 以集中且結構化的方式管理套件設定檔，主要儲存於 /Applications/ServBay/etc，輔以 /Applications/ServBay/db 和 /Applications/ServBay/package/common 目錄。這種設計方便 ServBay 自動化管理及讓開發者容易查找。

理解這些檔案的存放邏輯，不僅有助於認識 ServBay 的運作原理，也利於後續故障診斷。再次提醒，所有設定變更應透過 ServBay 官方介面或工具處理，切勿直接手動編輯，以確保您的 ServBay 環境穩定可靠。

ServBay 配置檔案位置與管理 ​

目錄結構概覽 ​

各軟體套件設定檔位置說明 ​

Web 伺服器 (Web Servers) ​

語言執行時 (Language Runtimes) ​

資料庫 (Databases) ​

其他服務與共用套件 ​

查找與檢視配置檔案內容 ​

常見問題集 (FAQ) ​

小結 ​