Proxy Mode v3.9.0

proxy is pure reverse-proxy mode.

⚠️ EXPERIMENTAL FEATURE: proxy mode is part of the experimental upstream modes feature set and may change without notice.

Behavior

For unary and all streaming methods:

• Request is forwarded to upstream.
• Response, status, headers, and trailers are returned from upstream.
• Local stubs are not used for matching or response selection.

URL schemes

• grpc+proxy://host:port
• grpcs+proxy://host:port

For descriptor loading options, see Upstreams with gRPC reflection (when upstream supports reflection) or Upstreams without gRPC reflection (when local descriptors are needed).

Query parameters

Parameter	Default	Description
timeout	5s	Timeout for upstream requests.
bearer	—	Bearer token to include in upstream requests.
serverName	—	Override TLS server name (SNI).
insecureSkipVerify	false	Skip upstream TLS certificate verification.

Example:

gripmock "grpcs+proxy://10.0.0.5:8443?serverName=api.company.local&timeout=10s"

Order Service example

GRPC_PORT=4770 HTTP_PORT=4771 \
gripmock "grpcs+proxy://orders.api.local:8443?serverName=orders.api.local"

Point your application/test environment to localhost:4770. GripMock forwards every call and logs request/response (gRPC call completed), which is useful for baseline traffic inspection before creating stubs.

When to choose proxy

• You need immediate startup with no stub preparation.
• You want reverse-proxy behavior only.
• You want real traffic visibility in GripMock logs.