Repolode
fullstorydev

fullstorydev/grpcui

gRPCサーバーにリクエストを対話的に送信するブラウザベースのUIを起動するCLIツール。REST向けのPostmanに相当します。

代替できる製品:Postman

スター
5,935
フォーク
426
未解決の Issue
79
最終コミット
5 日前

これは何?

grpcuiを使うと、クライアントコードを書かずにWebブラウザからgRPCメソッドを呼び出せます。サーバーに対して実行するとフォーム形式のUIが提供され、サービスとメソッドを選び、リクエストのフィールドやメタデータを入力して、レスポンスのヘッダー、本文、トレーラーを確認できます。

このツールはサーバーリフレクション、またはリフレクションを利用できない場合は.protoソースファイルやコンパイル済みのprotosetファイルからサービスのスキーマを取得します。リクエストフォームはメッセージ定義から動的に生成され、ネストされたメッセージ、oneof、map、Timestampなどのwell-known typesに対応しています。リクエストはraw JSONで入力することもできます。

平文接続とTLS接続の両方に対応し、相互TLSも利用できます。ストリーミングメソッドにも対応していますが、リクエストストリーム全体を送信前に作成し、レスポンスストリーム全体を受信後に表示するため、対話的な双方向ストリーミングには対応していません。また、既存のHTTPサーバーに同じUIを組み込むためのGoパッケージも提供しています。

主な機能

  • 01gRPCサービススキーマから生成される対話型Webフォーム。
  • 02サーバーリフレクション、.protoファイル、protosetファイルによるスキーマ取得。
  • 03平文接続とTLS接続に対応し、相互TLSも利用可能。
  • 04単項メソッドとストリーミングメソッドに対応し、raw JSONでのリクエスト編集も可能。
  • 05レスポンスのヘッダー、メッセージ、エラー状態、トレーラーを表示。
  • 06ほかのHTTPサーバーにUIを組み込むためのGoパッケージを提供。

ユースケース

  • クライアントを書かずに、開発中のgRPCサービスを手動でテストする。
  • リフレクションで公開されているメソッドを通じて、未知のgRPC APIを調べる。
  • 特定のメタデータやTLSクライアント証明書が必要なリクエストをデバッグする。
  • 社内のGo製Webアプリケーションに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を使うと、クライアントコードを書かずにWebブラウザからgRPCメソッドを呼び出せます。サーバーに対して実行するとフォーム形式のUIが提供され、サービスとメソッドを選び、リクエストのフィールドやメタデータを入力して、レスポンスのヘッダー、本文、トレーラーを確認できます。
grpcui は無料で使えますか?ライセンスは?
grpcui は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
grpcui は今もメンテナンスされていますか?
活発にメンテナンス中。grpcui の最終コミットは 2026年11月2日 です。
grpcui は何に使えますか?
クライアントを書かずに、開発中のgRPCサービスを手動でテストする。 リフレクションで公開されているメソッドを通じて、未知のgRPC APIを調べる。 特定のメタデータやTLSクライアント証明書が必要なリクエストをデバッグする。 社内のGo製Webアプリケーションに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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト