ServBay

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Appearance

在 ServBay 本地開發環境中管理與優化 Redis 資料庫 ​

Redis 是一套廣受歡迎的開源記憶體資料結構儲存系統，被廣泛應用於快取、訊息佇列、排行榜、即時分析等多種場景。ServBay 作為專為開發者打造的本地 Web 開發環境，內建 Redis，大幅簡化了在 macOS 上部署與管理 Redis 的流程。

本文將詳細說明如何在 ServBay 中高效管理與運用 Redis 資料庫，涵蓋安裝、設定、連線、備份、還原、效能優化與安全性管理等面向，協助開發者發揮 Redis 的強大優勢。

安裝與設定 Redis ​

ServBay 已預先內建 Redis，無須額外下載與安裝。您可透過 ServBay 圖形化介面輕鬆啟用或管理 Redis 套件。

啟用與管理 Redis 套件 ​

您可以透過 ServBay 應用程式介面的左方導覽列，或命令列工具 servbayctl 來管理 Redis 套件。

使用 ServBay 應用介面 ​

  1. 開啟 ServBay 應用程式。
  2. 在左側導覽列選取 套件。
  3. 展開 NoSQL 分類。
  4. 找到所需的 Redis 版本，點擊開關即可啟用或停用該套件。啟用後，ServBay 會自動啟動 Redis 服務。

使用命令列工具 servbayctl ​

ServBay 提供功能強大的 servbayctl 指令工具，方便您透過終端機管理服務。

bash
# 啟動指定版本的 Redis 服務
servbayctl start redis -all

# 停止指定版本的 Redis 服務
servbayctl stop redis -all

# 重啟指定版本的 Redis 服務
servbayctl restart redis -all

# 查看指定版本的 Redis 服務狀態
servbayctl status redis -all

設定 Redis ​

ServBay 為 Redis 提供了人性化的圖形化設定介面，讓您免去手動編輯複雜設定檔的負擔，輕鬆調整各種參數。

欲修改 Redis 設定，請在 ServBay 應用主畫面的左側導覽中選擇 套件 - NoSQL，再點擊已啟用 Redis 版本旁的齒輪圖示。若需更詳細的調整方式與選項，可參考 修改 Redis 設定 文件。透過 ServBay 的設定介面，您可以方便地調整記憶體限制、持久化策略、安全性設置等最佳化項目。

連線 Redis 資料庫 ​

Redis 服務啟動成功後，您可運用多種客戶端工具連線至 Redis 實例，進行資料操作與管理。常見管道包含命令列工具 redis-cli 與圖形化工具。

使用命令列工具 redis-cli 連線 ​

ServBay 已內建 redis-cli 工具，您可直接在終端機中使用。

  1. 使用 TCP/IP 連線： 這是最常見的連線方式，通常用於連接本機或遠端伺服器上的 Redis 實例。ServBay 預設將 Redis 綁定於 127.0.0.1 或 localhost，埠號設為 6379。

    開啟終端機，執行下列命令：

    bash
    redis-cli -h 127.0.0.1 -p 6379
# 或使用 localhost
# redis-cli -h localhost -p 6379

    若您的 Redis 已設定密碼，連線後請使用 AUTH 指令進行認證：

    bash
    AUTH your_password

  2. 使用 Unix Domain Socket 連線： 目前 ServBay 預設建議透過 TCP/IP 連線。Unix Domain Socket 主要用於同主機上的進程間高速通訊以提升效能，但對於 ServBay 的本地開發環境而言，TCP/IP 連線已經相當高效且易於管理。

使用圖形化工具連線 ​

目前市面上有許多優異的 Redis 圖形化管理工具可選，如 Redis Desktop Manager (Another Redis Desktop Manager)、Medis 等。這些工具提供直觀介面讓您便於檢視與管理 Redis 資料。

以 Redis Desktop Manager 為例：

  1. 啟動 Redis Desktop Manager 或您偏好的圖形工具。
  2. 新增連線配置。
  3. 輸入連線資訊：
    • 連線名稱 (Connection Name)：可自訂名稱，如 ServBay Redis。
    • 主機或 IP (Hostname/IP)：127.0.0.1 或 localhost。
    • 連接埠 (Port)：6379 (ServBay 預設埠)。
    • 認證 (Authentication)：若在 ServBay 中替 Redis 設定過密碼，請勾選認證選項並正確輸入密碼。
  4. 測試連線並儲存。連線成功後，即可透過圖形介面管理 Redis 資料。

Redis 資料庫管理 ​

成功連接 Redis 實例後，您可以執行各種資料庫操作，包括資料的存取、刪除及更多進階指令。

基本鍵值操作範例 ​

