修改 MongoDB 設定

ServBay 作為功能強大的本地 Web 開發環境，整合了多種資料庫服務，其中也包括 MongoDB。ServBay 為開發人員提供了便利的方式管理和配置這些資料庫。本文將詳細介紹如何在 ServBay 修改 MongoDB 的各項設定，重點說明推薦的圖形介面操作方式，同時解釋相關的設定檔結構以及常見設定選項。

ServBay 所安裝的 MongoDB 設定檔一般位於 /Applications/ServBay/etc/mongodb/<version> 目錄，其中 <version> 代表您安裝的 MongoDB 版本，例如 MongoDB 8.0 的設定檔位置為 /Applications/ServBay/etc/mongodb/8.0。

重要提示

ServBay 會自動產生與管理其軟體包（包含 MongoDB）的設定檔。我們強烈建議透過 ServBay 所提供的圖形化使用者介面 (UI) 執行設定調整。若直接手動修改設定檔，有可能讓您的更動被 ServBay 的自動管理流程覆蓋，導致設定遺失或服務異常。

透過 ServBay 圖形介面設定 MongoDB

ServBay 提供直覺且易於操作的圖形介面，讓開發者無需手動編輯複雜設定檔就能輕鬆調整 MongoDB 各式設定。這是 ServBay 中配置 MongoDB 的推薦方法。

開啟 ServBay 管理介面： 啟動 ServBay 應用程式。
導航至資料庫設定： 在 ServBay 左側導覽欄中點擊 資料庫，再選擇 MongoDB。
選擇 MongoDB 版本： 如您的環境安裝有多個不同版本的 MongoDB，請選取您要設定的特定版本。
修改設定參數： 在圖形設定介面中，您可以直接調整 MongoDB 的核心參數，例如：
- 監聽位址（bindIp）： 設定 MongoDB 監聽的網路介面。預設值 127.0.0.1, ::1 表示僅允許本機連線。如有需要，也可調整為 0.0.0.0，開放來自其他裝置的連線（請務必評估潛在安全風險）。
- 連接埠（port）： 設定 MongoDB 服務監聽的埠號。預設為 27017。
- 其他設定： 介面將同步顯示其他常用設定選項。
新增額外參數： 若需設定進階參數（介面未列出者），可於 Additional Parameters（其他參數）區塊以 YAML 格式新增。這些參數將合併至最終的 mongod.conf 檔案中。
儲存並套用： 設定完成後，點擊介面下方的 儲存 按鈕。ServBay 會自動將您的更動套用至設定檔，並於必要時重啟 MongoDB 服務，使設定立即生效。

透過 ServBay UI 進行設定，可確保您的調整由 ServBay 妥善管理並持久保存，避免手動修改所可能造成的問題。

了解 MongoDB 設定檔（僅供參考或臨時調整）

雖然不建議手動編輯，但熟悉 ServBay 中 MongoDB 設定檔的位置與結構，有助於理解服務運作或進行臨時除錯。

設定檔位置

MongoDB 主要設定檔為 mongod.conf。依據安裝版本不同，此檔案位於 ServBay 安裝目錄的指定路徑：

mongod.conf： /Applications/ServBay/etc/mongodb/<version>/mongod.conf

舉例，若您的 MongoDB 為 8.0，檔案路徑即為 /Applications/ServBay/etc/mongodb/8.0/mongod.conf。

常見設定項與說明

mongod.conf 採用 YAML 格式，用來定義 MongoDB 伺服器運作的各類選項。以下為幾個常見設定及其簡介：

`mongod.conf` 常見設定參數

網路設定（net）：
- bindIp： 指定 MongoDB 監聽的 IP 位址。
  yaml
```
net:
  bindIp: 0.0.0.0 # 允許所有網路介面連線（請小心使用）
```
  1
  2
  預設值 127.0.0.1, ::1 僅允許本機 IPv4 與 IPv6 連線。若設為 0.0.0.0 則開放來自任何 IP 的連線，不過這僅適合用於區網測試環境，在生產或不可信網路中可能存在重大安全風險。
- port： 指定 MongoDB 監聽的 TCP 連接埠。
  yaml
```
net:
  port: 27017 # 預設連接埠
```
  1
  2
  若預設埠已被占用，或您需分配不同埠給不同 MongoDB 實體，可自行調整此值。
