memphisos/memphis-broker

Memphis 消息代理镜像文档

概述

Memphis是下一代消息代理，作为传统消息代理的替代方案，它兼具RabbitMQ的简单性和Apache Kafka的健壮性，是一个简单、可靠且耐用的云原生消息代理，同时包裹了完整的生态系统。该镜像旨在实现经济高效、快速且可靠的现代队列应用开发，特别适合需要处理大量流数据和富集数据、使用现代协议、追求零运维、快速开发、显著成本降低及减少数据导向开发者和数据工程师开发时间的场景。

核心功能与特性

• 快速部署：3分钟内完成全优化消息代理部署
• 易用接口：直观的UI、CLI和多语言SDK
• 数据级可观测性：实时监控消息流状态
• 死信队列：自带自动消息重传功能的死信队列
• 模式管理：嵌入式Schemaverse，支持Protobuf/JSON/GraphQL/Avro等数据模式管理
• 多语言支持：提供Node.JS、Go、Python、TypeScript、NestJS、REST、.NET、Kotlin等SDK
• Kubernetes原生：完全适配Kubernetes环境
• 社区驱动：活跃的开源社区支持

使用场景

• 异步任务管理
• 实时流处理管道
• 数据摄入
• 云消息传递
  • 服务通信（微服务、服务网格）
  • 事件/数据流（可观测性、分析、机器学习/人工智能）
• 队列系统
• N:N通信模式
• 大规模摄入Grafana Loki日志

使用方法与配置说明

安装方式

Kubernetes（Helm）

shell
helm repo add memphis https://k8s.memphis.dev/charts/ --force-update && \
helm install my-memphis memphis/memphis --create-namespace --namespace memphis

Docker Compose

shell
curl -s https://memphisdev.github.io/memphis-docker/docker-compose.yml -o docker-compose.yml && \
docker compose -f docker-compose.yml -p memphis up

本地访问

Kubernetes环境

shell
# 从本地访问Memphis UI/CLI/SDK
kubectl port-forward service/memphis-cluster 6666:6666 9000:9000 7770:7770 --namespace memphis > /dev/null &

# 通过HTTP与 broker 交互
kubectl port-forward service/memphis-rest-gateway 4444:4444 --namespace memphis > /dev/null &

# 访问地址
Dashboard/CLI: http://localhost:9000
Broker: localhost:6666 (客户端连接)
REST网关: localhost:4444 (数据+管理)

生产环境注意：请通过k8s ingress/负载均衡器/nodeport暴露UI、集群和控制平面

Docker环境

shell
# 访问地址
Dashboard/CLI: http://localhost:9000
Broker: localhost:6666

架构概览

Memphis采用云原生架构设计，详细架构图及说明可参考官方文档。其核心组件包括消息代理集群、REST网关、UI控制台及嵌入式模式管理系统，实现高可用、可扩展的消息流处理。

Beta版本说明

Memphis当前处于Beta版本，团队仍在开发实时消息追踪、模式注册表和内联处理等关键功能，并完善更多SDK和支持材料。Beta版本对用户的影响有限：

• 消息代理核心部分已高度稳定
• 问题修复响应迅速

欢迎通过Star、PR、反馈、issue和功能建议支持项目发展，更多信息见官方文档。

支持与贡献

提问与反馈

欢迎通过***服务器提交问题、疑问和反馈。

缺陷报告

如遇到错误或问题，请https://github.com/memphisdev/memphis-broker/issues/new?assignees=&labels=type%3A%20bug&template=bug_report.md&title=%EF%BC%8C%E8%BF%99%E5%B0%86%E5%B8%AE%E5%8A%A9%E6%89%80%E6%9C%89Memphis%E7%94%A8%E6%88%B7%E3%80%82

功能请求

如对功能有建议或想法，请https://github.com/memphisdev/memphis-broker/issues/new?assignees=&labels=type%3A%20feature%20request%E3%80%82%E5%A6%82%E5%B7%B2%E6%9C%89%E7%B1%BB%E4%BC%BC%E8%AF%B7%E6%B1%82%EF%BC%8C%E8%AF%B7%E6%B7%BB%E5%8A%A0%22+1%22%E5%B9%B6%E8%A1%A5%E5%85%85%E7%9B%B8%E5%85%B3%E6%83%B3%E6%B3%95%E3%80%82

贡献指南

Memphis是开源项目，欢迎各类贡献（修复bug、提出新功能、改进文档、社区推广等）。贡献前请参考https://github.com/memphisdev/memphis-broker/blob/master/CONTRIBUTING.md%E5%92%8Chttps://github.com/memphisdev/memphis-broker/blob/master/CODE_OF_CONDUCT.md%E3%80%82

许可证

Memphis采用"Memphis Business Source License 1.0"许可，基于Apache 2.0修改，主要差异在于：

• 仅可将许可作品作为自身产品或服务的一部分使用，且不得作为消息代理或消息队列产品/服务
• 不得将许可作品作为服务提供、分发或使其可用（"服务"指允许第三方访问和使用许可作品的商业产品或托管服务）

完整许可文本见https://github.com/memphisdev/memphis-broker/blob/master/LICENSE%E3%80%82