2022-04-15 13:44:08 +00:00
|
|
|
---
|
2022-10-26 15:16:05 +00:00
|
|
|
title: "Traefik TCP Middlewares IPAllowList"
|
|
|
|
description: "Learn how to use IPAllowList in TCP middleware for limiting clients to specific IPs in Traefik Proxy. Read the technical documentation."
|
2022-04-15 13:44:08 +00:00
|
|
|
---
|
|
|
|
|
2022-10-26 15:16:05 +00:00
|
|
|
# IPAllowList
|
2021-06-11 13:30:05 +00:00
|
|
|
|
|
|
|
Limiting Clients to Specific IPs
|
|
|
|
{: .subtitle }
|
|
|
|
|
2022-10-26 15:16:05 +00:00
|
|
|
IPAllowList accepts / refuses connections based on the client IP.
|
2021-06-11 13:30:05 +00:00
|
|
|
|
|
|
|
## Configuration Examples
|
|
|
|
|
2023-05-10 13:28:05 +00:00
|
|
|
```yaml tab="Docker & Swarm"
|
2021-06-11 13:30:05 +00:00
|
|
|
# Accepts connections from defined IP
|
|
|
|
labels:
|
2022-10-26 15:16:05 +00:00
|
|
|
- "traefik.tcp.middlewares.test-ipallowlist.ipallowlist.sourcerange=127.0.0.1/32, 192.168.1.7"
|
2021-06-11 13:30:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```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:
|
2022-10-26 15:16:05 +00:00
|
|
|
name: test-ipallowlist
|
2021-06-11 13:30:05 +00:00
|
|
|
spec:
|
2022-10-26 15:16:05 +00:00
|
|
|
ipAllowList:
|
2021-06-11 13:30:05 +00:00
|
|
|
sourceRange:
|
|
|
|
- 127.0.0.1/32
|
|
|
|
- 192.168.1.7
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml tab="Consul Catalog"
|
|
|
|
# Accepts request from defined IP
|
2022-10-26 15:16:05 +00:00
|
|
|
- "traefik.tcp.middlewares.test-ipallowlist.ipallowlist.sourcerange=127.0.0.1/32, 192.168.1.7"
|
2021-06-11 13:30:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```toml tab="File (TOML)"
|
|
|
|
# Accepts request from defined IP
|
|
|
|
[tcp.middlewares]
|
2022-10-26 15:16:05 +00:00
|
|
|
[tcp.middlewares.test-ipallowlist.ipAllowList]
|
2021-06-11 13:30:05 +00:00
|
|
|
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:
|
2022-10-26 15:16:05 +00:00
|
|
|
test-ipallowlist:
|
|
|
|
ipAllowList:
|
2021-06-11 13:30:05 +00:00
|
|
|
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).
|