# light-frame-mq

**Repository Path**: cdlvyh/light-frame-mq

## Basic Information

- **Project Name**: light-frame-mq
- **Description**: 分布式消息平台
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-06-01
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## light-frame-mq

![license](https://img.shields.io/badge/license-Apache--2.0-green.svg)

light-frame-mq是一款轻量级的分布式消息队列，拥有 "水平扩展、高可用、高性能、海量数据堆积" 等分布式特点,并支持 "并发消息、串行消息、事务消费、失败重试、超时控制" 等消息特性。

![架构设计](https://gitee.com/cdlvyh/light-frame-mq/raw/master/doc/image/architecture_design.png)


## 一、功能简介

light-frame-mq是一款分布式消息队列，主要提供以下能力：

- 底层采用Netty框架进行数据通信
- 采用Zookeeper进行网络路由
- 支持集群模型，消费者负载均衡
- 支持同步、异步、单向、回调等多种消息发布方式
- 采用零拷贝原理，顺序写盘，支持亿级消息堆积能力
- 提供丰富的消息机制，如顺序消息，事务消息等
- 提供丰富的消息拉取模式，如单条、批量等
- 支持消息可查询

## 二、快速开始

请查看项目文档中[快速开始](https://gitee.com/cdlvyh/light-frame-mq/blob/master/quickstart.md)来了解如何快速上手使用light-frame-mq。

## 三、如何贡献

light-frame-mq欢迎广大开发者创建Pull Request来贡献代码，代码通过审核后会被合并到master主分支。

light-frame-mq编译环境要求为JDK8或以上版本，需要采用 [Apache Maven 3.5.0](https://archive.apache.org/dist/maven/maven-3/3.5.0/binaries/) 或者更高的版本进行编译。

## 四、感谢

light-frame-mq系统部分借鉴参考了XXL-MQ、Kafka、RocketMQ和MiniMQ等分布式消息队列框架整体架构设计思路，在此表示感谢。

## 五、示例

light-frame-mq的示例工程，详见light-frame-mq-sample。

## 六、开源许可

light-frame-mq基于Apache License 2.0协议，light-frame-mq依赖了一些第三方组件，其开源协议参见[依赖组件版权说明](https://gitee.com/cdlvyh/light-frame-mq/blob/master/NOTICE.md)。