Zedmos

5.3 Network

Everything about where the appliance is attached and how traffic leaves it: the interfaces themselves, the gateways beyond them, the routes that choose a gateway, and the tools for finding out why none of that is behaving.

Interfaces — /interfaces

Network: Interfaces
Network: Interfaces

One table for every interface the appliance has: its status, the name you gave it, the underlying device or devices, its address, its type, and whether it hands out DHCP. Group the table By Type or Alphabetically, and search it when the list grows.

Click a row to select it — Edit and Delete act on the selection — or double-click to open the editor directly.

Creating an interface

Network: the New Interface form
Network: the New Interface form

Create new opens one form that does what other firewalls split across three pages: it creates the device, assigns it, and configures its addressing and DHCP in a single save.

FieldWhat it means
NameWhat you will call it everywhere else — IOT network, Guest, Branch link.
TypeWhat kind of interface to make: a plain Ethernet assignment, or a VLAN, bridge, LAGG, PPPoE and the other virtual device types. The fields below change with the choice.
VLAN Protocol / Interface / VLAN IDFor a VLAN: the tagging standard (802.1Q normally, 802.1AD for Q-in-Q), the parent device, and the tag (1–4094).
RoleLAN or WAN. This is not cosmetic: it decides the default firewall treatment and whether the interface is treated as an uplink.
Addressing ModeManual (you type the address), DHCP (ask upstream — the normal choice for a WAN), or None (no address, e.g. a bridge member).
IP/NetmaskThe address and prefix length when addressing manually.
GatewayOnly for uplinks: the gateway this interface reaches the world through.
IPv6 ModeNone, Manual, DHCPv6, SLAAC, or Track (derive a prefix from another interface — how a LAN gets IPv6 from a WAN delegation).
DHCP serverTurn it on and give the range here; the appliance configures the DHCP backend for you.
SecurityBlock private networks and block bogon networks — sensible on a WAN facing the internet, wrong on an internal link.

Do not renumber the interface you are connected through without a plan. The change applies as soon as you save, your session drops, and you have to come back on the new address. Make such changes from the console, or from a second interface.

Gateways

Configuration — /gateways

Network: Gateways
Network: Gateways

Every gateway the appliance can send traffic to, with its address, the interface it lives on, its priority, and whether it is up. A gateway with monitoring enabled is pinged continuously; the loss and latency shown here are what failover decisions are made from.

Network: adding a gateway
Network: adding a gateway

The fields that matter: the interface and the gateway's address, the priority (lower wins when several can reach the same destination), the monitor IP (something reliably reachable through that gateway — an upstream router or a public resolver, not the gateway itself if the gateway answers pings while the line behind it is dead), and upstream gateway, which marks it as a default route candidate.

Group — /m/routing/gateway_group

Network: Gateway groups
Network: Gateway groups

A gateway group turns several gateways into one target that rules can point at. Each member sits in a tier: tier 1 is used while it is up, tier 2 takes over when everything in tier 1 is down, and so on. Members in the same tier share the load.

Network: adding a gateway group
Network: adding a gateway group

This is the mechanism behind dual-WAN failover: put both uplinks in a group, then point the LAN's outbound rule at the group instead of a single gateway. See Use cases → Two uplinks with failover.

Log File — /log/core/gateways

Network: Gateway log
Network: Gateway log

What the monitoring daemon has been reporting: a gateway going down and coming back leaves a line here, which is how you prove a line is flapping rather than "the internet being slow".

Routes

Configuration — /routes

Network: Static routes
Network: Static routes

Static routes: "to reach this network, hand the traffic to that gateway". You need them when a network behind a router on your LAN is not reachable through the default gateway.

Network: adding a static route
Network: adding a static route

Give the destination network in CIDR form and pick the gateway. Disabled routes stay in the list, which makes a route easy to test by turning it off.

Status — /diag/routes

Network: Route status
Network: Route status

The kernel's actual routing table — what the appliance will do, as opposed to what you configured. When a static route "does not work", compare the two: a route that is missing here never took effect, and a route that is present but unused is being beaten by a more specific one.

Log File — /log/core/routing

Network: Routing log
Network: Routing log

Routing changes as they happen, including the ones made automatically when a gateway fails over.

Settings — /m/interfaces/settings

Network: Global interface settings
Network: Global interface settings

Global behaviour shared by every interface: hardware offloading, IPv6 handling, and the other knobs that belong to the network stack rather than to one link.

Offloading options are a common cause of strange symptoms — throughput that collapses under load, or checksums that fail on one NIC model. If you are chasing something like that, this page is where you turn the relevant offload off. Change one thing at a time.

Virtual IPs

Settings — /m/interfaces/virtualip

Network: Virtual IPs
Network: Virtual IPs

Extra addresses the appliance answers on, beyond the one configured on the interface. Types:

  • IP Alias — an additional address on the same interface. The normal way to publish several public addresses.
  • CARP — a shared address owned by whichever node in a high-availability pair is master. This is what makes a failover invisible to clients; see High Availability.
  • Proxy ARP / Other — addresses the appliance answers for without binding them locally, used with NAT.

Network: adding a virtual IP
Network: adding a virtual IP

Status — /diag/vip

Network: Virtual IP status
Network: Virtual IP status

Which virtual addresses are live, and for CARP, whether this node is master or backup. On a pair, check this page on both nodes: two masters at once means the nodes cannot hear each other.

Wireless

Networks — /m/wireless/wireless

Network: Wireless networks
Network: Wireless networks

Wireless configuration for appliances with a radio: an access point (the appliance serves a network) or a client (the appliance joins one), with the SSID, the security mode and the key.

Network: adding a wireless network
Network: adding a wireless network

Wireless support depends on the radio and its FreeBSD driver. Access-point mode is limited to what the driver supports, which on most hardware means 802.11n or 802.11ac, not the newest standards. For a Wi-Fi network of any size, a dedicated access point behind the firewall is the better answer.

Status — /wireless-status

Network: Wireless status
Network: Wireless status

The live state of each radio: the interfaces that were actually created, the network in use, signal quality, and a scan of what else is nearby.

Diagnostics

Tools, not settings. Nothing on these pages changes the configuration.

PageWhat it answers
ARP Table/diag/arpWhich MAC address holds which IPv4 address on each segment. Two addresses claiming one MAC, or a MAC that keeps changing, is where you find a duplicate-address problem.
NDP Table/diag/ndpThe same for IPv6 neighbours.
Netstat/diag/netstatPer-interface counters: packets, bytes, errors, collisions. Rising errors point at a cable, a port or a duplex mismatch.
Ping/nettools#pingReachability from the appliance itself, with a choice of source interface — which is how you test what a client on that segment would see.
Trace Route/nettools#tracerouteWhere packets stop on the way out.
DNS Lookup/nettools#dnslookupWhat the appliance's resolver answers for a name — distinguishing "DNS is broken" from "the site is down".
Port Probe/nettools#portprobeWhether a TCP port is open from here. The quick test after a port forward.
Packet Capture/pcapA real capture on a chosen interface with a filter, downloadable as a .pcap for Wireshark. The last resort, and the one that always tells the truth.

Captures fill the disk. Bound them with a filter and a packet count, and delete them when you are done.