mwan4

https://docs.mossdef.org/mwan4/
Admin
mwan4 is a multi-WAN configuration manager for OpenWrt that integrates with firewall4 and nftables...
Tokens:1,509
Snippets:20
Trust Score:5.4
Update:2 months ago
Show doc for...
Tokens:
Raw
### Example Migration Result

Source: https://docs.mossdef.org/mwan4

Shows the transformation of an interface configuration after automatic migration.

```uci
config interface 'wan'
	option enabled '1'
	list track_ip '1.1.1.1'
	option flush_conntrack 'always'
```

```uci
config interface 'wan'
	option enabled '1'
	list family 'ipv4'
	list track_ip '1.1.1.1'
	list flush_conntrack 'ifup'
	list flush_conntrack 'ifdown'
```

--------------------------------

### Configure Dual-Stack WAN Interface

Source: https://docs.mossdef.org/mwan4

Example configuration for a WAN interface supporting both IPv4 and IPv6, including tracking IPs and routing strategy definitions.

```text
config interface 'wan'
	option enabled '1'
	list family 'ipv4'
	list family 'ipv6'
	list track_ip '1.1.1.1'
	list track_ip '8.8.8.8'
	list track_ip '2606:4700:4700::1111'
	list track_ip '2001:4860:4860::8888'
	option reliability '2'
	option count '1'
	option timeout '2'
	option interval '5'
	option down '3'
	option up '8'

config route 'wan_m1_w1'
	option interface 'wan'
	option metric '1'
	option weight '1'

config strategy 'balanced'
	list use_route 'wan_m1_w1'

config rule 'default_rule_v4'
	option dest_ip '0.0.0.0/0'
	option use_strategy 'balanced'
	list family 'ipv4'

config rule 'default_rule_v6'
	option dest_ip '::/0'
	option use_strategy 'balanced'
	list family 'ipv6'
```

--------------------------------

### Configure Interface Family

Source: https://docs.mossdef.org/mwan4

Demonstrates the transition from legacy single-family interfaces to recommended dual-stack configurations.

```uci
config interface 'wan'
	option enabled '1'
	list family 'ipv4'
	list track_ip '1.1.1.1'

config interface 'wan6'
	option enabled '1'
	list family 'ipv6'
	list track_ip '2606:4700:4700::1111'
```

```uci
config interface 'wan'
	option enabled '1'
	list family 'ipv4'
	list family 'ipv6'
	list track_ip '1.1.1.1'           # IPv4 tracking
	list track_ip '2606:4700:4700::1111'  # IPv6 tracking
	option reliability '2'
```

--------------------------------

### Gathering MWAN4 diagnostic information

Source: https://docs.mossdef.org/mwan4

Run these commands to collect system and configuration state for support requests.

```bash
ubus call system board
uci export network
uci export mwan4
mwan4 status
nft list table inet fw4
```

--------------------------------

### Gathering MWAN4 interface and log data

Source: https://docs.mossdef.org/mwan4

Use these commands to inspect interface tracking status and recent logs for failover issues.

```bash
ls /var/run/mwan4/
logread -e mwan4 | tail -100
```

--------------------------------

### Configure flush_conntrack

Source: https://docs.mossdef.org/mwan4

Updates the conntrack flushing behavior from a single option to a list of events.

```uci
config interface 'wan'
	option flush_conntrack 'always'  # or 'never'
```

```uci
config interface 'wan'
	list flush_conntrack 'ifup'    # optional
	list flush_conntrack 'ifdown'  # optional
```

--------------------------------

### Configure Global Packet Mask

Source: https://docs.mossdef.org/mwan4

Sets a custom packet marking mask in the globals section.

```uci
config globals 'globals'
	option mmx_mask '0x3F00'
```

--------------------------------

### Rename Configuration Sections

Source: https://docs.mossdef.org/mwan4

Updates section types and references for routes and strategies.

```uci
config member 'wan_m1_w3'
	option interface 'wan'
	option metric '1'
	option weight '3'

config policy 'balanced'
	list use_member 'wan_m1_w3'

config rule 'https'
	option use_policy 'balanced'
```

```uci
config route 'wan_m1_w3'
	option interface 'wan'
	option metric '1'
	option weight '3'

config strategy 'balanced'
	list use_route 'wan_m1_w3'

config rule 'https'
	option use_strategy 'balanced'
```

--------------------------------

### Define Rule Family

Source: https://docs.mossdef.org/mwan4

Uses list format to restrict rules to specific IP families.

```uci
config rule 'default_rule_v4'
	option dest_ip '0.0.0.0/0'
	option use_strategy 'balanced'
	list family 'ipv4'

config rule 'default_rule_v6'
	option dest_ip '::/0'
	option use_strategy 'balanced'
	list family 'ipv6'
```
Tokens:
Raw