mirror of
https://github.com/traefik/traefik.git
synced 2025-05-05 23:43:01 +00:00
68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
---
|
|
title: "Traefik GrpcWeb Documentation"
|
|
description: "In Traefik Proxy's HTTP middleware, GrpcWeb converts a gRPC Web requests to HTTP/2 gRPC requests. Read the technical documentation."
|
|
---
|
|
|
|
The `grpcWeb` middleware converts gRPC Web requests to HTTP/2 gRPC requests before forwarding them to the backends.
|
|
|
|
!!! tip
|
|
|
|
Please note, that Traefik needs to communicate using gRPC with the backends (h2c or HTTP/2 over TLS).
|
|
Check out the [gRPC](../../../../user-guides/grpc.md) user guide for more details.
|
|
|
|
## Configuration Examples
|
|
|
|
```yaml tab="Structured (YAML)"
|
|
http:
|
|
middlewares:
|
|
test-grpcweb:
|
|
grpcWeb:
|
|
allowOrigins:
|
|
- "*"
|
|
```
|
|
|
|
```toml tab="Structured (TOML)"
|
|
[http.middlewares]
|
|
[http.middlewares.test-grpcweb.grpcWeb]
|
|
allowOrigins = ["*"]
|
|
```
|
|
|
|
```yaml tab="Labels"
|
|
labels:
|
|
- "traefik.http.middlewares.test-grpcweb.grpcweb.allowOrigins=*"
|
|
```
|
|
|
|
```json tab="Tags"
|
|
{
|
|
//...
|
|
"Tags" : [
|
|
"traefik.http.middlewares.test-grpcweb.grpcWeb.allowOrigins=*"
|
|
]
|
|
}
|
|
```
|
|
|
|
```yaml tab="Kubernetes"
|
|
apiVersion: traefik.io/v1alpha1
|
|
kind: Middleware
|
|
metadata:
|
|
name: test-grpcweb
|
|
spec:
|
|
grpcWeb:
|
|
allowOrigins:
|
|
- "*"
|
|
```
|
|
|
|
## Configuration Options
|
|
|
|
| Field | Description | Default | Required |
|
|
|:-----------------------------|:------------------------------------------|:--------|:---------|
|
|
| `allowOrigins` | List of allowed origins. <br /> A wildcard origin `*` can also be configured to match all requests.<br /> More information [here](#alloworigins). | [] | No |
|
|
|
|
### allowOrigins
|
|
|
|
More information including how to use the settings can be found at:
|
|
|
|
- [Mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin)
|
|
- [w3](https://fetch.spec.whatwg.org/#http-access-control-allow-origin)
|
|
- [IETF](https://tools.ietf.org/html/rfc6454#section-7.1)
|