MongoDB

MongoDB 是流行的文件型 NoSQL 資料庫，使用 JSON 格式儲存資料，特別適合需要靈活資料結構的應用。

建立 MongoDB

在控制面板進入「資料庫」頁面
選擇「MongoDB」
選擇版本（建議使用 MongoDB 7）
設定參數：

參數	說明	範例
服務名稱	容器識別名稱	`my-mongodb`
Root 帳號	管理員帳號	`admin`
Root 密碼	管理員密碼	（自動產生）
初始資料庫	預設建立的資料庫	`myapp`

連線設定

# MongoDB 連線字串
mongodb://admin:password@mongodb-container:27017/myapp?authSource=admin

應用連線範例

// Node.js (mongoose)
const mongoose = require('mongoose');
await mongoose.connect(process.env.MONGODB_URL);

# Python (pymongo)
from pymongo import MongoClient
client = MongoClient(os.environ['MONGODB_URL'])
db = client.myapp

資料管理

建立集合與索引

// 建立索引以提升查詢效能
db.users.createIndex({ email: 1 }, { unique: true });
db.posts.createIndex({ createdAt: -1 });
db.products.createIndex({ name: "text", description: "text" });

資料匯出與匯入

# 匯出集合
mongoexport --uri="mongodb://admin:password@mongodb:27017/myapp?authSource=admin" \
  --collection=users --out=users.json

# 匯入資料
mongoimport --uri="mongodb://admin:password@mongodb:27017/myapp?authSource=admin" \
  --collection=users --file=users.json

# 完整資料庫備份
mongodump --uri="mongodb://admin:password@mongodb:27017/myapp?authSource=admin" \
  --out=/backup/

# 還原資料庫
mongorestore --uri="mongodb://admin:password@mongodb:27017/myapp?authSource=admin" \
  /backup/myapp/

效能調校

記憶體設定

MongoDB 的 WiredTiger 儲存引擎預設使用可用記憶體的 50% 作為快取：

# 自訂 WiredTiger 快取大小
storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 1

索引策略

為常用的查詢欄位建立索引
使用複合索引優化多欄位查詢
避免過多索引，因為索引會增加寫入開銷
定期使用 explain() 分析查詢計畫

常見問題

認證失敗

確認連線字串中包含 authSource=admin 參數，且帳號密碼正確。

記憶體使用過高

MongoDB 會盡可能使用可用記憶體來快取資料。你可以透過設定 cacheSizeGB 來限制記憶體使用量。對於 1 GB RAM 的 VPS，建議將快取設為 256 MB 至 512 MB。