momentry_core_0_1/docs/INSTALL_MARIADB.md

MariaDB 安裝指南 (本地部署)

概述

本文檔說明如何在 macOS 上安裝 MariaDB，配置為本地部署，支援遠端訪問。

---

當前狀態

項目	狀態
MariaDB	✅ 已安裝 v12.1.2
數據目錄	/Users/accusys/momentry/var/mariadb/
日誌目錄	/Users/accusys/momentry/log/
Plist	/Library/LaunchDaemons/com.momentry.mariadb.plist

---

安裝步驟

Step 1: 安裝 MariaDB (使用 brew)

# 安裝 MariaDB
brew install mariadb

驗證:

mariadb --version
# mariadb from 12.1.2-MariaDB

---

Step 2: 建立目錄結構

# 建立數據目錄
mkdir -p /Users/accusys/momentry/var/mariadb

# 建立配置目錄
mkdir -p /Users/accusys/momentry/etc/mariadb

# 建立日誌目錄
mkdir -p /Users/accusys/momentry/log

# 建立日誌文件
touch /Users/accusys/momentry/log/mariadb.log
touch /Users/accusys/momentry/log/mariadb.error.log

# 設定權限
chown -R accusys:staff /Users/accusys/momentry/var/mariadb
chown -R accusys:staff /Users/accusys/momentry/etc/mariadb
chown -R accusys:staff /Users/accusys/momentry/log

注意: 如果需要從舊數據遷移，需要先初始化新目錄:

# 初始化新數據目錄
mysql_install_db --datadir=/Users/accusys/momentry/var/mariadb

---

Step 3: 使用 plist 開機自動啟動

# 複製 plist 到 LaunchDaemons 目錄
sudo cp /Users/accusys/momentry_core_0.1/momentry_runtime/plist/com.momentry.mariadb.plist /Library/LaunchDaemons/

# 載入並啟動
sudo launchctl load /Library/LaunchDaemons/com.momentry.mariadb.plist

---

監控配置

添加到監控配置

在 monitor/config/monitor_config.yaml 中添加：

database:
  mariadb:
    enabled: true
    host: "localhost"
    port: 3306
    user: "root"

---

卸載步驟

重要: 路徑說明

路徑	類型	說明
/Users/accusys/momentry/var/mariadb/	數據	不要刪除 - 數據目錄
/Users/accusys/momentry/etc/mariadb/	配置	不要刪除 - 配置目錄
/Users/accusys/momentry/log/	日誌	不要刪除 - 日誌目錄
/opt/homebrew/opt/mariadb/	安裝	刪除 - MariaDB 安裝目錄

Step 1: 停止 MariaDB

# 找到 MariaDB 進程
ps aux | grep mariadb | grep -v grep

# 停止 MariaDB
mysqladmin -u root -p shutdown
# 或
pkill mariadbd

# 確認停止
ps aux | grep mariadb | grep -v grep || echo "MariaDB 已停止"

---

Step 2: 卸載 MariaDB

# 卸載 MariaDB
brew uninstall mariadb

# 移除 plist
sudo launchctl unload /Library/LaunchDaemons/com.momentry.mariadb.plist
sudo rm /Library/LaunchDaemons/com.momentry.mariadb.plist

---

Step 3: 刪除專屬檔案

# 刪除數據目錄 (可選)
rm -rf /Users/accusys/momentry/var/mariadb

# 刪除日誌 (可選)
rm -f /Users/accusys/momentry/log/mariadb.log
rm -f /Users/accusys/momentry/log/mariadb.error.log

注意: 不要刪除以下共用目錄:

# 這些是共用的，不要刪除!
# /Users/accusys/momentry/var
# /Users/accusys/momentry/log

---

Step 4: 卸載後檢查清單

echo "=== MariaDB 卸載後檢查 ==="

# 1. 檢查 MariaDB 進程
echo "1. MariaDB 進程:"
ps aux | grep mariadb | grep -v grep && echo "   ✗ 仍在運行" || echo "   ✓ 已停止"

# 2. Port 3306
echo "2. Port 3306:"
lsof -i :3306 > /dev/null 2>&1 && echo "   ✗ 仍被佔用" || echo "   ✓ 已釋放"

# 3. mariadb 命令
echo "3. mariadb 命令:"
which mariadb > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 4. brew 安裝
echo "4. brew 安裝:"
brew list mariadb > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 5. launchctl 服務
echo "5. launchctl 服務:"
sudo launchctl list | grep mariadb > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"

