rudis

2024年路线图

Github | Gitee | 下载包 | Docker

<h4>高性能内存数据库</h4>

🔶 浏览文档 »

</div>

项目介绍

Rudis 是一个使用 Rust 语言编写的高性能键值存储系统，旨在利用 Rust 语言的优势重新实现 Redis 的核心功能，以满足用户对高性能、可靠性和安全性的需求，同时保持与 Redis API 的兼容性。

🌟 特性

跨平台，兼容 Windows、Linux、macOS 系统。
支持字符串、集合、哈希、列表、有序集合等数据结构。
提供 RDB 与 AOF 机制以支持数据备份和恢复。
具有卓越的处理速度和即时响应能力。
兼容 Redis 的命令和协议规范。
提供 Docker 部署方式。

快速入门

     /\_____/\
    /  o   o  \          Rudis 0.0.1
   ( ==  ^  == )
    )         (          绑定: 127.0.0.1:6379
   (           )
  ( (  )   (  ) )
 (__(__)___(__)__)

[2024-04-30T02:00:55Z INFO  rudis_server] 开始加载追加文件
[=======================================] 进度: 100% 行数: 6/6
[2024-04-30T02:00:55Z INFO  rudis_server] 服务器初始化完成
[2024-04-30T02:00:55Z INFO  rudis_server] 准备接受连接

普通安装

根据系统环境要求，下载匹配的 Rudis 版本

通过系统常规命令启动 Rudis 服务

// Windows 常规启动
start rudis-server.exe

// Windows 指定参数启动
start rudis-server.exe --port 6379

// Windows 指定配置文件启动
start rudis-server.exe --config rudis.properties

容器安装

通过 Docker 容器启动 Rudis 服务

如需更多安装命令，请前往 docker/README.md 查看

// Docker 常规启动
docker run -p 6379:6379 ghcr.io/sleeprite/rudis:latest

// Docker 指定参数启动
docker run -p 6379:8848 ghcr.io/sleeprite/rudis:latest --port 8848

配置说明

配置文件 (config): 指定 Rudis 配置文件路径。
绑定的主机地址 (bind): 指定 Rudis 服务器绑定地址。
端口 (port): Rudis 服务器监听端口，默认 6379。
密码 (password): 设置 Rudis 访问密码。
数据库数量 (databases): Rudis 数据库数量，默认 16。
数据持久化目录 (dir): RDB 和 AOF 文件存储目录，默认 "./"。
持久化日志路径 (appendfilename): AOF 日志文件存储路径。
开启持久化 (appendonly): 是否开启 AOF 持久化。
数据文件名 (dbfilename): RDB 持久化文件名，默认 "dump.rdb"。
会话上限 (maxclients): 最大客户端连接数，默认 1000。
定时任务频率 (hz): 定时任务执行频率，默认 10 次/秒。
RDB 保存策略 (save): 设置 RDB 自动保存条件。

项目结构

command

command 包是一个用 Rust 编写的模拟 Rudis 服务器的组件，主要负责实现 Rudis 协议的解析、数据库操作的执行以及相关结果的响应。该包内部包含了针对不同 Rudis 命令的实现，如 SELECT、GET、SET 等。其核心功能是根据 Rudis 协议规范，解析来自客户端的命令请求，并在模拟的 Rudis 数据库上执行相应的操作，再将结果返回给客户端。通过实现各个 Rudis 命令处理器，实现了对 Rudis 协议的完整支持，并提供了一个简单而有效的策略来处理不同类型的命令。

db

db 包是一个基于内存的数据库管理系统。该模块提供了基础的数据结构约定，以及数据库操作功能，包括对数据的增、删、改、查等操作。

persistence

persistence 模块提供了 AOF（Append-Only File）和 RDB（Rudis Database）两种持久化机制，它们共同确保了 Rudis 数据库的数据持久性和一致性。AOF 机制通过记录每个写操作并将它们追加到 AOF 文件中，实现了数据的持续更新和完整性。这种机制对于数据的准确性和可靠性至关重要，尤其是在系统故障或重启后能够确保数据的恢复。

session

session 模块的设计目的是提供一个简单的会话管理功能，用于跟踪用户的操作状态，例如用户所选的数据库索引以及用户是否已认证等信息。这对于需要进行用户认证或者跟踪用户操作状态的系统是非常有用的。

常用命令

echo 命令

127.0.0.1:6379> echo helloword
helloword

ping 命令

127.0.0.1:6379> ping
PONG

set 命令

127.0.0.1:6379> set user bailiang
OK

get 命令

127.0.0.1:6379> get user
bailiang

del 命令

127.0.0.1:6379> del username
(integer) 1
127.0.0.1:6379> del username password
(integer) 2

exists 命令

127.0.0.1:6379> exists user
(integer) 0

keys 命令

127.0.0.1:6379> keys *
(空列表或集合)

auth 命令

127.0.0.1:6379> auth 123456
OK

expire 命令

127.0.0.1:6379> expire user 10000
(integer) 0

select 命令

127.0.0.1:6379> select 1
OK

dbsize 命令

127.0.0.1:6379> dbsize
(integer) 2

append 命令

127.0.0.1:6379> append user bailiang
(integer) 10

move 命令

127.0.0.1:6379> move user 0
OK

rename 命令

127.0.0.1:6379> rename username new_username
OK

构建源码

如果你希望通过构建源码的方式获得发行包，请使用以下 cargo 常用命令。

// 普通启动
cargo run

// 带参数启动
cargo run -- --port 8848
cargo run -- --save 20/1 60/2

// 指定配置文件
cargo run -- --config rudis.properties

// 构建程序
cargo build

cargo build --release --target=x86_64-unknown-linux-musl

cargo build --release

// 代码检查
cargo clippy

开源共建

Rudis 项目遵循 GNU 通用公共许可证开源协议，感谢这些优秀的贡献者。

<表格> <行> <单元格> <a href="https://next.ossinsight.io/widgets/official/compose-recent-top-contributors?repo_id=788849401" target="_blank" style="display: block" align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://next.ossinsight.io/widgets/official/compose-recent-top-contributors/thumbnail.png?repo_id=788849401&image_size=auto&color_scheme=dark" width="373" height="auto"> <img alt="sleeprite/rudis 的顶级贡献者 - 最近 28 天" src="https://next.ossinsight.io/widgets/official/compose-recent-top-contributors/thumbnail.png?repo_id=788849401&image_size=auto&color_scheme=light" width="373" height="auto"> </picture> </a> </单元格> <单元格> <a href="https://next.ossinsight.io/widgets/official/compose-recent-active-contributors?limit=30&repo_id=788849401" target="_blank" style="display: block" align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?limit=30&repo_id=788849401&image_size=auto&color_scheme=dark" width="655" height="auto"> <img alt="sleeprite/rudis 的活跃贡献者 - 最近 28 天" src="https://next.ossinsight.io/widgets/official/compose-recent-active-contributors/thumbnail.png?limit=30&repo_id=788849401&image_size=auto&color_scheme=light" width="655" height="auto"> </picture> </a> </单元格> </行> </表格>