predic8/membrane

Membrane API Gateway

镜像概述和主要用途

Membrane API Gateway是一个简单且可扩展的API网关，专为REST和遗留服务设计，基于Java编写。它提供了灵活的服务代理和API管理能力，可用于简化服务间通信、实现API路由、安全控制等功能，适用于企业级API管理和服务集成场景。

核心功能和特性

• 简单易用：通过XML配置文件（proxies.xml）即可完成网关规则定义，无需复杂代码开发
• 可扩展性：支持插件机制，可根据需求扩展功能
• 跨平台：基于Java构建，可在多种操作系统环境下运行
• Docker友好：提供官方Docker镜像，支持容器化部署和配置挂载

使用场景和适用范围

• 企业内部API服务的统一入口和管理
• REST API与遗留系统的集成和代理
• 服务路由、负载均衡和请求转发
• API访问控制、认证和授权实现
• 微服务架构中的API网关层部署

使用方法和配置说明

快速启动

通过以下命令快速启动Membrane API Gateway容器：

bash
docker run -p 2000:2000 docker.xuanyuan.run/predic8/membrane

启动后，访问http://localhost:2000或使用curl http://localhost:2000，将获得与访问http://api.predic8.de相同的响应。

自定义配置

Membrane通过名为proxies.xml的配置文件进行规则定义，典型配置示例：

xml
<api>
    <!-- 在此处定义API网关规则 -->
    <!-- 例如：<router>...</router> 或 <serviceProxy>...</serviceProxy> -->
</api>

挂载配置文件

要使用自定义配置文件启动容器，需将本地配置文件挂载到容器内的/opt/membrane/conf/proxies.xml路径：

Linux & Windows系统：

bash
docker run -v proxies.xml:/opt/membrane/conf/proxies.xml -p 2000:2000 docker.xuanyuan.run/predic8/membrane

macOS系统：

bash
docker run -v "$(pwd)/proxies.xml:/opt/membrane/conf/proxies.xml" -p 2000:2000 docker.xuanyuan.run/predic8/membrane

更多资源

• 完整文档：[***]
• 示例代码：https://github.com/membrane/api-gateway/blob/master/README.md
• 源代码：https://github.com/membrane/api-gateway/