# 6. 數據目錄 (可選刪除)
echo "6. 數據目錄:"
[ -d "/Users/accusys/momentry/var/mariadb" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"

# 7. 日誌目錄 (可選刪除)
echo "7. 日誌目錄:"
[ -d "/Users/accusys/momentry/log" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"

預期結果:

=== MariaDB 卸載後檢查 ===
1. MariaDB 進程:
   ✓ 已停止
2. Port 3306:
   ✓ 已釋放
3. mariadb 命令:
   ✓ 已移除
4. brew 安裝:
   ✓ 已移除
5. launchctl 服務:
   ✓ 已移除
6. 數據目錄:
   ✓ 保留 (或 ✗ 已刪除)
7. 日誌目錄:
   ✓ 保留 (或 ✗ 已刪除)

---

手動檢查命令

# 1. 檢查進程
ps aux | grep mariadb | grep -v grep

# 2. 檢查 Port
lsof -i :3306

# 3. 測試連線
mariadb -u root -e "SELECT 1;"

# 4. 查看所有數據庫
mariadb -u root -e "SHOW DATABASES;"

# 5. 查看用戶
mariadb -u root -e "SELECT User, Host FROM mysql.user;"

# 6. 查看表
mariadb -u root -e "USE mysql; SHOW TABLES;"

# 7. 查看日誌
tail -20 /Users/accusys/momentry/log/mariadb.log

---

連線資訊

項目	值
Host	localhost
Port	3306
User	root

---

環境變數

在 .env 中:

MARIADB_URL=mariadb://root@localhost:3306

---

遠端訪問

• MariaDB 綁定到所有網路介面 (0.0.0.0)
• 本地網路其他機器可透過 IP 訪問
• 請設定用戶權限限制訪問

---

故障排除

MariaDB 無法啟動

# 檢查日誌
tail -f /Users/accusys/momentry/log/mariadb.log

# 檢查目錄權限
ls -la /Users/accusys/momentry/var/mariadb/

# 重新設定權限
chown -R $(whoami):staff /Users/accusys/momentry/var/mariadb

Port 被佔用

# 檢查哪個程序佔用 port 3306
lsof -i :3306

# 終止佔用程序
kill <PID>

需要重新載入 plist

# 卸載舊服務 (如果存在)
sudo launchctl unload /Library/LaunchDaemons/com.momentry.mariadb.plist 2>/dev/null

# 載入新服務
sudo launchctl load /Library/LaunchDaemons/com.momentry.mariadb.plist

---

檔案位置

類型	路徑	說明
安裝	/opt/homebrew/opt/mariadb/	MariaDB 安裝目錄
執行檔	/opt/homebrew/opt/mariadb/bin/mariadbd	MariaDB 執行檔
數據目錄	/Users/accusys/momentry/var/mariadb/	數據儲存
日誌	/Users/accusys/momentry/log/mariadb.log	執行日誌
錯誤日誌	/Users/accusys/momentry/log/mariadb.error.log	錯誤日誌
plist	/Library/LaunchDaemons/com.momentry.mariadb.plist	開機啟動
備份	/Users/accusys/momentry/var/mariadb_backup/	數據備份

---

備份與恢復

備份用戶配置

已創建專用備份用戶：

• 用戶名：momentry_backup
• 密碼：momentry_backup_pwd_2026
• 權限：SELECT, LOCK TABLES, SHOW VIEW, EVENT, TRIGGER

備份 (mysqldump)

# 備份所有數據庫
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mysqldump -u momentry_backup -pmomentry_backup_pwd_2026 --all-databases | gzip > \
    /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_all_${TIMESTAMP}.sql.gz

# 備份指定數據庫 (WordPress)
mysqldump -u momentry_backup -pmomentry_backup_pwd_2026 wordpress | gzip > \
    /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_wordpress_${TIMESTAMP}.sql.gz

# 驗證
sha256sum /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_*.sql.gz > \
    /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_${TIMESTAMP}.sha256

恢復 (mysql)

# 恢復所有數據庫
gunzip < /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_all_20260316_101802.sql.gz | \
    mysql -u momentry_backup -pmomentry_backup_pwd_2026

# 恢復指定數據庫
gunzip < /Users/accusys/momentry/backup/daily/mariadb/mariadb_db_wordpress_20260316_101802.sql.gz | \
    mysql -u momentry_backup -pmomentry_backup_pwd_2026 wordpress

數據目錄複製 (完整遷移) - 離線

# 1. 停止 MariaDB
mysqladmin -u momentry_backup -pmomentry_backup_pwd_2026 shutdown

# 2. 複製數據目錄
cp -r /opt/homebrew/var/mysql/* /Users/accusys/momentry/var/mariadb/

# 3. 設定權限
chown -R $(whoami):staff /Users/accusys/momentry/var/mariadb

# 4. 啟動 MariaDB
sudo launchctl load /Library/LaunchDaemons/com.momentry.mariadb.plist

---

版本資訊

• 版本: 12.1.2
• Port: 3306
• User: root
• 數據目錄: /Users/accusys/momentry/var/mariadb/
• 日誌目錄: /Users/accusys/momentry/log/