在 ServBay 中配置 MariaDB 資料庫設定

ServBay 為開發者提供強大且易於管理的本機 Web 開發環境，內建整合 MariaDB 資料庫。本文件將詳細介紹如何於 ServBay 中調整 MariaDB 相關設定，並推薦優先透過 ServBay 的 UI 圖形介面完成大多數調整，同時說明設定檔的作用及常見選項。

目標讀者： 在本機使用 ServBay 進行網頁開發，並有 MariaDB 資料庫參數調整需求的開發者。

概述

MariaDB 的設定決定資料庫伺服器的運作方式，包括網路監聽、連線上限、快取大小、日誌記錄等。在 ServBay 中，您可透過直覺的圖形介面輕鬆調整這些參數，毋須手動修改複雜的設定檔。雖然 MariaDB 標準是以 my.cnf 設定檔進行配置，但於 ServBay 環境下，我們強烈建議使用 UI 操作，以確保設定穩定且永久有效。

不同的 MariaDB 版本，其設定檔路徑通常為 /Applications/ServBay/etc/mariadb/<version>，位於 ServBay 安裝目錄下。

重要提示：優先建議透過 ServBay UI 進行設定

為避免設定衝突或被覆寫，強烈建議您僅透過 ServBay 的圖形使用者介面來調整 MariaDB 參數。ServBay 會自動根據您的 UI 設置產生並管理底層設定檔。手動編輯僅適用於暫時性除錯，且您的更動隨時可能被 ServBay 的內部管理邏輯覆蓋。

透過 ServBay UI 調整設定（推薦）

ServBay 提供直觀圖形介面，讓您輕鬆檢視與調整 MariaDB 常用設定，安全且立即生效，無需自行手動重啟服務。

啟動 ServBay 管理介面： 開啟 ServBay 應用程式。
進入資料庫設定： 在 ServBay 側邊欄展開「資料庫」功能表，點選「MariaDB」。
選擇 MariaDB 版本： 如安裝有多個 MariaDB 版本，可依需求選擇特定版本進行設定。
調整相關參數： MariaDB 設定介面中，您可找到以下常用選項進行編輯：
- 預設使用者名稱與 Root 密碼： 通常可在此檢視或（部分版本下）重設 root 使用者的密碼。
- 監聽位址（bind-address）： 設定 MariaDB 監聽的網路介面。預設為 0.0.0.0，代表監聽所有介面，允許本機連線及防火牆允許下的遠端連線。您可改為 127.0.0.1 或 localhost ，僅開放本機存取。
- 埠號（port）： 調整 MariaDB 所監聽的 TCP 連接埠，預設值為 3306。
- 最大連線數（max_connections）： 指定同時允許多少個用戶端連線 MariaDB 伺服器，請依系統資源及應用需求適度調整。
- 最大允許資料封包大小（max_allowed_packet）： 限制單一通訊封包最大位元組數，影響 SQL 查詢，尤其涉及大型 BLOB 資料。
- 啟用慢查詢日誌（slow_query_log）： 開啟慢查詢分析，協助診斷效能瓶頸。
- 慢查詢日誌路徑（slow_query_log_file）： 指定慢查詢日誌檔案路徑（預設於 /Applications/ServBay/logs/mariadb/）。
- 慢查詢時間門檻（long_query_time）： 設定查詢若耗時超過此秒數即被記錄為慢查詢。
- 緩衝池容量（innodb_buffer_pool_size）： InnoDB 儲存引擎最關鍵配置，用於快取表格資料與索引。值越大效能越佳，但需消耗更多記憶體。
- 字元集與排序（character-set-server, collation-server）： 設定資料庫預設字元集與排序規則，影響資料儲存及比對。建議使用支援 Emoji 的 utf8mb4 字元集。
儲存並套用變更： 完成設定調整後，點選底部的「儲存」按鈕。ServBay 將自動更新設定並於背景重新載入或重啟 MariaDB，讓變更立即生效。

圖示：ServBay UI MariaDB 設定介面操作範例

透過手動編輯設定檔進行調整（不建議，僅供除錯）

雖然不推薦，但了解 MariaDB 設定檔位置與結構，有助於進行深度除錯或特殊狀況臨時調整。

風險提示：手動更改可能被覆寫

手動編輯 ServBay 管理的設定檔（例如 my.cnf）極不建議，因 ServBay 於服務更新或管理時會自動重建設定檔，導致手動變更消失。請務必優先利用 ServBay UI 設定，如必須自行修改，也請清楚了解屬暫時措施，並嘗試於 UI 的額外設定欄位中予以永久化。

設定檔路徑

於 ServBay 環境下，MariaDB 主要設定檔為 my.cnf，其實際路徑依 MariaDB 版本有所不同：

主設定檔： /Applications/ServBay/etc/mariadb/<version>/my.cnf

例如，MariaDB 11.5 版本設定檔為 /Applications/ServBay/etc/mariadb/11.5/my.cnf。

`my.cnf` 檔案結構及常用參數

my.cnf 屬於純文字 INI 格式，參數分區包含在不同的 [section] 項下，最常見的服務器設定區段為 [mysqld]。

