Repolode
Предложить
fullstorydev

fullstorydev/grpcui

CLI-инструмент, который запускает браузерный интерфейс для интерактивной отправки запросов на gRPC-серверы — аналог Postman для REST.

Open source альтернатива:Postman

Открыть на GitHub
Звёзды
5,936
Форки
427
Открытые issues
79
Последний коммит
5 дней назад

Что это?

grpcui позволяет вызывать методы gRPC из браузера, не написав клиентский код. Запустите его для сервера, и он откроет интерфейс с формами: в нём можно выбрать сервис и метод, заполнить поля запроса, добавить метаданные и посмотреть заголовки, тело и trailers ответа.

Инструмент получает схему сервиса через server reflection, а если reflection недоступен — из исходных файлов .proto или скомпилированных файлов protoset. Форма запроса динамически генерируется на основе определения сообщения и поддерживает вложенные сообщения, one-of, maps и well-known types, например Timestamp. Запрос также можно ввести как обычный JSON.

Поддерживаются соединения без шифрования и TLS, в том числе mutual TLS. Поддерживаются потоковые методы, но весь поток запросов формируется до отправки, а полный поток ответов показывается после её завершения, поэтому интерактивный двунаправленный стриминг недоступен. В проект также входят Go-пакеты, позволяющие встроить тот же интерфейс в существующий HTTP-сервер.

Ключевые возможности

  • 01Интерактивная веб-форма, создаваемая на основе схемы gRPC-сервиса.
  • 02Получение схемы через server reflection, файлы .proto или файлы protoset.
  • 03Поддержка соединений без шифрования и TLS, включая mutual TLS.
  • 04Поддержка унарных и потоковых методов, а также редактирования запросов в формате JSON.
  • 05Отображение заголовков и сообщений ответа, статуса ошибки и trailers.
  • 06Go-пакеты для встраивания интерфейса в другие HTTP-серверы.

Сценарии использования

  • Ручное тестирование gRPC-сервиса во время разработки без написания клиента.
  • Изучение незнакомого gRPC API через методы, доступные посредством reflection.
  • Отладка запросов, которым нужны определённые метаданные или клиентские TLS-сертификаты.
  • Встраивание консоли для тестирования gRPC во внутреннее Go-веб-приложение.

Быстрый старт

  1. 1

    Установите с помощью Homebrew (macOS или Linux)

    brew install grpcui
  2. 2

    Или установите из исходного кода с помощью инструмента Go

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

    Запустите grpcui для gRPC-сервера без шифрования и откройте выведенный URL в браузере

    grpcui -plaintext localhost:12345

Что важно знать

  • Двунаправленные потоки не поддерживают интерактивный режим: все сообщения запроса нужно вводить сразу, а все ответы отображаются вместе.

В подборках

Фреймворки микросервисов и инфраструктура сервисов

Темы

#grpc#api-testing#protobuf#golang#developer-tools#web-ui#postman

Частые вопросы

Что такое grpcui?
CLI-инструмент, который запускает браузерный интерфейс для интерактивной отправки запросов на gRPC-серверы — аналог Postman для REST. grpcui позволяет вызывать методы gRPC из браузера, не написав клиентский код. Запустите его для сервера, и он откроет интерфейс с формами: в нём можно выбрать сервис и метод, заполнить поля запроса, добавить метаданные и посмотреть заголовки, тело и trailers ответа.
grpcui можно использовать бесплатно? Какая у него лицензия?
grpcui распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
grpcui всё ещё поддерживается?
Активно поддерживается. Последний коммит в grpcui — 2 нояб. 2026 г..
Для чего можно использовать grpcui?
Ручное тестирование gRPC-сервиса во время разработки без написания клиента. Изучение незнакомого gRPC API через методы, доступные посредством reflection. Отладка запросов, которым нужны определённые метаданные или клиентские TLS-сертификаты. Встраивание консоли для тестирования gRPC во внутреннее Go-веб-приложение.
Как установить grpcui?
Установите с помощью Homebrew (macOS или Linux): brew install grpcui Или установите из исходного кода с помощью инструмента Go: go install github.com/fullstorydev/grpcui/cmd/grpcui@latest Запустите grpcui для gRPC-сервера без шифрования и откройте выведенный URL в браузере: grpcui -plaintext localhost:12345
Где скачать grpcui?
Исходный код и инструкции по установке — на GitHub: https://github.com/fullstorydev/grpcui

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты