萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 安裝 memcacheq (mcq) 完整筆記:從依賴編譯到生產部署

什麼是 memcacheq?

memcacheq 是一個輕量級、高效能的分散式訊息佇列服務,協議與 memcached 相容(支援 set/get/stats),後端採用 Berkeley DB 持久化儲存,重啟不丟資料,專為高併發 Web 應用的非同步處理設計(如訂單寫入、日誌收集、快取刷新)。

為什麼不用 RabbitMQ / ActiveMQ?

傳統 MQ 為實現 AMQP/STOMP/XMPP 協議,架構重、依賴多、運維複雜。Web 應用多數只需「削峰填谷」的簡單佇列,memcacheq 以極簡協議、極高吞吐、極低延遲完美切中痛點。

核心特性

  • ⚡ 簡單易用:memcached 協議,現有 client 零成本遷移
  • 🚀 極速處理:單機輕鬆 10 萬+ ops/sec
  • 📦 多佇列支援:同一實例隔離多業務佇列
  • 🔄 優異併發:基於 libevent 非阻塞 I/O
  • 💾 持久化:Berkeley DB 保證掉電不丟資料

安裝前置依賴

# 1. libevent (若已裝 memcached 通常已有)
yum install libevent libevent-devel

# 2. Berkeley DB 5.3 編譯安裝
wget https://download.oracle.com/berkeley-db/db-5.3.28.tar.gz
tar zxvf db-5.3.28.tar.gz
cd db-5.3.28/build_unix
../dist/configure --prefix=/usr/local/berkeleydb
make && make install

# 關鍵:加入動態連結庫路徑
echo "/usr/local/berkeleydb/lib" >> /etc/ld.so.conf
ldconfig

編譯安裝 memcacheq

wget https://github.com/memcacheq/memcacheq/archive/refs/tags/0.2.0.tar.gz -O memcacheq-0.2.0.tar.gz
tar zxvf memcacheq-0.2.0.tar.gz
cd memcacheq-0.2.0

# 關鍵:指定 BDB 與 libevent 路徑
./configure --with-bdb=/usr/local/berkeleydb --with-libevent=/usr/local --enable-threads
make && make install

⚠️ 關鍵點: --with-bdb 路徑必須指向 Berkeley DB 的 安裝前綴(含 lib/、include/),而非 source 目錄。路徑錯誤會導致 make 失敗或執行時找不到 libdb-5.3.so。

啟動參數詳解

memcacheq -d -r -u root -p 21201 -H /data/memcacheq -N -v -L 1024 -B 1024 > /data/mq_error.log 2>&1
參數說明
-d守護程序模式
-r最大化 core dump 限制
-u <user>指定執行使用者(建議非 root)
-p <port>TCP 監聽埠(預設 22201)
-H <dir>資料庫家目錄(預設 /data1/memcacheq)
-N啟用 DB_TXN_NOSYNC,極大提升寫入效能
-v詳細輸出錯誤/警告
-L <KB>日誌緩衝區大小(預設 32KB)
-B <bytes>單則訊息最大長度(預設 1024 bytes)
-R自動清理不再需要的日誌檔

推薦生產環境啟動命令

# 建立專用使用者
useradd -r -s /sbin/nologin memcacheq
mkdir -p /data/memcacheq && chown memcacheq:memcacheq /data/memcacheq

# 啟動(建議寫入 systemd service)
memcacheq -d -u memcacheq -r -p 11212 -H /data/memcacheq -N -R -v -L 1024 -B 1024 > /var/log/memcacheq.log 2>&1

功能測試

telnet 127.0.0.1 22201
# 或
telnet 127.0.0.1 11212

# 進入後測試
set q1 0 0 5
hello
STORED

get q1
VALUE q1 0 5
hello
END

stats queue
STAT q1 1/0
END

PHP 整合範例

connect('127.0.0.1', 11212) or die("Connect failed");

// 寫入佇列
$mcq->set('order_queue', '{"order_id":1001,"action":"create"}', 0, 0);

// 讀取佇列
$msg = $mcq->get('order_queue');
echo "Queue: $msg\n";

$mcq->close();
?>

常見問題排查

錯誤:libdb-5.3.so: cannot open shared object file
未執行 ldconfig 或 /etc/ld.so.conf 路徑錯誤。檢查 ldd /usr/local/bin/memcacheq 確認庫路徑。
啟動報 not_STORED
-B 參數限制訊息長度,預設 1024 bytes。大訊息需調大 -B 65535。
效能不如預期
確認啟用 -N(NOSYNC)、-R(自動清理日誌),-L 設 1024KB 以上,-t 設為 CPU 核心數。

總結

memcacheq 以「極簡協議 + 持久化 + 高併發」三大特性,成為 Web 高併發非同步處理的最佳輕量選擇。關鍵在於:正確編譯 Berkeley DB、正確指定 -H/-B/-N 參數、使用專用使用者運行。

copyright © 萬盛學電腦網 all rights reserved