缓存KV存储数据库后端【免费下载链接】redisNative port of Redis for Windows. Redis is an in-memory database that persists on disk. The data model is key-value, but many different kind of values are supported: Strings, Lists, Sets, Sorted Sets, Hashes, Streams, HyperLogLogs. This repository contains unofficial port of Redis to Windows.项目地址https://gitcode.com/gh_mirrors/redis1/redis点击查看免费下载本文基于仓库根目录 Redis on Windows Release Notes.md 展开围绕 MSOpenTech 维护的 Redis on Windows 3.2 系列两份官方发布记录3.2.100 稳定版与 3.2.000-preview 技术预览版逐项解析其变更日志背后的 Windows 移植原理并结合仓库源码src/Win32_Interop/、src/cluster.c、src/rdb.c等与 Windows 配置示例给出可验证的工程细节。读完本文你将掌握该移植版在数字解析可移植性、后台保存崩溃、集群故障转移通信、日志目录布局四条核心问题线上的修复内容以及评估其生产可用性的正确姿势。一、版本发布概览Redis on Windows 3.2 系列共发布两个版本发布时间仅相隔约两周性质与可用性定位截然不同版本发布日期版本性质基线生产可用性3.2.000-preview2016-06-14技术预览Technical Previewantirez/redis/3.2 的 Windows 移植严禁用于生产存在已知 bug3.2.1002016-07-01首个稳定版First Stable Releaseantirez/redis/3.2.1 Windows 特定修复已通过全部标准测试但尚未经过生产环境验证两条关键信息值得注意稳定版的判定标准3.2.100 has passed all the standard tests但官方同时明确 it hasnt been tested in a production environment。因此文档给出明确的操作指引——在生产环境使用前必须在自己的测试环境中进行充分测试。这直接对应仓库中随源码分发的测试体系runtest、runtest-cluster、runtest-sentinel三个入口脚本以及tests/下的单元测试如 tests/unit/geo.tcl、tests/unit/bitfield.tcl、集成测试与集群/哨兵测试套件。版本号规律两个版本号共享 3.2 主版本主版本号与上游 Redis 3.2 系列保持同步3.2.000-preview 对应上游 3.2 分支起点3.2.100 对应上游 tag3.2.1合并后缀段则用于表达该移植版的修复迭代状态。二、3.2.100首个稳定版的变更日志逐项解析3.2.100 是 3.2 系列的第一个稳定版本其变更日志共 8 项可以归并为可移植性修复、崩溃修复、网络通信修复、清理与布局调整、上游合并五条主线。下面逐项结合仓库源码展开。2.1 [Portability] strtol / strtoul 修复Windows CRT 数字解析的可移植性原文[Portability] strtol and strtoul fixes.这是典型的 Windows 移植隐雷Windows CRTC Runtime Library与 Unix libc 在strtol/strtoul的返回类型与位数语义上存在差异——在 64 位 Windows 上标准strtol返回long仅 32 位而 Redis 的许多解析路径期望 64 位整数语义。仓库中的解决方式可在 Win32_APIs.h 中看到完整的宏映射#define strtoll _strtoi64 #ifdef _WIN64 #define strtol _strtoi64 #define strtoul _strtoui64 #endif在_WIN64构建下strtol被映射为_strtoi64、strtoul被映射为_strtoui64即统一以 64 位__int64语义解析有符号/无符号整数strtoll则无条件映射为_strtoi64。这套宏在 Redis 源码中大量使用例如config.c 中解析unixsocketperm八进制权限位server.unixsocketperm (mode_t)strtol(argv[1], NULL, 8);aof.c 中解析 AOF/RDB 文件头长度字段len strtol(buf1,NULL,10);cluster.c 中解析集群配置的currentEpoch/lastVoteEpochstrtoull(...)。如果没有这套位宽对齐64 位 Windows 上这些解析点会因为截断到 32 位long而产生错误的数值进而引发配置加载失败、集群纪元epoch错乱等隐性故障。3.2.100 针对这些解析函数的修复是整个移植稳定性的基石之一。2.2 [Fix] 后台保存期间可能的访问违规AV原文[Fix] Possible AV during background save.AV 指 Access Violation访问违规即 Windows 上的段错误/空指针解引用类崩溃触发场景是BGSAVE等后台保存流程。Redis 在 Unix 上通过fork()实现后台 RDB 保存而 Windows 没有原生fork该移植通过QFork 机制模拟相关实现集中在 Win32_QFork.cpp、Win32_QFork_impl.c 与头文件 Win32_QFork.h 中。从源码调用关系看rdb.c 在 Windows 分支下显式引入Win32_Interop/Win32_QFork.h而server.c、replication.c、config.c、debug.c、scripting.c等文件也涉及 bgsave 相关调用链rdbSave、BGSAVE命令入口等说明后台保存贯穿主服务、复制、持久化多个子系统。可以推断该 AV 大概率源于 QFork 子进程与主进程共享内存数据RDB 快照遍历时对某些数据结构的读写出现不一致例如快照过程中对象被并发释放或重分配导致子进程访问无效内存。3.2.100 修复了该路径这也是从技术预览走向稳定版所必须解决的崩溃级问题。修复前的 3.2.000-preview 版本存在多种已知 bug恰好印证了这一修复的紧迫性。2.3 [Fix] 使用重叠套接字overlapped sockets修复集群故障转移通信原文[Fix] Use overlapped sockets for cluster failover communication.集群故障转移failover是 Redis Cluster 的选举核心流程涉及多类集群总线消息。3.2.100 将集群故障转移通信切换为 Windows 的重叠overlappedI/O 套接字模式。从源码结构看该修复贯穿两个层面1套接字抽象层Win32_FDAPI.cpp 中的 FDAPI 封装族原生支持WSAOVERLAPPED语义例如FDAPI_WSASendL193-L208、FDAPI_WSARecvL211-L227、FDAPI_AcceptExL286、FDAPI_ConnectExL313、FDAPI_WSAIoctlL229并通过RFDMap维护 rfdRedis 文件描述符到 SOCKET 的映射相关声明位于 Win32_FDAPI.h 与 win32_wsiocp.hWSIOCPWindows Socket I/O Completion Port 抽象。2集群消息流程cluster.c 中故障转移的完整调用链可以这样串联从节点发起选举clusterRequestFailoverAuth()L2767-L2780构造CLUSTERMSG_TYPE_FAILOVER_AUTH_REQUEST消息并广播给所有节点主节点响应投票clusterSendFailoverAuthIfNeeded()L2809-L2910在满足条件后调用clusterSendFailoverAuth()发送CLUSTERMSG_TYPE_FAILOVER_AUTH_ACK消息落盘到连接clusterSendMessage()L2312-L2315将消息追加到link-sndbuf并注册写事件最终由clusterWriteHandler()L2227通过write(fd, ...)写出。在 Windows 上这个write(fd, ...)最终落在 FDAPI 的重叠 I/O 套接字实现上。3.2.000-preview 的已知问题恰好点名了集群故障转移功能在某些场景下无法正常工作3.2.100 用重叠套接字修复了这条通信链路——这一配对关系从侧面印证了该修复正是预览版到稳定版的关键差异之一。2.4 [Portability] Windows 可移植性修复原文[Portability] Windows portability fixes.这是一个覆盖面较广的归并项。结合仓库src/Win32_Interop/目录下的整体移植布局Win32_APIs.h、Win32_Portability.h、Win32_ANSI.c、Win32_Time.c、Win32_ThreadControl.c、Win32_EventLog.cpp、Win32_RedisLog.c、win32fixes.c等可以归纳移植版在 3.2 基线上的典型可移植性处理模式标准函数替换如 Win32_APIs.h 中的fseeko→_fseeki64、ftello→_ftelli64、snprintf→_snprintf、strcasecmp→_stricmp、sleep→Sleep、usleep→Sleep等随机数替换random()/rand()→replace_random()、srandom→srandWin32_APIs.h用于绕开 Windows CRT 与 Redis 自研随机数种子机制的差异文件操作替换rename→replace_rename、truncate()、lseek→lseek64Win32_APIs.h弥补 Windows 上对应 POSIX 语义的缺失。3.2.100 的Windows portability fixes即是在合并上游 3.2.1 后对这些移植层做的一次系统性收尾确保上游新代码在 Windows 上编译、链接与运行行为一致。2.5 Merged tag 3.2.1 from antirez/3.2上游合并原文Merged tag 3.2.1 from antirez/3.2.3.2.100 与 3.2.000-preview 的基线差异预览版基于上游 3.2 分支的 Windows 移植而稳定版将上游 tag3.2.12016 年 6 月发布的上游维护版合并进来获得该 tag 中全部的上游 bug 修复与改进。这意味着稳定版同时承载了上游 3.2.1 修复与Windows 移植修复两个维度的更新。2.6 [Setup] 日志子目录移除原文[Setup] Removed subdir for log, the log is now saved in the main redis dir.安装/默认布局变更此前日志被写入子目录如log/之类3.2.100 起日志直接保存在主 Redis 目录。仓库中两份 Windows 示例配置可以给出直观对照redis.windows-service.conflogfile server_log.txt—— 服务模式下日志落在主目录下的server_log.txt与dir ./L239配合即工作目录即主目录redis.windows.conflogfile —— 交互/前台模式下日志输出到标准输出配合logfile 时 Redis 将日志打到 stdout / Windows 事件日志。与之配套config.c 对logfile的解析在 Windows 分支下专门支持引号包裹的路径含空字符串与带引号的完整路径两种形态并随即调用setLogFile()完成 Windows 侧日志重定向——这正是在 Windows 文件系统路径含空格等场景下为logfile server_log.txt这类写法提供的解析支撑。移除子目录后无论是服务方式还是前台方式日志路径语义都更简单、更贴近开箱即用。2.7 [Cleanup] 清理工作原文[Cleanup cleanup] Minor changes.与[Cleanup] Removed unused project.两项清理性变更合并上游后做了一些小规模整理Minor changes并移除了一个不再使用的工程/项目文件Removed unused project。这类变更不改变功能行为属于发布前的工程卫生处理。三、3.2.000-preview技术预览版与已知问题3.1 定位与使用边界3.2.000-preview 发布于 2016-06-14是 3.2 系列的技术预览版性质上属于给社区提前体验 Windows 移植进度的版本。文档给出了明确的红线There are still known issues/bugs... This release SHOULD NOT be used in production.即存在已知问题/bug不应在生产环境使用。它的主要价值在于让使用者提前验证 Windows 移植的编译、启动、基本命令兼容性并收集问题反馈为后续 3.2.100 稳定版提供迭代输入。3.2 已知问题集群故障转移失效场景预览版最明确的已知问题来自集群子系统there is a bug that prevents the cluster fail-over functionality to work properly in certain scenarios.即在某些场景下集群故障转移fail-over功能无法正常工作。结合上文 2.3 的源码分析可以理解为什么该问题会在稳定版中被专项修复故障转移依赖多条集群总线消息FAILOVER_AUTH_REQUEST广播、FAILOVER_AUTH_ACK应答在节点间的可靠收发这些消息最终经由clusterSendMessage → clusterWriteHandler → write(fd)落到套接字上在 Windows 移植版中套接字走 FDAPI 封装其重叠 I/O 行为直接决定消息是否会在高并发/特定时序下丢失或错序。3.2.100 将故障转移通信切换到 overlapped sockets 后才解决了这类特定场景失效问题——这组预览版已知 bug → 稳定版针对性修复的对应关系是阅读这份发布说明最有价值的一条线索。四、3.2 基线的能力底色从源码佐证看该移植版承载的功能发布说明表明 3.2.100 合并了上游 3.2.1因此其功能面以上游 Redis 3.2 系列为准。从当前仓库的源码与测试布局可以印证 3.2 基线携带的核心能力GEO地理位置命令族src/geo.c、src/geohash.c、src/geohash_helper.c含deps/geohash-int/内的 geohash 整数编码实现配套测试 tests/unit/geo.tclBITFIELD 位域命令src/bitops.c配套 tests/unit/bitfield.tclQUICKLIST 列表数据结构ziplist 节点 双向链表组合src/quicklist.c/src/quicklist.h配套tests/unit/type/list*.tcl系列测试HyperLogLog、Streams 之前的数据模型src/hyperloglog.c等Streams 属于更晚版本本仓库中src/t_stream.c的存在说明该移植版基线已包含后续扩展但发布说明明确记录的基线上游 tag 为 3.2.1。需要强调的是发布说明本身聚焦于版本发布与修复记录上述功能特性属于该基线天然携带的上游能力本文仅作背景补充帮助读者理解这个移植版所服务的数据模型与命令面。五、总结如何正确评估与使用该版本综合两份发布记录可以得到对该移植版的完整使用结论版本选择3.2.000-preview 仅供技术预览与问题反馈严禁用于生产3.2.100 是 3.2 系列唯一稳定版但官方明确其未经过生产环境验证——因此正式上线前必须在自有测试环境完成充分验证含性能、稳定性、故障注入与集群场景这一点是文档给出的硬性操作建议。修复主线3.2.100 的 8 项变更日志覆盖了数字解析位宽strtol/strtoul见 Win32_APIs.h、后台保存崩溃QFork 路径见 rdb.c、集群故障转移通信overlapped sockets见 Win32_FDAPI.cpp 与 cluster.c、日志布局主目录直存见 redis.windows-service.conf四条工程主线。排障参考若在旧版遇到集群故障转移间歇失效应优先检查套接字层重叠 I/O与集群消息收发链路若遇到数值解析异常应核对 64 位整数宏映射是否生效。后续跟进本仓库仍持续携带 Windows 移植工程msvs/下的 Visual Studio 工程与msvs/setups/documentation/的 Windows 专用配置、tests/windows/regression.tcl回归测试如需深入可在这些路径继续阅读移植细节。参考文件索引发布说明原文Redis on Windows Release Notes.mdWindows 数字解析宏映射Win32_APIs.h后台保存与 QFork 接入rdb.c、Win32_QFork.cpp、Win32_QFork_impl.c重叠套接字封装Win32_FDAPI.cpp、win32_wsiocp.c集群故障转移流程cluster.clogfile解析Windows 分支config.cWindows 示例配置redis.windows-service.conf、redis.windows.conf3.2 基线功能佐证geo.c、bitops.c、quicklist.c、tests/unit/geo.tcl、tests/unit/bitfield.tcl赞分享缓存KV存储数据库后端【免费下载链接】redisNative port of Redis for Windows. Redis is an in-memory database that persists on disk. The data model is key-value, but many different kind of values are supported: Strings, Lists, Sets, Sorted Sets, Hashes, Streams, HyperLogLogs. This repository contains unofficial port of Redis to Windows.项目地址https://gitcode.com/gh_mirrors/redis1/redis点击查看免费下载相关推荐NumPy 1.9.1 发布说明深度解读bugfix 版本的关键修复与迁移指引NumPy 1.9.1 发布说明深度解读bugfix 版本的关键修复与迁移指引 NumPy 1.9.1 是 1.9.x 系列中的一次纯缺陷修复bugfix科学计算数据分析Node.js v0.6.3 发布说明深度解读npm 首次随 Node 分发与 Windows 平台关键修复Node.js v0.6.3 发布说明深度解读npm 首次随 Node 分发与 Windows 平台关键修复 本篇技术指南以 Node.js 官方博客的 v0前端文档CloudNativePG 1.28 发布说明深度解读Quorum 故障转移、声明式 FDW 与安全加固全解析CloudNativePG 1.28 发布说明深度解读Quorum 故障转移、声明式 FDW 与安全加固全解析 CloudNativePG 1.28 是 Ku云原生数据库高可用灾备容器编排创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考