Redis 扩展模块 -- RedisBloom

发表于 2025-12-21 更新于 2025-12-22 分类于技术， redis

阅读次数：本文字数： 1.6k 阅读时长 ≈ 6 分钟

摘要

本文介绍 Redis 扩展模块 – RedisBloom 的使用方法
本文基于redis-7.4.7，springboot-3.5.8
Redis官网：https://redis.io/
Redis 命令文档：https://redis.io/docs/latest/commands/

RedisBloom 简介

RedisBloom 是 Redis 官方维护的一个扩展模块，隶属于 Redis Stack，专门用于提供概率型数据结构（Probabilistic Data Structures）的高性能实现。
它通过牺牲一定的精确性，换取极低的内存占用和极高的吞吐能力，非常适合海量数据场景下的“存在性判断”和“近似统计”。
该模块以 Redis Module 方式加载，可无缝集成到现有 Redis 实例中。
Redis8+，RedisBloom 已经内置在 Redis 中，不需要单独安装。

RedisBloom 提供的核心数据结构

1️⃣ Bloom Filter（布隆过滤器）
- 判断某个元素“可能存在 / 一定不存在”，但不存储元素本身，也不支持删除
- 维基百科对 Bloom Filter 的描述
- 生产环境推荐使用 Redisson的布隆过滤器
- 对应Redis命令： BF.xxx，详细的使用方法参见 Redis 命令及数据类型 -- BF(Bloom Filter)
2️⃣ Cuckoo Filter（布谷鸟过滤器）
- Bloom Filter 的增强版，支持删除元素
- 维基百科对 Cuckoo Filter 的描述
- 在高 QPS 查询场景下，Cuckoo Filter 通常优于 Bloom Filter。
- 低误判率 + 高负载率场景，Cuckoo Filter 更省内存。
- 对应Redis命令： CF.xxx，详细的使用方法参见 Redis 命令及数据类型 -- CF(Cuckoo Filter)
3️⃣ Count-Min Sketch（CMS）
- 近似统计元素出现频率
- 对应Redis命令： CMS.xxx
4️⃣ Top-K
- 统计访问频率最高的 K 个元素
- 对应Redis命令： TOPK.xxx

安装 RedisBloom

安装时需要科学上网，主要是安装依赖时需要从海外网下载，如果要部署在国内服务器，可能会连接失败。
可以在海外的相同配置的服务器上进行编译，之后将编译好的redisbloom.so上传到国内服务器即可。

mkdir -p /usr/local/soft/modules/
cd /usr/local/soft/modules
# clone 代码，这里 --recursive 是为了拉取子模块
git clone --recursive https://github.com/RedisBloom/RedisBloom.git
cd RedisBloom
# 推荐切换到稳定的release版本
git checkout v2.8.17
# 更新子模块，非必须，如果上面 clone 时没有加上 --recursive ，这个步骤就不能省略
git submodule update --init --recursive

# 检查并安装需要的依赖
./sbin/setup
## 输出
# readies version: 7fc8e62
dnf install -q -y ca-certificates
dnf install -q -y wget unzip
/usr/local/soft/modules/RedisBloom/deps/readies/bin/enable-utf8
dnf install -q -y git jq
dnf install -q -y which
/usr/local/soft/modules/RedisBloom/deps/readies/bin/getepel
/usr/local/soft/modules/RedisBloom/deps/readies/bin/getgcc --modern
dnf install -q -y valgrind
/usr/local/soft/modules/RedisBloom/sbin/get-fbinfer
dnf install -q -y lcov
/usr/bin/python3 /usr/local/soft/modules/RedisBloom/deps/readies/bin/getrmpytools --reinstall --modern
/usr/bin/python3 /usr/local/soft/modules/RedisBloom/deps/readies/bin/getcmake --usr
/usr/bin/python3 -m pip install --disable-pip-version-check --user  -r tests/flow/requirements.txt
/usr/local/soft/modules/RedisBloom/deps/readies/bin/getaws
/usr/bin/python3 -m pip install --disable-pip-version-check --user  pudb

# 编译
make
# 输出
Building /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/t-digest-c/src/libtdigest_static.a ...

Generating /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/t-digest-c/Makefile ...
-- The C compiler identification is GNU 11.5.0
-- The CXX compiler identification is GNU 11.5.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/gcc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/g++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Setting build type to 'Release' as none was specified.
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/t-digest-c

Building /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/t-digest-c/libtdigest_static.a ...
[ 50%] Building C object src/CMakeFiles/tdigest_static.dir/tdigest.c.o
[100%] Linking C static library libtdigest_static.a
[100%] Built target tdigest_static
Compiling deps/bloom/bloom.c...
Compiling deps/murmur2/MurmurHash2.c...
Compiling deps/rmutil/util.c...
Compiling src/rebloom.c...
Compiling src/sb.c...
Compiling src/cf.c...
Compiling src/rm_topk.c...
Compiling src/rm_tdigest.c...
Compiling src/topk.c...
Compiling src/rm_cms.c...
Compiling src/cms.c...
Linking /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/redisbloom.so...