以下提供一些利用 redis-cli 進行基本操作的範例：

  1. 設定鍵值 (SET)：儲存字串資料。

    bash
    SET mykey "Hello from ServBay Redis!"

  2. 取得鍵值 (GET)：讀取指定鍵的值。

    bash
    GET mykey

    輸出結果應為 "Hello from ServBay Redis!"。

  3. 檢查鍵是否存在 (EXISTS)：

    bash
    EXISTS mykey

    存在回傳 1，否則回傳 0。

  4. 刪除鍵值 (DEL)：移除一或多個鍵及關聯值。

    bash
    DEL mykey

  5. 查詢所有鍵 (KEYS)：注意： 生產環境下應避免使用 KEYS 命令，因其會遍歷全部鍵值，有可能導致伺服器阻塞。在本地開發時請審慎使用。

    bash
    KEYS *

Redis 資料備份與還原 ​

資料備份對於資料庫管理至關重要。ServBay 支援 Redis 原生的持久化檔案備份。

手動備份 Redis 持久化檔案 ​

Redis 預設開啟 RDB 持久化，會將記憶體中資料快照儲存為 dump.rdb。您可手動備份這個檔案。

建議將備份檔案存放於 ServBay 指定的備份資料夾以便集中管理：

bash
/Applications/ServBay/backup/redis/

手動執行下列指令複製 dump.rdb 檔案：

bash
# 假設您使用 Redis 預設資料目錄
cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/redis/dump_$(date +"%Y%m%d%H%M%S").rdb

說明： /Applications/ServBay/db/redis/ 為 ServBay Redis 資料檔案預設路徑。$(date +"%Y%m%d%H%M%S") 會於檔案名稱中加上時間戳，便於區分各備份版本。

還原 Redis 資料 ​

手動還原 Redis 持久化檔案： 若您有 dump.rdb 備份檔，可將其複製回 Redis 資料目錄再重啟 Redis 服務。

  1. 停止 Redis 服務：
    bash
    servbayctl stop redis -all
  2. 備份檔案複製回資料目錄：
    bash
    cp /Applications/ServBay/backup/redis/your_backup_file.rdb /Applications/ServBay/db/redis/dump.rdb
# 請確認覆蓋既有的 dump.rdb 檔案
  3. 啟動 Redis 服務：
    bash
    servbayctl start redis -all
    Redis 重啟後會自動載入 dump.rdb 檔案中的資料。

Redis 效能優化 ​

儘管本地開發環境下效能未必為瓶頸，但了解基本的 Redis 效能優化策略仍大有助益。ServBay 的圖形化設定介面讓這些調校更加直覺。

記憶體優化 ​

Redis 是記憶體型資料庫，妥善管理記憶體極為重要。

  • 設定最大記憶體限制 (maxmemory)： 防止 Redis 佔用過多系統記憶體。達到限制時，Redis 會依淘汰策略釋放鍵值。
    ini
    # 範例：限制 Redis 最多使用 256MB 記憶體
maxmemory 256mb
  • 選擇合適的記憶體淘汰策略 (maxmemory-policy)： 達到記憶體上限時，決定哪些鍵被釋放。常見如 allkeys-lru（移除最近最少使用鍵）、volatile-lru（僅釋放設有過期時間且最近最少用的鍵）。
    ini
    # 範例：記憶體不足時優先移除所有鍵中最近最少使用的
maxmemory-policy allkeys-lru

上述設定可於 ServBay 的 Redis 設定介面中輕鬆調整。

持久化優化 ​

Redis 提供 RDB（快照）和 AOF（僅追加檔）兩大主流持久化方式。依資料重要性、回復速度與可容忍的資料遺失程度選擇或合併使用。ServBay 預設多啟用 RDB。

  • RDB 設定 (save)： 配置 Redis 在特定條件（時間與寫入數）自動快照。
    ini
    # 範例：
save 900 1   # 900 秒內至少 1 筆鍵值變動則快照
save 300 10  # 300 秒內至少 10 筆變動則快照
save 60 10000 # 60 秒內至少 10000 筆變動則快照
  • AOF 設定 (appendonly yes, appendfsync)： AOF 以日誌方式記錄每次寫操作。雖增加資料安全性，但檔案通常比 RDB 大，回復速度會較慢。
    ini
    # 範例：啟用 AOF
appendonly yes
# 範例：每秒同步一次 AOF，兼顧效能與安全
appendfsync everysec

您可於 ServBay 的 Redis 設定介面調教所需之持久化方案。

Redis 安全性管理 ​

即便在本地開發環境，仍建議完善基本安全控管，避免資料外洩甚至遭未授權存取。

設定訪問密碼 ​

為 Redis 設定認證密碼，是最簡單也最有效的防護手段。

於 ServBay 應用介面執行：

  1. 在左側導覽中選擇 套件 - NoSQL。
  2. 點擊啟用中 Redis 版本右側齒輪，進入設定畫面。
  3. 找到與密碼相關之項目（常標示為「需要密碼」或 "Password"）。
  4. 勾選啟用密碼欄位，並設定一組高強度密碼。
  5. 儲存設定後重啟 Redis 服務。

