2022-04-15 13:44:08 +00:00
|
|
|
---
|
|
|
|
title: "Traefik TCP Middlewares IPWhiteList"
|
|
|
|
description: "Learn how to use IPWhiteList in TCP middleware for limiting clients to specific IPs in Traefik Proxy. Read the technical documentation."
|
|
|
|
---
|
|
|
|
|
2021-06-11 13:30:05 +00:00
|
|
|
# IPWhiteList
|
|
|
|
|
|
|
|
Limiting Clients to Specific IPs
|
|
|
|
{: .subtitle }
|
|
|
|
|
2024-01-02 16:04:06 +00:00
|
|
|
IPWhiteList accepts / refuses connections based on the client IP.
|
|
|
|
|
|
|
|
!!! warning
|
|
|
|
|
|
|
|
This middleware is deprecated, please use the [IPAllowList](./ipallowlist.md) middleware instead.
|
2021-06-11 13:30:05 +00:00
|
|
|
|
|
|
|
## Configuration Examples
|
|
|
|
|
|
|
|
```yaml tab="Docker"
|
|
|
|
# Accepts connections from defined IP
|
|
|
|
labels:
|
|
|
|
- "traefik.tcp.middlewares.test-ipwhitelist.ipwhitelist.sourcerange=127.0.0.1/32, 192.168.1.7"
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml tab="Kubernetes"
|
2023-03-20 14:38:08 +00:00
|
|
|
apiVersion: traefik.io/v1alpha1
|
2021-06-11 13:30:05 +00:00
|
|
|
kind: MiddlewareTCP
|
|
|
|
metadata:
|
|
|
|
name: test-ipwhitelist
|
|
|
|
spec:
|
|
|
|
ipWhiteList:
|
|
|
|
sourceRange:
|
|
|
|
- 127.0.0.1/32
|
|
|
|
- 192.168.1.7
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml tab="Consul Catalog"
|
|
|
|
# Accepts request from defined IP
|
|
|
|
- "traefik.tcp.middlewares.test-ipwhitelist.ipwhitelist.sourcerange=127.0.0.1/32, 192.168.1.7"
|
|
|
|
```
|
|
|
|
|
|
|
|
```json tab="Marathon"
|
|
|
|
"labels": {
|
|
|
|
"traefik.tcp.middlewares.test-ipwhitelist.ipwhitelist.sourcerange": "127.0.0.1/32,192.168.1.7"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml tab="Rancher"
|
|
|
|
# Accepts request from defined IP
|
|
|
|
labels:
|
|
|
|
- "traefik.tcp.middlewares.test-ipwhitelist.ipwhitelist.sourcerange=127.0.0.1/32, 192.168.1.7"
|
|
|
|
```
|
|
|
|
|
|
|
|
```toml tab="File (TOML)"
|
|
|
|
# Accepts request from defined IP
|
|
|
|
[tcp.middlewares]
|
|
|
|
[tcp.middlewares.test-ipwhitelist.ipWhiteList]
|
|
|
|
sourceRange = ["127.0.0.1/32", "192.168.1.7"]
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml tab="File (YAML)"
|
|
|
|
# Accepts request from defined IP
|
2021-09-06 07:30:09 +00:00
|
|
|
tcp:
|
2021-06-11 13:30:05 +00:00
|
|
|
middlewares:
|
|
|
|
test-ipwhitelist:
|
|
|
|
ipWhiteList:
|
|
|
|
sourceRange:
|
|
|
|
- "127.0.0.1/32"
|
|
|
|
- "192.168.1.7"
|
|
|
|
```
|
|
|
|
|
|
|
|
## Configuration Options
|
|
|
|
|
|
|
|
### `sourceRange`
|
|
|
|
|
|
|
|
The `sourceRange` option sets the allowed IPs (or ranges of allowed IPs by using CIDR notation).
|