membrane/api-gateway

어떤 프로젝트인가요?

핵심 기능

• 01선택적으로 요청을 검증하면서 OpenAPI 3.0, 3.1, 3.2 설명에서 API를 직접 배포합니다.
• 02WSDL로 기술된 SOAP 서비스를 OpenAPI 및 JSON REST 엔드포인트로 변환합니다.
• 03OpenAPI, JSON Schema, XSD, WSDL을 기준으로 메시지를 검증합니다.
• 04인증을 위해 API 키, OAuth2, JWT, WS-Security를 지원합니다.
• 05요청 제한, 로드 밸런싱, TLS 종료 기능을 제공합니다.
• 06Prometheus 메트릭과 OpenTelemetry 트레이스를 내보냅니다.

활용 사례

• 백엔드를 변경하지 않고 레거시 SOAP 서비스를 최신 JSON 또는 REST 클라이언트에 제공합니다.
• YAML 설정으로 기존 API 앞단에 OAuth2 또는 JWT 보호 기능을 추가합니다.
• 데이터베이스를 사용할 수 없는 환경에서 컨테이너로 경량 게이트웨이를 실행합니다.
• MCP 또는 LLM 게이트웨이를 통해 AI 에이전트나 LLM 클라이언트가 액세스할 수 있는 도구와 모델을 제어합니다.

빠른 시작

1. 1

   Membrane을 컨테이너로 시작합니다

   docker run --rm -it -p 2000:2000 predic8/membrane
2. 2

   README에 나온 프록시 설정으로 apis.yaml 파일을 만듭니다

3. 3

   apis.yaml을 마운트해 컨테이너를 실행합니다(Linux/macOS)

   docker run --rm -p 2000:2000 -v "$(pwd)/apis.yaml:/opt/membrane/conf/apis.yaml" predic8/membrane

사용 전 알아둘 점

• !Java 기반이므로 Docker 외부에서 실행하려면 Java 환경이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

api-gateway은(는) 무엇인가요?

REST 및 SOAP 서비스를 프록시하고 OpenAPI 배포, WSDL-to-OpenAPI 변환, OAuth2/JWT 보안, 메시지 검증 기능을 제공하는 오픈소스 API 게이트웨이입니다. Membrane은 Java로 작성된 API 게이트웨이로, 백엔드 서비스 앞단에서 라우팅, 변환, 보안, 트래픽 제어를 처리합니다. OpenAPI 설명(버전 3.0~3.2)에서 API를 직접 배포하고 OpenAPI, JSON Schema, XSD, WSDL을 기준으로 요청을 검증할 수 있습니다. Docker 컨테이너 또는 Java 애플리케이션으로 실행할 수 있고 데이터베이스가 필요하지 않으며, YAML로 설정합니다.

api-gateway은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

api-gateway은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

api-gateway은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. api-gateway의 마지막 커밋은 2026년 11월 6일입니다.

api-gateway은(는) 어디에 사용할 수 있나요?

백엔드를 변경하지 않고 레거시 SOAP 서비스를 최신 JSON 또는 REST 클라이언트에 제공합니다. YAML 설정으로 기존 API 앞단에 OAuth2 또는 JWT 보호 기능을 추가합니다. 데이터베이스를 사용할 수 없는 환경에서 컨테이너로 경량 게이트웨이를 실행합니다. MCP 또는 LLM 게이트웨이를 통해 AI 에이전트나 LLM 클라이언트가 액세스할 수 있는 도구와 모델을 제어합니다.

api-gateway는 어떻게 설치하나요?

Membrane을 컨테이너로 시작합니다: docker run --rm -it -p 2000:2000 predic8/membrane README에 나온 프록시 설정으로 apis.yaml 파일을 만듭니다 apis.yaml을 마운트해 컨테이너를 실행합니다(Linux/macOS): docker run --rm -p 2000:2000 -v "$(pwd)/apis.yaml:/opt/membrane/conf/apis.yaml" predic8/membrane

api-gateway은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/membrane/api-gateway