Nginx共享内存由Master进程创建并统一管理,Worker通过偏移量访问,基于mmap(MAP_SHARED|MAP_ANONYMOUS)和写时复制实现零拷贝、天然一致;支持原子操作与共享锁保障并发安全,用于限流、缓存、Lua字典等场景。

核心在于:Master 进程创建一块所有 Worker 共享的物理内存,Worker 通过偏移量直接读写,无需拷贝、不走 IPC,天然一致。
Master 创建并统一管理共享内存块
启动时,Master 调用 mmap() 配合 MAP_SHARED | MAP_ANONYMOUS 分配匿名内存区域,内容初始化为 0。这块内存不绑定文件,纯属进程间共享用途。fork 出 Worker 后,借助 Linux 的写时复制(COW)机制,各 Worker 初始共享同一物理页;后续写操作仅私有化修改页,不影响其他 Worker 对原始共享区的访问。整个生命周期由 Master 控制——Worker 退出不释放,模块卸载前必须确保无活跃引用,否则易触发 core dump。
Worker 用偏移量安全访问,不依赖绝对地址
各 Worker 进程的虚拟地址空间中,该共享内存起始地址可能不同。Nginx 内部一律使用相对于共享块起始地址的字节偏移量定位结构体字段或哈希桶位置,避免硬编码指针或地址比较。例如,一个限流计数器结构体在 zone 中的位置由 key 哈希后查表得出偏移,所有 Worker 按同一套计算逻辑访问,自然保持视角一致。
原子操作与轻量锁保障并发安全
高频读写场景下,Nginx 提供两类同步机制:
-
无锁原子操作:如 stub_status 中的连接统计,直接对
ngx_atomic_t类型变量执行原子加减,底层依赖 CPU 指令(如 x86 的 LOCK XADD),无需内核态锁开销 - 共享内存互斥锁(ngx_shmtx_t):用于写入频次低但需强一致的场景,如 limit_req 的令牌桶更新。该锁基于共享内存中的标志位 + 自旋等待实现,避免系统调用,适合短临界区
典型应用:从配置到运行时数据同步
共享内存不是抽象概念,而是被具体功能直接驱动:
-
限流限连:通过
limit_req_zone或limit_conn_zone定义 zone,key(如 IP)映射到共享区哈希表,所有 Worker 共用同一计数器 - 缓存元数据:proxy_cache 的 key 索引、过期时间、状态标记等存于共享内存,减少磁盘或文件系统查找次数
-
Lua 自定义逻辑:用
lua_shared_dict声明字典,Lua 脚本中调用dict:incr()或dict:set(key, val, exptime),操作自动线程安全
reload 配置时 zone 默认清空,若需保留数据,须确保 zone 名称与大小未变更,且配合模块自身持久化策略。

















