Redis City

产品简介

Redis City 是一款把单个 Redis 实例"拆开看"的交互式 3D 教学工具。它由开发者 poltora.dev 制作并发布在 Hacker News 的 Show HN 板块，随后登上热门榜。与传统的文档或示意图不同，Redis City 用一整座可旋转、可缩放的立体"机房城市"来还原 Redis 的内部结构：外部客户端发出命令后，命令如何进入主线程、如何被解析、如何落到内存里的数据结构，全部以可视化的方式呈现在浏览器中。它把抽象难懂的内存数据库原理，变成了一件可以上手把玩的 3D 作品，特别适合已经会用 Redis、但想进一步搞懂它"为什么快、内存花在哪、持久化怎么工作"的开发者。

核心功能

• 分层的 3D 结构可视化：把 Redis 实例划分为代码层、进程内存层、操作系统内核层与持久化存储层，每一层都有明确的边界，用户一眼就能看清哪些部分属于 Redis 进程、哪些属于操作系统内核，避免把内核页缓存误当成另一台 Redis 服务器。
• 命令路径演示：可以在浏览器控制台输入命令，观察 SET、GET、DEL 等操作如何一步步穿过 RESP 解析器、命令检查、内存分配器等环节，并直接关联到 Redis 源代码的对应行号。
• 数据结构展柜：用颜色区分键值对象头、值、指针与 TTL 过期时间，展示小字符串如何共享同一块内存分配，而较大的值则使用 SDS、哈希表、quicklist、跳表或基数树等结构存储。
• 内置实验模块：提供多组可运行的实验，包括字符串从内嵌形式变为独立 SDS、哈希表由 listpack 转为字典、删除数据后进程常驻内存（RSS）为何仍然偏高、以及快照期间 fork 后的写时复制（COW）行为。
• 内存压力与淘汰演示：可以观察键值过期扫描，以及设置 maxmemory 上限后基于 LRU 抽样淘汰数据的过程，并对比 AOF 与 RDB 两种持久化方式的差异。
• 实时指标面板：提供键空间数量、已分配内存、模型时间、RSS 等实时数值，帮助用户建立"代码操作—内存变化"之间的直观联系。

特色优势

Redis City 最大的价值在于把"看不见的内存"变成了"看得见的结构"。多数 Redis 教程停留在命令层面，而它直接切入内存布局与操作系统交互，这是很多开发者长期存在理解盲区的地方。它同时明确标注自己是一个教学模型，而非连接真实服务器进行实时监控的工具，因此用户可以放心大胆地做各种破坏性实验，不必担心影响生产数据。整个项目的前端大量借助大语言模型生成，作者也公开表示这正是当前开发可视化项目的合理方式——这本身就是"用 AI 做产品"的一个典型案例。

应用场景

• 面试与原理复习：准备后端或中间件岗位面试时，用它快速回顾 Redis 的内存模型、持久化机制与淘汰策略。
• 团队内部分享：作为新人培训或技术分享的可视化教具，比纯 PPT 更容易讲清楚底层细节。
• 故障排查前的知识补充：理解 RSS 偏高、内存碎片、COW 等概念，为排查线上内存问题打基础。
• 教学与课程演示：高校或培训机构的数据库课程中，用它来讲解内存数据库的工作原理。
• 源码阅读辅助：对照 3D 结构去读 Redis 源码，降低理解门槛。

适用人群

已经掌握 Redis 基本命令、想深入理解其内部机制的后端工程师、运维工程师、架构师，以及正在学习内存数据库原理的学生和教师。

出品方

由独立开发者 poltora.dev 制作，基于 Redis 8.10.1 版本构建，属于个人出品的开源教学项目。

更新动态

项目于 2026 年 9 月登上 Hacker News Show HN 并进入热门榜，作者持续在其博客与 Telegram 频道更新 Redis 内部原理相关文章，并借助自动化工具将文章翻译为多种语言发布到站点。

官网链接

https://poltora.dev/redis