summaryrefslogtreecommitdiff
path: root/docs/vpp/configuration
diff options
context:
space:
mode:
authorNataliia S. <81954790+natali-rs1985@users.noreply.github.com>2025-12-18 16:46:57 +0200
committerGitHub <noreply@github.com>2025-12-18 14:46:57 +0000
commit71d4027b378f1e027cfe706dcc6578c2c0362d3e (patch)
tree32f107704d650fa9ec3cfbeeb0b403efd7ceb4b2 /docs/vpp/configuration
parent0b6cb91f0957b1a12c26ad502a8a70239d53fd81 (diff)
downloadvyos-documentation-71d4027b378f1e027cfe706dcc6578c2c0362d3e.tar.gz
vyos-documentation-71d4027b378f1e027cfe706dcc6578c2c0362d3e.zip
vpp: T7972: Delete option `nat44 no-forwarding` from CLI (#1717)
* vpp: T7972: Delete `nat44 no-forwarding` option from CLI * vpp: T7972: Update docs/vpp/configuration/nat/nat44.rst Co-authored-by: zdc <zdc@users.noreply.github.com> --------- Co-authored-by: zdc <zdc@users.noreply.github.com>
Diffstat (limited to 'docs/vpp/configuration')
-rw-r--r--docs/vpp/configuration/nat/nat44.rst42
1 files changed, 24 insertions, 18 deletions
diff --git a/docs/vpp/configuration/nat/nat44.rst b/docs/vpp/configuration/nat/nat44.rst
index 006edb86..ae5163cf 100644
--- a/docs/vpp/configuration/nat/nat44.rst
+++ b/docs/vpp/configuration/nat/nat44.rst
@@ -32,6 +32,30 @@ To configure dynamic NAT, you need to define a pool of public IP addresses that
Static rules are more suitable for scenarios where you need to provide consistent and predictable mappings between private and public IP addresses, also they are the only way to configure DNAT.
+NAT Rule Processing and Traffic Flow
+------------------------------------
+
+This section explains how different combinations of NAT rules affect traffic handling on a router. There are three possible combinations of NAT rules configurations:
+
+1. **Dynamic NAT Only**
+
+ * **All** traffic received on the "in" interface is processed by dynamic NAT rules without exceptions.
+
+2. **Dynamic + Static NAT**
+
+ * **All** traffic received on the "in" interface is first matched against static NAT rules.
+ * If no match is found, it is then processed by dynamic NAT rules.
+
+3. **Static NAT Only**
+
+ * **All** traffic on the "in" interface is checked against static NAT rules.
+ * If no match is found, the traffic is routed **without NAT**.
+
+.. important::
+
+ * If **dynamic NAT rules** are present, **all** traffic received on "in" interfaces is subject to NAT processing.
+ * If **only static NAT rules** are configured, traffic that does not match any static rule is routed unchanged.
+
Interfaces Configuration
========================
@@ -554,24 +578,6 @@ This setting helps prevent memory exhaustion and ensures predictable performance
# Increase session limit for high-capacity deployment
set vpp settings nat44 session-limit 100000
-Forwarding Behavior
--------------------
-
-By default, VyOS NAT44 forwards packets that don't match any NAT rules according to the routing table. This behavior can be controlled:
-
-.. cfgcmd:: set vpp settings nat44 no-forwarding
-
- Disable forwarding of packets that don't match existing NAT translations. When enabled, only packets that match static or dynamic NAT rules will be processed; all other traffic will be dropped.
-
-.. important::
-
- This is a significant difference from traditional NAT solutions. By default, VyOS NAT44 allows non-NAT traffic to be forwarded normally. Using ``no-forwarding`` creates a pure NAT-only device that drops any traffic not covered by NAT rules.
-
-**Use cases for no-forwarding:**
-
-* **Pure NAT gateway**: When the router should only handle NAT traffic and drop everything else
-* **Security isolation**: Preventing any non-NAT traffic from traversing the device
-
Worker Assignment
-----------------