./sbin/setup 报错

本人使用的是 Amazon Linux 2023(内核 6.1)，即 EL9，相当于CentOS 9，所以第一次运行会报错，大致报错信息如下：

./sbin/setup
## 错误信息
[FAILED] raven-release.el9.noarch.rpm: Status code: 403 for https://dyn.su/el9/base/x86_64/raven-release.el9.noarch.rpm (IP: 104.21.57.14)
Status code: 403 for https://dyn.su/el9/base/x86_64/raven-release.el9.noarch.rpm (IP: 104.21.57.14)

In /usr/local/soft/modules/RedisBloom/deps/readies/bin/getepel:
346      		# xinstall --allowerasing https://dl.fedoraproject.org/pub/epel/epel-release-latest-${EPEL}.noarch.rpm
347      	fi
348
349  >>> 	install_raven
350      	install_remi
351      	# install_centos_stream_repos
352

command failed: /usr/local/soft/modules/RedisBloom/deps/readies/bin/getepel

In /usr/local/soft/modules/RedisBloom/sbin/setup:
16       	python3 -m pip list
17       fi
18
19   >>> $ROOT/sbin/system-setup.py
20       if [[ $VERBOSE == 1 ]]; then
21       	python3 -m pip list
22       fi 编译安装时报错

## 错误分析与解决方法
问题原因：
    你这个错误不是 RedisBloom 本身的编译问题，而是 依赖环境初始化（readies / getepel）阶段失败，失败点非常明确。
readies/bin/getepel 脚本在 RHEL 9 / Rocky 9 / AlmaLinux 9 系统上尝试安装 Raven Repo，但该仓库地址 https://dyn.su/el9/... 已被 403 Forbidden 拒绝，导致脚本直接失败并中断 setup。
    这不是你机器的问题，而是 RedisBloom 依赖工具链对 EL9 的兼容性滞后。
    RedisBloom 的 ./sbin/setup 会调用 deps/readies/bin/getepel
    这个脚本用于：
        安装 EPEL
        安装 Raven Repo（EL9 特有）
        安装 Remi Repo
    但 Raven Repo 目前已不稳定 / 不再公开提供 rpm 下载，而 readies 代码仍然在强制安装。
    你的系统是 EL9 系列，日志中明确：raven-release.el9.noarch.rpm
    说明你使用的可能是如下系统中的一个：
        RHEL 9
        Rocky Linux 9
        AlmaLinux 9
        CentOS Stream 9

推荐解决方案:
   直接修改 getepel 脚本，禁用 install_raven
   vi deps/readies/bin/getepel，找到所有 install_raven，并将其注释掉即可

Redis 启用模块

将生成的 redisbloom.so 拷贝到 redis 的 modules 目录下（非必须）

1	cp /usr/local/soft/modules/RedisBloom/bin/linux-x64-release/redisbloom.so /usr/local/soft/redis-7.4.7/modules/redisbloom.so

Redis 启用模块有三种方法

# 1.将 redisbloom.so 添加到 redis.conf 中，需要重启 redis
loadmodule /usr/local/soft/redis-7.4.7/modules/redisbloom.so
# 2.也可以通过如下方式加载模块
redis-server --loadmodule /usr/local/soft/redis-7.4.7/modules/redisbloom.so
# 3.不需要重启redis
redis-cli MODULE LOAD /usr/local/soft/redis-7.4.7/modules/redisbloom.so

加载方式	是否持久
`MODULE LOAD`（redis-cli）	❌ 仅当前进程
命令行 `redis-server --loadmodule`	❌ 仅本次启动
`redis.conf` 中 `loadmodule`	✅ 永久生效（推荐/生产）

本文采用 loadmodule 加载模块

# 将 redisbloom.so 添加到 redis.conf 中，需要重启 redis
loadmodule /usr/local/soft/redis-7.4.7/modules/redisbloom.so

# 启动redis
redis-server redis.conf

# 登录测试
redis-cli --user admin --pass 123456
# 查看模块
127.0.0.1:6379> info Modules
## 输出
# Modules
module:name=bf,ver=20817,api=1,filters=0,usedby=[],using=[],options=[handle-io-errors]

127.0.0.1:6379> MODULE LIST
# 输出
1) 1) "name"
   2) "bf"
   3) "ver"
   4) (integer) 20817
   5) "path"
   6) "/usr/local/soft/redis-7.4.7/modules/redisbloom.so"
   7) "args"
   8) (empty array)