以下依 UI 對應，列舉幾項常見設定參數範例：

調整監聽位址（bind-address）
ini
```
[mysqld]
bind-address = 0.0.0.0
```
1
2
設定為 0.0.0.0 允許所有網路介面連線；設定為 127.0.0.1 或 localhost 僅限本機。
調整埠號（port）
ini
```
[mysqld]
port = 3306
```
1
2
指定 MariaDB 服務監聽的 TCP 埠號。
調整最大連線數（max_connections）
ini
```
[mysqld]
max_connections = 200
```
1
2
設定同時可連線的最大客戶端數。
調整 InnoDB 緩衝池容量（innodb_buffer_pool_size）
ini
```
[mysqld]
innodb_buffer_pool_size = 256M
```
1
2
InnoDB 快取資料與索引佔用之記憶體量，可用 K、M、G 做單位。
修改錯誤日誌檔路徑（log_error）
ini
```
[mysqld]
log_error = /Applications/ServBay/logs/mariadb/error.log
```
1
2
指定 MariaDB 錯誤日誌檔案位置。
啟用慢查詢日誌（slow_query_log, slow_query_log_file, long_query_time）
ini
```
[mysqld]
slow_query_log = 1
slow_query_log_file = /Applications/ServBay/logs/mariadb/slow.log
long_query_time = 2  # 單位為秒，記錄超過2秒的查詢
```
1
2
3
4
slow_query_log = 1 代表啟用慢查詢日誌，slow_query_log_file 為檔案路徑，long_query_time 判斷列入記錄的門檻。
設定字元集及排序規則（character-set-server, collation-server）
ini
```
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
```
1
2
3
為伺服器指定預設字元集與排序方式。

套用變更：重啟 MariaDB 服務

不論您是透過 ServBay UI 調整設定，或臨時手動編輯設定檔（不建議），通常都需要重啟 MariaDB 服務以讓新設定完全生效。ServBay 提供兩種簡便的重啟方法。

透過 ServBay 管理介面重啟

最直覺且推薦的重啟方式：

打開 ServBay 管理介面。
左側導航列展開「軟體包」選單（舊版 ServBay 可能顯示為「服務」）。
尋找對應 MariaDB 版本的軟體包。
點選旁的「重啟」按鈕即可。

透過 `servbayctl` 指令列工具重啟

servbayctl 是 ServBay 附帶的命令工具，可操作軟體包與服務管理。

於終端機輸入下述指令以重啟指定版本 MariaDB 服務：

bash

servbayctl restart mariadb <version>

請將 <version> 替換為您啟用的 MariaDB 版本號，例如 11.5。

bash

# 範例：重啟 MariaDB 11.5
servbayctl restart mariadb 11.5

常見問題 (FAQ)

Q: 為何 ServBay 強烈建議經由 UI 調整設定，而不建議編輯 my.cnf？

A: ServBay 為集成本機開發環境管理器，透過圖形介面集中控管底層相關軟體設定。您於 UI 儲存設定時，ServBay 會自動產生或更新對應系統設定檔。若您直接編輯 my.cnf，ServBay 在服務後續被管理（如升級、重啟或再次經由 UI 儲存其他選項）時，極有可能重建設定檔，使您手動改動被覆蓋。透過 UI 配置可確保設定長久一致，維持整體系統穩定。

Q: 是否能於 ServBay UI 配置所有 MariaDB 參數？

A: ServBay UI 涵蓋大多數常用核心配置項目。針對極少數特殊或高階參數，可能仍須暫時手動編輯設定檔進行測試，但務必瞭解其暫時性，並建議查找 UI 是否提供「額外設定」以納入自訂參數，以實現永久配置。

Q: 我在哪裡能找到 ServBay 中 MariaDB 的錯誤日誌與慢查詢日誌？

A: 根據預設與 ServBay 檔案結構，Log 檔案多位於 /Applications/ServBay/logs/mariadb/。具體日誌路徑可於 ServBay UI 或 my.cnf 設定檔找到。

總結

於 ServBay 環境配置 MariaDB 資料庫設定，最安全且推薦的作法即為透過圖形使用者介面。經由 UI，您可直覺調整監聽位址、埠號、連線數、日誌等關鍵參數，並確保設定永久由 ServBay 管理。雖然可存取底層 /Applications/ServBay/etc/mariadb/<version>/my.cnf 設定檔，但自行編輯存在被覆蓋風險，僅建議臨時除錯之用。設定調整後，皆可於 ServBay UI 或 servbayctl 指令工具迅速重啟 MariaDB 服務以套用變更。熟悉並理解這些設定有助於您最佳化本機 MariaDB 效能與穩定性，提升開發體驗。

在 ServBay 中配置 MariaDB 資料庫設定 ​

概述 ​

透過 ServBay UI 調整設定（推薦） ​

透過手動編輯設定檔進行調整（不建議，僅供除錯） ​

設定檔路徑 ​

my.cnf 檔案結構及常用參數 ​

套用變更：重啟 MariaDB 服務 ​

透過 ServBay 管理介面重啟 ​

透過 servbayctl 指令列工具重啟 ​

常見問題 (FAQ) ​

總結 ​