儲存引擎設定（storage）：
- wiredTiger： 配置 WiredTiger 儲存引擎。自 MongoDB 3.2 起即為預設儲存引擎。
  - engineConfig.cacheSizeGB： 設定 WiredTiger 可使用的最大快取（以 GB 為單位）。快取用於儲存內部緩存、索引與工作集數據。提高快取容量有助於提升效能，但會占用更多系統記憶體。
    yaml
```
storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1 # 設定快取大小為 1 GB
```
    1
    2
    3
    4
操作分析設定（operationProfiling）：
- slowOpThresholdMs： 定義「慢查詢」的時間門檻（單位為毫秒）。超過此門檻的操作在分析器啟動時會被記錄於慢查詢日誌，有助於效能診斷與調校。
  yaml
```
operationProfiling:
  slowOpThresholdMs: 100 # 將慢查詢門檻設為 100 毫秒
  mode: slowOp # 設為 slowOp，僅記錄慢查詢
```
  1
  2
  3

請注意，手動調整這些檔案內容，有可能被 ServBay UI 或其他管理操作覆寫。建議盡量於 ServBay UI 的 Additional Parameters 中新增或變更進階設定。

套用設定變更（重啟 MongoDB）

經由 ServBay UI 完成設定並點擊「儲存」後，ServBay 通常會自動執行設定同步。但如遇特殊狀況，或你因除錯需求手動編輯設定檔（再次強烈不推薦），可能需手動重啟 MongoDB 服務以令設定生效。

您可透過下列兩種方式來重啟 MongoDB：

透過 ServBay 管理介面重啟

開啟 ServBay 管理介面。
前往左側的 軟體包 清單。
在清單中找到對應版本的 MongoDB 軟體包。
點擊該軟體包旁的 重啟 按鈕。

透過 servbayctl 指令工具重啟

ServBay 也提供命令列工具 servbayctl，讓開發人員可於終端機快速管理服務。

打開終端機，執行以下命令即可重啟某一版本（例如 8.0）的 MongoDB 服務：

bash

servbayctl restart mongodb 8.0

此舉將通知 ServBay 安全停止並重新啟動指定版本的 MongoDB 套件。

常見設定應用情境

熟悉了 MongoDB 設定調整後，以下彙整常見開發場景，供您參考：

允許局域網其他裝置連線： 將 bindIp 設為 0.0.0.0（務必限於可信網路環境）。
避免連接埠衝突： 請將 port 設定為非預設值，使不同 MongoDB 實體或服務和諧共存。
提升效能： 可根據主機資源，上調 cacheSizeGB 以獲得更佳效能。
慢查詢診斷： 調整 operationProfiling 開啟慢查詢日誌，有助於效能除錯。

注意事項

優先利用 ServBay 圖形介面調整相關設定。
手動修改 /Applications/ServBay/etc/mongodb/<version>/mongod.conf 並不具持久性，未來 ServBay 更新或執行管理操作時可能遭到覆蓋。
統一提高 bindIp 至允許非本機存取時，務必重視網路安全，避免 MongoDB 實體暴露於不可信網絡。

常見問題（FAQ）

Q：我手動編輯了 mongod.conf，但發現設定沒生效甚至被還原，為什麼？

A：ServBay 會自動管理其軟體包設定檔，在重啟服務或執行其他管理流程時，有機會重建或覆蓋設定檔，因此手動修改的內容並不穩定、易被遺失。建議您務必使用 ServBay UI 進行持久化設定調整。

Q：如何在 ServBay 中找到 MongoDB 設定檔案？

A：預設路徑為 /Applications/ServBay/etc/mongodb/<version>/mongod.conf，其中 <version> 是您安裝的 MongoDB 版本號。

總結

ServBay 為開發者帶來便利、安全且完整的本地 MongoDB 設定工具。透過 ServBay 的圖形化介面，您可以輕鬆又持久地調整 MongoDB 各類設定（如監聽地址與連接埠）。儘管可直接檢查配置檔內容，強烈建議優先在 UI 端管理，以免人工修改導致不預期問題。熟悉常用設定項及如何透過 ServBay 重啟服務，將能協助你在本地開發專案中最佳化 MongoDB 的運用。

修改 MongoDB 設定 ​

透過 ServBay 圖形介面設定 MongoDB ​

了解 MongoDB 設定檔（僅供參考或臨時調整） ​

設定檔位置 ​

常見設定項與說明 ​

mongod.conf 常見設定參數 ​

套用設定變更（重啟 MongoDB） ​

透過 ServBay 管理介面重啟 ​

透過 servbayctl 指令工具重啟 ​

常見設定應用情境 ​

注意事項 ​

常見問題（FAQ） ​

總結 ​