設置密碼後，所有客戶端連線都須使用 AUTH your_password 指令認證。這對應 Redis 設定檔的 requirepass 參數。

限制存取地址 ​

ServBay 預設 Redis 僅綁定本地回圈地址 (127.0.0.1 或 localhost)，意味只有本機程式可連接，這是本地環境下最安全的預設。

於 ServBay Redis 設定介面可找到 bind 相關選項。請確認設為 127.0.0.1 或 localhost。若設為 0.0.0.0 則任何地址皆可連線，本地開發環境建議謹慎使用，除非您有特殊需求且已另設防火牆保護。

ini
# 範例：僅允許本地存取 (ServBay 預設)
bind 127.0.0.1

常見問題及解決方案（FAQ） ​

使用 ServBay Redis 過程中，您可能會遇到下列常見問題及對應解法：

1. 無法連接 Redis 服務 ​

  • 問題描述： 嘗試利用 redis-cli 或圖形工具連線時，發生連線被拒絕（Connection refused）或逾時（Connection timed out）等錯誤訊息。
  • 解決方案：
    1. 檢查 Redis 服務是否運行中： 於 ServBay 介面 套件 - NoSQL 確認 Redis 狀態是否已啟用並執行。或執行 servbayctl status redis -all 查詢。
    2. 檢查連線位址與埠號： 確定客戶端設定為 127.0.0.1 或 localhost，埠號為 6379（ServBay 預設）。
    3. 檢查防火牆規則： 一般本地連線不會受防火牆影響，惟若系統設定有異，請確認開放 6379 埠的本地連線。
    4. 檢查 Redis 綁定地址： 確認 Redis 設定（bind 參數）允許來自 127.0.0.1 或 localhost 連線。於 ServBay 設定畫面核對此項。

2. 連線成功但操作需認證 (Authentication required) ​

  • 問題描述： 成功連上 Redis，但執行任一命令（如 GET、SET）均顯示 (error) NOAUTH Authentication required. 錯誤。
  • 解決方案： 這代表 Redis 已設過密碼。請連線後或於連線設定中正確輸入密碼。
    • 使用 redis-cli：連線後執行 AUTH your_password。
    • 圖形化工具：於連線設定中輸入正確密碼。

3. Redis 記憶體佔用過高 ​

  • 問題描述： Redis 程序佔用系統過多記憶體。
  • 解決方案：
    1. 檢查鍵數與資料大小： 用 INFO memory 查看記憶體用量、DBSIZE 查詢鍵總數。思考是否存放過多無用鍵或大型物件（例：巨集清單、集合等）。
    2. 設置 maxmemory 上限： 於 ServBay Redis 設定界面設定合理 maxmemory 防止爆量佔用。
    3. 調整 maxmemory-policy： 使用合適淘汰策略，保障內存不足時可自動釋放不常用鍵。
    4. 檢查持久化參數： AOF 設定為 always 或 RDB 存檔過於頻繁，皆可能提升記憶體壓力。

4. 資料未如預期持久化或遺失 ​

  • 問題描述： Redis 重啟後資料遺失，或持久化檔（dump.rdb、appendonly.aof）未更新。
  • 解決方案：
    1. 檢查持久化設定： 於 ServBay Redis 設定頁確認 save（RDB）及 appendonly（AOF）等參數已正確啟用並配置。
    2. 檢查檔案路徑及權限： 確認 ServBay Redis 資料目錄（/Applications/ServBay/db/redis/ 或類似路徑）存在，且 ServBay 進程有寫入權限。如曾手動更動檔案權限，請善加檢查。
    3. 手動觸發儲存： 連線 redis-cli 後，執行 SAVE（同步，阻塞）或 BGSAVE（非同步）觸發 RDB 快照，檢查 dump.rdb 是否順利產生。
    4. 檢查 AOF 檔案： 若已啟用 AOF，確認 appendonly.aof 是否存在且近期有寫入紀錄。

總結 ​

Redis 是功能強大的內存資料庫，ServBay 內建並極簡化管理，讓您在 macOS 本地開發環境中即刻啟用分布式快取與高效資料處理。

透過 ServBay 圖形化操作與 servbayctl 命令工具，您能輕鬆管理 Redis 套件，包括啟用、設定與維護。配合 redis-cli 或圖形化客戶端工具，可大幅提升資料操作效率。ServBay 整合式備份更為您的 Redis 資料安全提供可靠保障，而多元設定選項則讓您根據需求自由調校效能與安全等關鍵指標。

熟練本文介紹的操作技巧，您將能自信地於 ServBay 環境下管理、運用 Redis，為您的 Web 開發專案打造高速穩健的資料基礎！