fullstorydev/grpcui

어떤 프로젝트인가요?

핵심 기능

• 01gRPC 서비스 스키마에서 생성되는 대화형 웹 폼.
• 02서버 reflection, .proto 파일 또는 protoset 파일을 통한 스키마 탐색.
• 03mutual TLS를 포함한 일반 텍스트 및 TLS 연결 지원.
• 04단항 및 스트리밍 메서드와 raw JSON 요청 편집 지원.
• 05응답 헤더, 메시지, 오류 상태 및 트레일러 표시.
• 06다른 HTTP 서버에 UI를 임베드할 수 있는 Go 패키지 제공.

활용 사례

• 클라이언트를 작성하지 않고 개발 중인 gRPC 서비스를 직접 테스트.
• reflection으로 공개된 메서드를 통해 익숙하지 않은 gRPC API 탐색.
• 특정 메타데이터나 TLS 클라이언트 인증서가 필요한 요청 디버깅.
• 내부 Go 웹 애플리케이션에 gRPC 테스트 콘솔 임베드.

빠른 시작

1. 1

   Homebrew로 설치(macOS 또는 Linux)

   brew install grpcui
2. 2

   또는 Go 도구를 사용해 소스에서 설치

   go install github.com/fullstorydev/grpcui/cmd/grpcui@latest
3. 3

   평문 gRPC 서버를 대상으로 grpcui를 실행하고 출력된 URL을 브라우저에서 엽니다

   grpcui -plaintext localhost:12345

사용 전 알아둘 점

• !양방향 스트림은 대화형으로 사용할 수 없습니다. 모든 요청 메시지를 한 번에 입력해야 하며, 모든 응답이 함께 표시됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

grpcui은(는) 무엇인가요?

gRPC 서버에 요청을 대화형으로 보내는 브라우저 UI를 실행하는 CLI 도구로, REST용 Postman과 비슷합니다. grpcui를 사용하면 클라이언트 코드를 작성하지 않고도 웹 브라우저에서 gRPC 메서드를 호출할 수 있습니다. 서버를 대상으로 실행하면 서비스와 메서드를 선택하고, 요청 필드를 입력하고, 메타데이터를 추가한 뒤 응답 헤더와 본문, 트레일러를 확인할 수 있는 폼 기반 UI가 제공됩니다.

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

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

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

활발히 유지보수 중. grpcui의 마지막 커밋은 2026년 11월 2일입니다.

grpcui은(는) 어디에 사용할 수 있나요?

클라이언트를 작성하지 않고 개발 중인 gRPC 서비스를 직접 테스트. reflection으로 공개된 메서드를 통해 익숙하지 않은 gRPC API 탐색. 특정 메타데이터나 TLS 클라이언트 인증서가 필요한 요청 디버깅. 내부 Go 웹 애플리케이션에 gRPC 테스트 콘솔 임베드.

grpcui는 어떻게 설치하나요?

Homebrew로 설치(macOS 또는 Linux): brew install grpcui 또는 Go 도구를 사용해 소스에서 설치: go install github.com/fullstorydev/grpcui/cmd/grpcui@latest 평문 gRPC 서버를 대상으로 grpcui를 실행하고 출력된 URL을 브라우저에서 엽니다: grpcui -plaintext localhost:12345

grpcui은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fullstorydev/grpcui