ioredis 是什麼？Node.js 高效能 Redis 客戶端完整介紹與使用範例

Q: 如何用 ioredis 連接 Redis Sentinel？

在建立連線時傳入 Sentinel 相關設定，或像本文範例一樣繼承 `Redis.SentinelConnector` 自訂 `connect()` 方法，動態從外部服務取得 Sentinel 清單後再進行連線。

這篇文章解決「Node.js 要用哪個 Redis 客戶端、怎麼用」的問題。我會先簡介 Redis 本身的記憶體存儲與持久化特性，再整理 ioredis 的完整功能清單，最後用一段完整的程式碼示範如何自訂 Sentinel Connector 並執行基本的 Redis 命令。

Redis 是什麼？為什麼它這麼快？

Redis 是 REmote DIctionary Server（遠程字典服務器）的縮寫，它以字典結構（key-value 鍵值對結構）存儲數據，並允許其他應用通過 TCP 協議讀寫字典中的內容。所以，Redis 是一個 key-value 存儲系統，或者說是一個 key-value 數據庫。

Redis 數據庫中的所有數據都存儲在內存中。由於內存的讀寫速度遠快於硬盤，因此 Redis 在性能上對比其他基於硬盤存儲的數據庫有非常明顯的優勢——在一台普通的筆記本電腦上，Redis 可以在一秒內讀寫超過十萬個鍵值。

將數據存儲在內存中也有問題，例如程序退出後內存中的數據會丟失。不過 Redis 提供了對持久化的支持，可以將內存中的數據異步寫入到硬盤中，同時不影響繼續提供服務。

ioredis 有哪些功能？

ioredis 是一個功能強大的 Redis 客戶端，已被世界上最大的在線商務公司阿里巴巴和許多其他公司所使用。它的主要特性包括：

功能齊全：支持 Cluster、Sentinel、Pipelining，還支持 Lua 腳本和 Pub/Sub（具有二進制消息的支持）。
高性能。
令人愉快的 API：它與 Node 回調和本機 Promise 一起使用。
命令參數和答復的轉換。
Transparent key prefixing（透明鍵前綴）。
Lua 腳本的抽象，允許定義自定義命令。
支持二進制數據。
支持 TLS。
支持 offline queue 和 ready checking。
支持 ES6 類型，如 Map 和 Set。
支持 GEO 命令（Redis 3.2 不穩定）。
複雜的錯誤處理策略。
支持 NAT 映射。

ioredis 使用範例：自訂 Sentinel Connector

下面是一個簡單的使用範例，示範如何建立一個從外部服務動態取得 Sentinel 清單的自訂 Connector，並執行基本的 get / set / del 命令：

"use strict";

const Redis = require("ioredis");
const MyService = require("path/to/my/service");

// Create a custom connector that fetches sentinels from an external call
class AsyncSentinelConnector extends Redis.SentinelConnector {
  constructor(options = {}) {
    // Placeholder
    options.sentinels = options.sentinels || [
      { host: "localhost", port: 6379 }
    ];

    // SentinelConnector saves options as its property
    super(options);
  }

  connect(eventEmitter) {
    return MyService.getSentinels().then(sentinels => {
      this.options.sentinels = sentinels;
      this.sentinelIterator = new Redis.SentinelIterator(sentinels);
      return Redis.SentinelConnector.prototype.connect.call(this, eventEmitter);
    });
  }
}

const redis = new Redis({
  Connector: AsyncSentinelConnector
});

// ioredis supports all Redis commands:
redis.set("foo", "bar");
redis.get("foo", function(err, result) {
  if (err) {
    console.error(err);
  } else {
    console.log(result);
  }
});
redis.del("foo");

// Or using a promise if the last argument isn't a function
redis.get("foo").then(function(result) {
  console.log(result);
});

// Arguments to commands are flattened, so the following are the same:
redis.sadd("set", 1, 3, 5, 7);
redis.sadd("set", [1, 3, 5, 7]);

// All arguments are passed directly to the redis server:
redis.set("key", 100, "EX", 10);

// Change the server configuration
redis.config("set", "notify-keyspace-events", "KEA");

更多範例請見 ioredis 官方 GitHub examples。

常見問題

Qioredis 和 node-redis 有什麼差別？

ioredis 是功能更完整的 Redis 客戶端，原生支持 Cluster、Sentinel、離線佇列與較複雜的錯誤處理策略；node-redis 則較輕量。需要 Sentinel 或 Cluster 功能時，ioredis 通常是首選。

Qioredis 支援 Promise 嗎？

支援。當命令的最後一個參數不是函數時，ioredis 會回傳 Promise；最後一個參數是函數時則走 Node 回調風格，兩種寫法可以混用。

Q如何用 ioredis 連接 Redis Sentinel？

在建立連線時傳入 Sentinel 相關設定，或像本文範例一樣繼承 Redis.SentinelConnector 自訂 connect() 方法，動態從外部服務取得 Sentinel 清單後再進行連線。

QRedis 的資料放在記憶體，重啟會消失嗎？

不會全部消失。Redis 提供持久化機制，可將內存中的數據異步寫入硬盤，且寫入過程不影響繼續提供服務。

參考資料

ioredis 官方 GitHub（含 examples 目錄）

最後更新

2026-08-28（原文發布於 2020-02-27，本文保留原始筆記內容並補上 GEO 結構。）

關於作者

Claire Chang ｜企業 AI 導入與流程轉型顧問。專注於 AI Agent 架構設計、ERP 系統整合與企業 AI 治理。

首次發布：2020-02-27