Repolode
提交项目
2881099

2881099/csredis

面向 .NET 的 Redis 客户端库，支持 Sentinel、Cluster，提供同步与异步接口。

在 GitHub 查看
Star
2,057
Fork
423
未关闭 Issue
310
最近提交
23天前

这是什么？

CSRedis 是一个面向 .NET Core 与 .NET Framework 4.0+ 的 Redis 客户端库。方法名与 redis-cli 命令保持一致，熟悉 Redis 命令的开发者可以直接上手。

库支持单机 Redis、Redis Sentinel（含主从）以及 Redis Cluster，并同时提供同步和异步客户端。在较新的服务端版本上可使用 GEO 与 Stream 类命令，另外还包含管道、支持模式匹配的发布订阅，以及缓存壳（CacheShell）等辅助功能。

通过连接字符串即可配置密码、默认数据库、key 前缀、连接池大小和各类超时时间。针对 ASP.NET Core，项目还提供 RedisHelper 静态类以及实现 IDistributedCache 的 Caching.CSRedis 适配包。

核心功能

  • 01方法名与 redis-cli 命令保持一致
  • 02支持单机、Sentinel 主从和 Redis Cluster
  • 03同时提供同步与异步客户端
  • 04在对应版本的 Redis 上支持 GEO 与 Stream 命令
  • 05支持管道和模式订阅的发布订阅
  • 06提供 ASP.NET Core 的 IDistributedCache 实现

适用场景

  • 让 .NET 应用连接单机 Redis 或 Redis 集群
  • 在 ASP.NET Core 中将 Redis 用作分布式缓存
  • 通过管道批量执行异步写入以提高吞吐
  • 在 .NET 服务之间实现发布订阅消息通信

快速上手

  1. 1

    安装 CSRedisCore NuGet 包

    dotnet add package CSRedisCore
  2. 2

    使用 Redis 连接字符串创建客户端

使用前须知

  • 地理位置命令需要 redis-server 3.2 或更高版本，流（stream）命令需要 redis-server 5.0 或更高版本。
  • 官方 Redis 集群不支持多键命令、管道和 Eval 脚本。

标签

#redis#dotnet#csharp#redis-client#redis-cluster#caching#pub-sub#csredis#redis-sentinels

常见问题

csredis 是什么？
面向 .NET 的 Redis 客户端库，支持 Sentinel、Cluster，提供同步与异步接口。 CSRedis 是一个面向 .NET Core 与 .NET Framework 4.0+ 的 Redis 客户端库。方法名与 redis-cli 命令保持一致，熟悉 Redis 命令的开发者可以直接上手。
csredis 可以免费使用吗？用的什么许可证？
csredis 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
csredis 还在维护吗？
活跃维护中。csredis 最近一次提交是在 2026年10月15日。
csredis 适合用来做什么？
让 .NET 应用连接单机 Redis 或 Redis 集群 在 ASP.NET Core 中将 Redis 用作分布式缓存 通过管道批量执行异步写入以提高吞吐 在 .NET 服务之间实现发布订阅消息通信
csredis 怎么安装和运行？
安装 CSRedisCore NuGet 包: dotnet add package CSRedisCore 使用 Redis 连接字符串创建客户端
在哪里获取 csredis？
源代码和安装说明在 GitHub 上：https://github.com/2881099/csredis

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目