This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
basic-network [2022/03/25 08:34] – add recommendation for Wireless Ethernet Bridge m_ars | basic-network [2025/08/28 03:25] (current) – old revision restored (2025/08/28 03:10) hogwild | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Network ====== | ====== Network ====== | ||
- | The Network | + | This page includes most basic settings needed to configure |
+ | |||
+ | Default settings are denoted with an asterisk (" * ") | ||
+ | |||
+ | \\ | ||
===== MultiWAN ===== | ===== MultiWAN ===== | ||
- | {{: | + | {{: |
- | **Number of WAN ports**: This lets you select the number of WAN ports to be used on the device. On routers with only one physical WAN interface, options with WAN ports larger than one will be greyed out. This allows you to select only “1 WAN” on such devices. | + | \\ |
- | **Tune route cache**: for multiwan in load balancing mode - This is a suggested settings if two or more of your WANs have a weight higher than 0. Basically | + | **Number of WAN ports**: lets you select the number |
- | <code bash> | + | On models with 1 physical WAN interface, only “1 WAN” can be selected. Other options are greyed out. |
- | # 2018-01-19 | + | |
- | # Reduce and flush the route cache to ensure a more synchronous load-balancing across multi-wan | + | |
- | # https:// | + | |
- | /bin/echo 1 > / | + | \\ |
- | /bin/echo 1 > / | + | |
- | /bin/echo 0 > / | + | |
- | /bin/echo 1 > / | + | |
- | /bin/echo 1 > / | + | |
- | /bin/echo 1 > / | + | |
- | /bin/echo 1 > / | + | |
- | /bin/echo 0 > / | + | |
- | /bin/echo 1 > / | + | |
- | /bin/echo 1 > / | + | |
- | #Causes connectivity issues if this value is too small, use defaults or tune accordingly | + | **Tune |
- | /bin/echo 512 > / | + | |
- | </ | + | |
- | **Check Connections Every: **This is a quick way to make FreshTomato automatically test the reliability of your WAN connection. (Default: Disabled). Choosing any setting other than [Disabled] will execute the Watchdog script. The Watchdog script | + | Recommended when 2 or more WANs have weight > " |
- | This setting specifies how often you want the router to send ICMP ping packets to check that it is still connected to the Internet. Choosing any setting other than Disabled will make the Target 1 and Target 2 fields appear. | + | For details, see the [[basic-network# |
- | **Target 1: **Address of first host you want FreshTomato | + | **Check Connections Every: **makes FreshTomato |
- | ===== WAN Settings ===== | + | This sets how often the router tests a WAN connection. Any option but Disabled runs the Watchdog script. \\ and reveals the " |
- | Settings in this section are used to configure the WAN interface. | + | \\ |
- | **Type: **This sets the connection mode the WAN interface uses to connect to your ISP. Depending on which Type you select, other configuration settings specific to that type of connection will be shown or hidden. See below. (Default: DHCP). The Type setting will depend on your ISP's setup. | + | * Target 1 -** **the address of the first host to ping \\ Google.com * |
+ | * Target 2 - the address | ||
- | **DHCP**: A DHCP server at your ISP will dynamically assign a WAN IP lease to your FreshTomato router. DHCP uses no authentication. | + | \\ |
- | **PPPoE**: The router' | + | (Default: Disabled). |
- | Starting with release 2021.3, support for Baby Jumbo Frames (RFC 4638) was added. FreshTomato will try to increase the WAN interface MTU to 1508. That is a PPPoE MTU/MRU value of 1500 with an 8 byte overhead. (Default is 1492). | + | \\ |
- | To enable Baby Jumbo Frames: | ||
- | - Enable jumbo frame support in the [[: | + | ==== WAN(x) Settings ==== |
- | - Set MTU to 1500 for PPPoE. | + | |
- | - Clamping can be disabled manually if needed \\ (Type //nvram set tcp_clamp_disable=1// at a FreshTomato command prompt). | + | |
- | Then verify (using ifconfig or ipconfig | + | Settings here are used to configure the WAN interface. These depend on your ISP. |
- | **Static: **This choice will configure your WAN port with a static IP. You must manually enter the static IP, subnet mask, gateway address and DNS server addresses into FreshTomato. These settings | + | Depending on the selected type, specific connection |
- | **PPTP**: This configures the WAN port to use Microsoft' | + | \\ |
- | **L2TP: **Choosing this will configure your WAN port to connect | + | **Type: **sets the connection mode the WAN interface uses to connect |
- | **3G modem: **This setting will enable support for a 3G GSM (cellular) network dongle connected to a USB port. Always ensure USB and 3G/4G modem support are checked in the [[: | + | \\ |
- | **4G/ | + | |
+ | * DHCP uses no use authentication, so it is not secure. \\ \\ | ||
- | **Disabled: | + | |
+ | * Usually used on DSL networks. | ||
+ | * User Name, Password, Service Name, and Options fields appear. | ||
+ | * Freshtomato stores the User Name / Password you enter. | ||
+ | * If authentication succeeds, the PPPoE server allows logon to the ISP. | ||
+ | * Since r2021.3, support for Baby Jumbo Frames | ||
+ | * When using Baby Jumbo Frames, set MTU to 1500, to match \\ the Baby Jumbo Frames change. (See: [[basic-network# | ||
- | **Wireless Client Mode: **This enables FreshTomato' | + | |
+ | * You must enter these settings from your ISP here: | ||
+ | * Static IP address | ||
+ | * Subnet mask | ||
+ | * Gateway address | ||
+ | * DNS server addresses \\ \\ | ||
- | * **Disabled: | + | * [PPTP]** **- configures the WAN port to connect using PPTP protocol. |
- | * **2.4 GHz**: FreshTomato | + | * User Name, Password, Gateway, PPTP Gateway, Options fields appear. |
- | * **5 GHz**: FreshTomato will enable Wireless Client mode on the 5 GHz interface. | + | |
+ | * Other settings required must be obtained from your ISP.\\ \\ | ||
- | | + | |
+ | * FreshTomato requires you to enter these L2TP settings (from your ISP): | ||
+ | * Uusername, password, server static IP/mask, gateway address. \\ \\ | ||
- | **Modem device: | + | |
+ | * To detect modems, enable | ||
- | You could also log on to FreshTomato via Telnet and use the lsusb or dmesg commands to get device info. When you set 3G modem or 4G/ | + | * [4G/LTE]** **- enables support for 4th generation cellular USB modems. |
+ | * PIN code and APN fields appear | ||
+ | * To detect modems, enable USB and 3G/4G/5G modem support in [[nas-usb|USB Support]]. \\ (The latter applies to releases before r2025.3).\\ | ||
- | **PIN Code: **This is the 3-digit PIN code for the SIM card associated with your cell account. Leave this field blank if your SIM card code has been deactivated. | + | * [Disabled]** **- disables |
+ | * This makes your device function only as a switch (if capable) and/or; | ||
+ | * It may effectively make your device function as a WiFi AP (if capable). \\ \\ | ||
- | **Modem init string: **Here, you enter the modem' | + | |
- | **APN: **The access point name (provided by your carrier). | + | This lets the router act as a client WiFi adapter |
- | **Username: **Here you enter the username to access your cell carrier' | + | \\ |
- | **Password: **Here you enter the password to authenticate to your cell carrier' | + | |
+ | | ||
+ | * [5 GHz] - enables Wireless Client mode on the 5 GHz band. | ||
- | **Network Type: **This menu appears when WAN type is set to 4G/LTE. (Default setting: 4G/3G/2G). The default setting configures FreshTomato to start negotiating with a 4G connection, and, if that fails, fall back to negotiating a 3G connection, and failing that, a 2G connection. | + | |
- | **DNS Server: ** | + | {{:pasted: |
- | * AUTO - FreshTomato | + | In MultiWAN configuration, |
- | * Manual - This enables FreshTomato' | + | |
- | * **DNS 1:** Enter the first DNS server address here. (only when DNS Server is set to Manual). | + | |
- | * **DNS 2:** Enter the second DNS server address here. (only when DNS Server is set to Manual). | + | |
- | \\ Manually chosen DNS servers are useful if your ISP's DNS servers are slow or unreliable, or can be used for parental filtering. | + | Load sharing is done on a per-session basis to avoid issues with interactive traffic such as: |
- | **MTU: | + | \\ |
- | | + | |
- | | + | |
+ | - Remote Desktop / RDP | ||
- | **Use DHCP: | + | \\ |
- | **Single Line MLPPP**: This is similar to Multilink PPP (MLPPP). Multilink PPP is a version | + | Per-packet loadsharing isn't recommended when link speeds vary. It can generate out-of-order packets, making interactive traffic unusable. |
- | **Route Modem IP:** When using a separate modem and router, you typically use the modem in bridge mode, or PPPoE passthrough mode. That means you can't easily access the modem' | + | \\ \\ //**Example: Load Balance Weight: 0 (Failover)**// |
- | **Query Hilink Modem IP:** This function | + | \\ \\ If " |
- | **Call Custom Status Script: **TBD. | + | \\ |
- | **Connect Mode: **This chooses which method is used to keep the FreshTomato router connected to the Internet provider. Selecting //Connect on Demand// | + | For example, say: |
- | Some Internet Providers drop a connection if their router sees no Internet activity. If you select // | + | \\ |
- | (Default: Keepalive). | + | * There are 2 WANs |
+ | * WAN0=" | ||
+ | * WAN1=" | ||
- | **Redial Interval: ** When PPPoE dialling fails, the Redial Interval is used to delay each attempt for the defined number of seconds. (Default: 10 seconds). This allows more time for the PPPoE server or network infrastructure to start functioning properly again before attempting another PPPoE connection. | + | \\ |
- | **LCP Echo Interval: **The Link Control Protocol | + | In this example, routing would proceed as follows: |
+ | |||
+ | \\ | ||
+ | |||
+ | - When the failure of WAN1 is detected, WAN0 will activate \\ (assigned with weight: " | ||
+ | - Later, WAN1 recovers its connectivity. As soon as FreshTomato \\ notices, (seconds/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | Recovery back to the originally-active interface is called // | ||
+ | |||
+ | \\ Any value > " | ||
+ | |||
+ | A weight of " | ||
+ | |||
+ | A good way to understand this is: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * " | ||
+ | * " | ||
+ | * Thus, if: \\ WAN0=“weight 0” and \\ WAN1=“weight 1”, then\\ WAN1 would handle 100% of the traffic. | ||
+ | |||
+ | \\ \\ // | ||
+ | |||
+ | \\ \\ Basically, an interface set to weight: " | ||
+ | |||
+ | * WAN0 = weight 0 | ||
+ | * WAN1 = weight 1 | ||
+ | * WAN2 = weight 5 | ||
+ | |||
+ | \\ \\ In this example, routing would proceed as follows: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | - WAN0 would be used only if WAN1 and WAN2 are failing/ | ||
+ | - WAN1 would handle the first new LAN client session through the router. | ||
+ | - WAN2 is set to handle the second, third, fourth, fifth and sixth sessions. | ||
+ | - The seventh new session would be treated as another, first new LAN client, \\ so would start again from WAN1. | ||
+ | - WAN2 would then handle the next five new sessions, (eighth through twelfth). | ||
+ | |||
+ | \\ \\ **These settings affect only outbound traffic.** Return traffic tries to return via the WAN interface it came from. | ||
+ | |||
+ | Allocation of new sessions to a WAN is dynamic. You can set which traffic is allocated to each Interface (" | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Modem device: **here, specify the 3G/4G/5G modem' | ||
+ | |||
+ | \\ {{:: | ||
+ | |||
+ | * Check your modem is listed in [[dongle_compatibility|3G/ | ||
+ | * If it isn't detected, enable //3G/4G/5G modem// and //USB support// in [[nas-usb|USB Support]]. \\ \\ | ||
+ | * If WAN type is 3G or 4G/LTE, fields appear asking for more input. \\ \\ | ||
+ | * The default device filename is the first serial device on the first USB port: | ||
+ | * For example, (in "/ | ||
+ | * “USB0” in the filename means the device is connected to the first USB port. | ||
+ | * Devices listed as "/ | ||
+ | * “ACM” in the device name type means a device type of: “Abstract Control Model” \\ \\ | ||
+ | * To get modem details, log on via Telnet/SSH and use " | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **PIN Code: **the 3-digit PIN code for the SIM card associated with your cell account. | ||
+ | |||
+ | * Leave this blank if your SIM card code was deactivated. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Modem init string: **enter the modem' | ||
+ | |||
+ | * This is obtained from your cellular provider or modem manufacturer. (Default: *99#). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **APN: **the access point name (provided by your cell carrier). | ||
+ | |||
+ | * Sets a gateway to route data between the carrier and the Internet. | ||
+ | * (Default: " | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Username: **the (carrier-provided) username to access your cell carrier' | ||
+ | |||
+ | * This field appears only when PPPoE, PPTP, or L2TP is selected in the //Type// menu. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | {{:: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Password: **the (carrier-provided) password to authenticate to your carrier' | ||
+ | |||
+ | * This field appears only when PPPoE, PPTP, or L2TP is selected in the //Type// menu. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Service Name:** the service name of the connection with your ISP. | ||
+ | |||
+ | * Most ISPs don't require a value here, so a blank entry is usually fine. \\ Very few small DSL or Fibre providers will require it. With those \\ providers, you must include it, you won't be able to log on to their network. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Options: | ||
+ | |||
+ | * This field appears only when PPPoE, PPTP or L2TP is chosen as the Connection Type. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Network Type: **appears when 4G/LTE WAN type is selected. (Default: 4G/ | ||
+ | |||
+ | * The default makes FreshTomato start negotiating with a 4G connection. \\ If that fails, it falls back to negotiating 3G. Finally, it tries a 2G connection. FIXME | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **DNS Server: ** here, you configure the DNS servers to use for name resolution. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | {{:: | ||
+ | |||
+ | * [AUTO] * - FreshTomato uses DNS server addresses offered \\ to your router in your ISP' | ||
+ | * [Manual] - enables DNS the server functions in dnsmasq. \\ This makes the "DNS 1" and "DNS 2" fields appear. | ||
+ | * DNS 1 - enter the IP address of your first DNS server here. | ||
+ | * DNS 2 - enter the IP address of your second DNS server here. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | Manually-set DNS servers can be useful if your ISP DNS servers are slow/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **MTU: | ||
+ | |||
+ | * [Default: 1500] * - fine for most Ethernet devices. \\ Choosing it greys out the Manual field. | ||
+ | * [Manual] - Enter a custom value. Jumbo Frames \\ start at 2000 bytes. | ||
+ | |||
+ | \\ Different MTU sizes across devices may cause issues. | ||
+ | |||
+ | This applies only to the WAN interface and won't affect LAN traffic. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Use DHCP: | ||
+ | |||
+ | * Very few Internet providers separate addressing from PPPoE functions. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Single Line MLPPP:** is outdated, and rarely used now. | ||
+ | |||
+ | This Multilink PPP version lets a modem bond the bandwidth of multiple PPPoE sessions.\\ | ||
+ | |||
+ | **Route Modem IP: **allows quick access to a modem/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | {{:: | ||
+ | |||
+ | * When using separate modem and router, usually the modem is in bridge mode or \\ passthrough mode. This makes it hard to access the modem' | ||
+ | * The router' | ||
+ | * Private addresses aren't routable, so by default, FreshTomato blocks any traffic\\ travelling from LAN --> WAN --> (MODEM with PRIVATE IP). \\ \\ | ||
+ | * Route Modem IP adds a static route to the routing table, giving the modem a\\ private address on a /32 subnet. This makes the private address reachable via \\ the WAN interface, and thus via the LAN. \\ \\ | ||
+ | * The mask allows only one host, so only the modem is reachable on that subnet. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | Default: blank/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Query Hilink Modem IP:** is for Huawei USB modems with Hilink mode. | ||
+ | |||
+ | This lets you communicate with a modem in Hilink mode connected to a LAN device other than the router. | ||
+ | |||
+ | This can be useful for monitoring modem statistics/ | ||
+ | |||
+ | (Default: 0.0.0.0/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Call Custom Status Script: ** allows you to define and execute a custom shell script. | ||
+ | |||
+ | This can be useful for monitoring or to report router status. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Connect Mode: **here, select the method to keep the router connected to the Internet provider. | ||
+ | |||
+ | \\ {{:: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [Connect on Demand] - makes the router disconnect from the ISP after \\ the //Max Idle Time//. FreshTomato reconnects to the Internet as soon as \\ a LAN client requests Internet access. \\ | ||
+ | * IP to trigger connect - the IP address whose activity will \\ trigger FreshTomato to reconnect to the Internet. | ||
+ | * Max idle time - the maximum period of inactivity after which \\ the router disconnects from the internet if no LAN client \\ is requesting access.\\ \\ | ||
+ | * [Keepalive] * - makes FreshTomato send keepalive packets at specified intervals. \\ Some ISPs drop the connection if they detect no Internet activity. \\ This option makes FreshTomato send [[https:// | ||
+ | * Redial Interval - how often FreshTomato checks the WAN connection. \\ This minimizes Internet connection response time, as usually \\ the connection will be up. (Default: 10 seconds). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Redial Interval: **if PPPoE dialing fails, this delays attempts for a defined number of seconds. | ||
+ | |||
+ | This allows the PPPoE server/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **LCP Echo Interval: **Link Control Protocol | ||
+ | |||
+ | * LCP Echo Interval is the time, in seconds | ||
+ | * Usually | ||
+ | * (Default: 10). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **LCP Echo Link fail limit:** number of failed echo requests between peers before a link is deemed down. | ||
+ | |||
+ | * The client modem will then drop the PPPoE link. | ||
+ | * LCP will then try to renegotiate a new PPPoE session. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | {{:: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Disable Watchdog: **disables the Watchdog function, only for the WAN connection in the menu. | ||
+ | |||
+ | Default: unchecked. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Watchdog Mode: **regularly checks a given WAN connection is up. | ||
+ | |||
+ | This setting allows you to choose the method used to test the connection. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * Traceroute * | ||
+ | * Ping | ||
+ | |||
+ | \\ | ||
+ | |||
+ | Watchdog supports the following connection types: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | - DHCP | ||
+ | - PPPoE | ||
+ | - PPTP | ||
+ | - L2TP | ||
+ | - 3G/4G/5G LTE | ||
+ | |||
+ | \\ | ||
- | **LCP Echo Link fail limit: **This is the number of times LCP echo request checks can fail between two LCP peers before the status is deemed to be dead. The client DSL modem will then drop the PPPoE link. When the link is terminated, LCP will try to renegotiate a new PPPoE session. | ||
===== LAN ===== | ===== LAN ===== | ||
- | The LAN section includes information and settings to configure FreshTomato' | + | The LAN section includes information and settings to configure FreshTomato' |
- | * LAN IP address and (sub)netmask | + | \\ |
- | * Spanning Tree Protocol function | + | |
- | * DHCP server status and settings (through dnsmasq), such as scope and lease time | + | |
- | * Stubby (DNS-over-TLS) setting and WINS settings | + | |
- | \\ | + | This includes: |
- | **STP**: Checking or unchecking this enables or disables | + | - LAN IP address and subnet mask |
+ | - Spanning Tree Protocol | ||
+ | - DHCP server status/ | ||
+ | - Stubby | ||
- | **IP Address: **Here you enter the IP Address you want to assign to the specified LAN interface. (Default: 192.168.1.1) | + | \\ |
- | **Netmask**: The (sub)netmask associated with FreshTomato' | + | **Bridge:** lets you selects the bridge whose LAN settings will be modified \\ \\ |
- | **DHCP**: Checking this box enables | + | **STP**: enables |
- | **IP Range //(first/last)//** : Here you enter the first address and last address of the DHCP Scope. This is the range of IP addresses FreshTomato' | + | The default |
- | **Lease Time (// | + | **IP Address:** the IP Address to assign to the specified LAN interface. |
+ | \\ | ||
+ | FreshTomato supports Class A/B/C networks. (Default: 192.168.1.1).\\ \\ | ||
+ | |||
+ | **Netmask**: | ||
+ | |||
+ | (Default: 255.255.255.0 - class " | ||
+ | |||
+ | **DHCP**: | ||
+ | |||
+ | **IP Range // | ||
+ | |||
+ | In the top field, enter the first valid address in the subnet. Enter the the last address in the bottom field. \\ \\ | ||
+ | |||
+ | **Lease Time (// | ||
+ | |||
+ | **Automatic IP**: lets FreshTomato obtain a LAN IP via DHCP. \\ Since release 2022.6, this option is supported in: \\ | ||
+ | |||
+ | - AP Mode | ||
+ | - Wireless Ethernet Bridge Mode | ||
+ | - Media Bridge Mode.\\ \\ | ||
+ | |||
+ | After saving settings, the router' | ||
===== Ethernet Ports State - Configuration ===== | ===== Ethernet Ports State - Configuration ===== | ||
- | [[https:// | + | Settings here are for the Ethernet Ports State graphic |
+ | |||
+ | \\ | ||
+ | |||
+ | {{basic-network-ethernet_ports_state_configuration-2024.1.png? | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Enable Ports State:** enables the Ethernet Ports State graphic. (Default: On). \\ \\ | ||
+ | |||
+ | **Show Speed Info:** checking this displays | ||
+ | |||
+ | (Default: On). \\ \\ | ||
- | **Show Speed Info:** | + | **Invert ports order:** displays port icons in the opposite order from where they are on the hardware. |
- | **Invert ports order: | + | This is useful |
===== Wireless Band Steering ===== | ===== Wireless Band Steering ===== | ||
- | [[https:// | + | This feature makes FreshTomato assess on which band a client should connect, then " |
- | Options: | + | \\ |
- | * Disable | + | {{:: |
- | * Enable | + | |
- | If you enable Wireless Band Steering, FreshTomato can decide, for each dual-band client device, on which band the client device should try to connect. To achieve this, enter the same SSID name, security settings, password, and other settings (see picture below) for all wireless interfaces (up to 3 on a Tri-Band-Router). | + | \\ |
- | Note: client devices can also try to switch bands on their own, without Wireless Band Steering' | + | When enabled, these settings are saved to NVRAM, then replicated from the first WiFi radio to all other radios: |
- | This example shows the default parameters to steer clients from the 2.4 GHz band to the 5 GHz band: \\ | + | \\ |
- | < | + | |
- | Steer Policy: | + | - Broadcast |
- | max=0 period=5 cnt=3 rssi=-52 phyrate_high=110 phyrate_low=0 flags=0x22 state=3 | + | - KEY1-4 |
- | Rule Logic: OR | + | - Shared Key |
- | RSSI: Greater than | + | - Encryption |
- | VHT: Allowed | + | - Radius Key |
- | NON VHT: Allowed | + | - Radius Port |
- | NEXT RF: NO | + | - Radius IP |
- | PHYRATE (HIGH): Greater than or Equal to | + | |
- | LOAD BALANCE: NO | + | |
- | STA NUM BALANCE: NO | + | |
- | PHYRATE (LOW): Less than | + | |
- | N ONLY: NO | + | |
- | </ | + | |
- | \\ | + | \\ |
- | <code -> | + | (Visibility depends on the wireless security selected) |
- | Steer Policy: | + | |
- | max=80 period=5 cnt=3 rssi=-82 phyrate_high=0 phyrate_low=0 flags=0x20 state=2 | + | |
- | Rule Logic: OR | + | |
- | RSSI: Less than or Equal to | + | |
- | VHT: Allowed | + | |
- | NON VHT: Allowed | + | |
- | NEXT RF: NO | + | |
- | PHYRATE | + | |
- | LOAD BALANCE: NO | + | |
- | STA NUM BALANCE: NO | + | |
- | PHYRATE (LOW): Less than | + | |
- | N ONLY: NO | + | |
- | </ | + | |
- | \\ | + | \\ |
- | Wireless Band Steering | + | Among the settings that will NOT be replicated are: |
+ | |||
+ | \\ | ||
+ | |||
+ | * Channel | ||
+ | * Channel Width | ||
+ | * Wireless | ||
+ | * Band (2.4 / 5 GHz) | ||
+ | * Country Code/Rev | ||
+ | * Beamforming | ||
+ | |||
+ | \\ | ||
+ | |||
+ | This feature | ||
+ | |||
+ | Client devices also may try to switch bands on their own, without the influence of Wireless Band Steering. | ||
+ | |||
+ | \\ | ||
===== Wireless (2.4 GHz / interface eth1) ===== | ===== Wireless (2.4 GHz / interface eth1) ===== | ||
- | The Wireless (2.4 GHz) section displays information and settings for the wireless | + | The Wireless (2.4 GHz) section displays information and settings for the 2.4 GHz wireless interface. |
+ | |||
+ | Your device may show a different device name than eth1. Hardware device numbers begin at " | ||
+ | |||
+ | The first Ethernet device might be called " | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Enable Wireless:** enables | ||
- | Your device may show a different device name than eth1. Note: FreshTomato hardware device numbers begin at 0. For example, | + | **MAC Address:** displays the MAC address of the 2.4 GHz WiFi interface. |
- | **Enable Wireless:** When checked, this turns on the 2.4 GHz WiFi network interface. When unchecked, the 2.4 GHz WiFi interface | + | Clicking this takes you to the [[:mac_address|MAC Address]] page, to specify a custom address for this interface. |
- | **MAC Address:** This displays | + | **Wireless Mode:** here, choose |
- | **Wireless Mode:** This allows you to select the wireless mode (function) of the 2.4 GHz WiFi network interface. | + | \\ |
- | ^ Wireless | + | ^ ^ |
- | | \\ Access Point | \\ The (default) setting, | + | | **Wireless Mode** |
- | | \\ Access Point WDS | \\ Sets the router in " | + | | \\ Access Point* | \\ The (default) setting, |
- | | \\ Wireless Client | + | | \\ Access Point WDS | \\ Sets the router in " |
- | | \\ Wireless Ethernet Bridge | + | | |
- | | \\ Media Bridge Mode | \\ Configures FreshTomato to connect to another router/ | + | | |
+ | | | ||
| \\ WDS | \\ Serve as a [[https:// | | \\ WDS | \\ Serve as a [[https:// | ||
| //Table derived from (Creative Commons) Wikibooks - “Tomato Firmware/ | | //Table derived from (Creative Commons) Wikibooks - “Tomato Firmware/ | ||
- | \\ | + | \\ |
- | | + | **Wireless Network Mode: **selects which 802.11 WiFi protocols |
- | | + | |
- | * G Only: This allows | + | |
- | * B/G Mixed: This allows clients | + | |
- | * N only: This allows | + | |
- | These apply only to the 2.4 GHz band interface. Separate Wireless Network Mode settings exist for any 5 GHz band interface. | + | The network modes available here will depend on your hardware. |
- | (Default: Auto) | + | \\ |
- | **SSID: | + | |
+ | * Recommended, unless | ||
+ | * Incompatibilities may occur. | ||
+ | * The best settings may not be obvious. \\ \\ | ||
+ | * B Only - allows clients | ||
+ | * G Only - allows clients to connect using only 802.11n. \\ \\ | ||
+ | * B/G Mixed - allows clients to connect using 802.11b/ | ||
+ | * N only - allows clients to connect using only the 802.11n. \\ \\ | ||
- | **Broadcast: | + | \\ |
- | **Channel: **Selects the channel on which the 2.4 GHz radio interface will operate. Generally, it's a good idea to choose a different channel than the one your neighbours are using. (Default: Auto). | + | These apply only to the 2.4 GHz interface. Any 5 GHz interface will have separate Mode settings. |
- | * Auto: This default setting is generally safe unless there is significant interference | + | \\ |
- | FreshTomato chooses and uses the channel it believes has the least interference. | + | **SSID: |
- | * Channel: This menu lets you manually choose available WiFi channels \\ on the band. Unavailable channels will not appear here. | + | For security, don't include personal identity/ |
- | **Channel Width:** This menu allows you to choose | + | (Default: FreshTomatoXX, |
- | | + | **Broadcast: **enables SSID broadcasting. |
- | | + | |
- | 802.11n can use 40 MHz channel width, but to maintain compatibility with legacy systems, it uses one main 20 MHz channel plus a free adjacent channel 20 MHz above or below the main channel. | + | This “announces” the SSID, so it's easy to find and connect to. |
- | **Control Sideband: | + | Common software can easily sniff SSIDs, so in reality, disabling Broadcast provides little security increase.\\ \\ |
- | | + | **Channel: **the channel on which the 2.4 GHz interface operates. |
- | | + | |
- | **Security**: | + | Generally, choose a different channel than your neighbours' |
- | * Disabled: disables security entirely, leaving the network open to anyone. \\ Avoid using this, as it is an almost unlimited security risk. | + | \\ |
- | * WEP: enables Wired Equivalent Privacy protocol. Avoid using this. It's obsolete \\ due to serious vulnerabilities, | + | |
- | * WPA Personal: enables WiFi Protected Access Protocol (1.x). WPA uses the \\ RC4-based TKIP protocol, letting hosts exchange pre-shared keys more secure. \\ While more secure than WEP, WPA still has weaknesses, like lower encryption \\ standards. WPA is strongly discouraged in favour of WPA2 or higher. | + | |
- | * WPA Enterprise: Also known as WPA-802.1X, this is similar to WPA Personal, \\ but each user has their own username/ | + | |
- | * WPA2 Personal: WiFi Protected Access version 2 uses elements of the\\ 802.11i standard, like mandatory support for AES encryption. This makes it\\ much more secure than older protocols. WPA2 Personal is recommended for small-\\ to mid-sized, informal networks. | + | |
- | * WPA2 Enterprise: This enables the Enterprise version of WPA2. This uses WPA2, but\\ each user has their own WiFi username/ | + | |
- | * WPA / WPA2 Personal: | + | |
- | * WPA / WPA2 Enterprise: | + | |
- | * RADIUS: Enables FreshTomato' | + | |
- | **Shared Key: | + | |
+ | * [Channel] - lets you manually choose available channels | ||
- | **Group Key Renewal:** This sets the interval for how often the encryption keys used between client devices and the router/access point are rotated/changed. This is a part of the WPA protocol. (Default: 3600 seconds | + | **Channel Width:** lets you choose the (frequency) width of the channel. |
+ | |||
+ | \\ | ||
+ | |||
+ | * [20 MHz] | ||
+ | * [40 MHz] | ||
+ | |||
+ | \\ | ||
+ | |||
+ | 802.11n uses a 40 MHz channel by combining a main 20 MHz channel with an adjacent 20 MHz channel above/below for compatibility. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Control Sideband:** this lets you choose whether the sideband channel is above (Upper) or below (Lower) the main channel. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * Upper * | ||
+ | * Lower\\ | ||
+ | |||
+ | This is only available If 20 or 40 Channel Width is selected. (Default: Upper). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Security**: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [Disabled] - disables all security, leaving the network open to anyone. \\ Avoid using this. It is a basically an unlimited security risk. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WEP] - enables Wired Equivalent Privacy protocol. Avoid this. \\ It's obsolete \\ due to serious vulnerabilities, | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA Personal] - enables WiFi Protected Access Protocol 1.x. | ||
+ | * Uses the RC4-based TKIP protocol. | ||
+ | * Lets hosts exchange pre-shared | ||
+ | * More secure than WEP, but has weaker encryption standards. | ||
+ | * WPA2 is strongly encouraged instead. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA Enterprise] - (WPA-802.1X) - is similar to WPA Personal, \\ but each user has his/her own username/ | ||
+ | * No common pre-shared key is used. | ||
+ | * Doesn' | ||
+ | * Is more secure against short password dictionary attacks. | ||
+ | * Suitable for larger, more formal networks. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA2 Personal] - WiFi Protected Access v2 uses parts of 802.11i. | ||
+ | * Makes AES encryption mandatory, so more secure. | ||
+ | * Recommended for small- to mid-sized, informal networks. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA2 Enterprise] - enables | ||
+ | * Uses WPA2, but each user has own username/ | ||
+ | * Is based on parts of 802.11i. | ||
+ | * Doesn' | ||
+ | * Suitable for larger, more structured networks. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA / WPA2 Personal] - enables both protocols. \\ The router | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA / WPA2 Enterprise] - enables both protocols. \\ The router communicates via whatever it detects from the client. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [RADIUS] - enables Remote Access Dialup User Service. | ||
+ | * Designed for larger organizations. | ||
+ | * Uses a separate server to authenticate/ | ||
+ | * Supports authentication via certificates. | ||
+ | * Is usually only for advanced users.\\ \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Shared Key: | ||
+ | |||
+ | **Group Key Renewal: | ||
+ | |||
+ | This is a part of the WPA protocol. | ||
+ | |||
+ | (Default: 3600 seconds). | ||
+ | |||
+ | \\ | ||
+ | |||
+ | The following limits apply to adjusting key rotation interval: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * r2023.5 and later: From 1 second to 2592000 seconds \\ [for ARM-based and MIPS RT-N / MIPS-RT-AC hardware] \\ Where: 0 = disabled | ||
+ | |||
+ | * r2023.4 and earlier (for all hardware): 60 - 7200 seconds. | ||
===== Wireless (5 GHz / interface eth2) ===== | ===== Wireless (5 GHz / interface eth2) ===== | ||
- | The Wireless (5 GHz) section displays information | + | The Wireless (5 GHz) section displays |
- | Your device may show a different device name than eth1. Note: FreshTomato hardware device numbers begin at 0. \\ For example, the first Ethernet device might be called eth0. The second wireless device might be called wl1. | + | Your device may show a different device name than eth1. FreshTomato hardware device numbers begin at 0. |
- | Typically, the 5 GHz WiFi band has higher bandwidth, but shorter distance propagation than the 2.4 GHz band. | + | \\ |
- | **Enable Wireless: | + | For example, |
- | **MAC Address: | + | |
+ | | ||
- | **Wireless Mode: | + | \\ |
- | ^ Wireless Mode ^ Description | + | Typically, the 5 GHz WiFi band has higher bandwidth, but shorter range than the 2.4 GHz band. |
- | | \\ Access Point | \\ The (default) setting, which allows clients to connect to FreshTomato' | + | |
- | | \\ Access Point WDS | \\ Sets the router in " | + | \\ |
- | | \\ Wireless Client | + | |
- | | \\ Wireless Ethernet Bridge | + | **Enable Wireless: |
- | | \\ Media Bridge Mode | \\ Configures FreshTomato to connect to another router/access point. \\ All clients connected to both routers remain in the same subnet. \\ \\ - This new operation mode is similar to Wireless Ethernet Bridge mode for SDK6 and up (only for MIPS RT-AC images | + | |
- | | \\ WDS | \\ Serve as a [[https:// | + | **MAC Address: |
+ | |||
+ | **Wireless Mode: | ||
+ | |||
+ | ^ ^ | ||
+ | | **Wireless Mode** | ||
+ | | \\ Access Point | \\ The default setting | ||
+ | | \\ Access Point WDS | \\ Sets the router in " | ||
+ | | \\ \\ \\ \\ \\ \\ Wireless Client | ||
+ | | | ||
+ | | | ||
+ | | \\ WDS | \\ FreshTomato will act only as a [[https:// | ||
| //Table derived from (Creative Commons) Wikibooks - “Tomato Firmware/ | | //Table derived from (Creative Commons) Wikibooks - “Tomato Firmware/ | ||
- | | + | |
- | | + | **Wireless Network Mode: **here, select |
- | * A Only: allows WiFi clients | + | |
- | * N Only: allows WiFi clients | + | |
- | Note that releases before 2021.8 do NOT have a separate setting for 802.11ac. That only arrived with 2021.8 . | + | \\ |
- | Separate Wireless Network Mode settings will exist for any 2.4 GHz band interface. See the 2.4 GHz section. \\ | + | * [Auto] - WiFi clients automatically negotiate the best protocol. |
+ | * Recommended unless you're highly experienced with WiFi. | ||
+ | * Compatibility issues may occur. The “logical” setting isn't always best. \\ \\ | ||
+ | * [A Only] - allows clients to connect using only 802.11a. \\ \\ | ||
+ | * [N Only] - allows clients to connect using only 802.11n. \\ \\ | ||
+ | * [N/AC mixed] - allows clients to connect using only 802.11ac or 802.11n. \\ \\ | ||
+ | * [AC Only] - allows clients to connect using only 802.11ac. | ||
- | **SSID: | + | \\ (Default: |
- | **Broadcast: **Checking this enables SSID broadcasting. This “announces” | + | **SSID:** the network name of the 5 GHz WiFi. |
- | **Channel: **Selects | + | For security, don't include personal words/ |
- | | + | **Broadcast: **enables SSID broadcasting. |
- | | + | |
- | (Default: Auto). | + | This “announces” the SSID, so it's easy to find. SSIDs are easily sniffed, so disabling SSID Broadcast offers little security improvement. \\ \\ |
- | **Channel | + | **Channel: **selects |
- | * 20 MHz | + | Generally, you should choose a different channel than the one your neighbours use. |
- | * 40 MHz | + | |
- | * 80 MHz | + | |
- | * 160 MHz | + | |
- | The 20 MHz channels on the 5 GHz band have no overlap. Therefore, the 5GHz band is less prone to interference and noise. Larger channel widths provide more speed/ | + | \\ |
- | 802.11N can use 40 MHz channel | + | * [Auto]*: This default is usually safe unless there' |
+ | * FreshTomato selects the channel it thinks has the least interference. | ||
+ | * [Channel]: lets you manually choose from available channels \\ on the band. Unavailable channels won't appear. | ||
- | **Control Sideband: | + | \\ |
- | | + | **Channel Width: |
- | | + | |
- | **Security** | + | \\ |
- | * Disabled: disables security entirely, leaving the network open to anyone. \\ Avoid using this, as it is an almost unlimited security risk. | + | * [20 MHz] |
- | * WEP: enables Wired Equivalent Privacy protocol. Avoid using this, as it is obsolete \\ due to serious vulnerabilities, | + | * |
- | * WPA Personal: enables WiFi Protected Access Protocol (1.x). WPA uses the \\ RC4-based TKIP protocol, letting hosts exchange pre-shared keys more secure. \\ While more secure than WEP, WPA still has weaknesses, like lower encryption standards. \\ WPA is strongly discouraged in favour of WPA2 or higher. | + | * |
- | * WPA Enterprise: Also known as WPA-802.1X, this is similar to WPA Personal, \\ but each user has their own username/ | + | * [160 MHz] (not yet supported, but may eventually be on some SDK714 models) |
- | * WPA2 Personal: WiFi Protected Access version 2 uses elements of the\\ 802.11i standard, like mandatory support for AES encryption. This makes it\\ much more secure than older protocols. WPA2 Personal is recommended for small-\\ to mid-sized, informal networks. | + | |
- | * WPA2 Enterprise: This enables the Enterprise version of WPA2. This uses WPA2, but\\ each user has their own WiFi username/ | + | |
- | * WPA / WPA2 Personal: | + | |
- | * WPA / WPA2 Enterprise: | + | |
- | * RADIUS: Enables FreshTomato' | + | |
- | **Shared Key: | + | |
+ | |||
+ | Larger channel widths provide more speed/ | ||
+ | |||
+ | The 5GHz band is less prone to interference and noise, because on that band, 20 MHz channels don't overlap. Interference is more common on the 2.4 GHz band. | ||
+ | |||
+ | Usually, it's fine to choose a larger channel width. However, if you see slow traffic, or clients having trouble authenticating/ | ||
+ | |||
+ | **Control Sideband: | ||
+ | |||
+ | This is available only if 40/80/160 MHz Channel Width is selected. (Default: Upper).\\ \\ | ||
+ | |||
+ | **Security: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [Disabled] - disables all security, leaving | ||
+ | * Avoid using this. It's basically an unlimited security risk. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WEP] - enables Wired Equivalent Privacy protocol. Avoid using this. | ||
+ | * Obsolete due to serious vulnerabilities like weak encryption. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA Personal] - enables WiFi Protected Access 1.x (with RC4-based TKIP protocol). | ||
+ | * Lets hosts exchange pre-shared keys for more security. | ||
+ | * More secure than WEP, but problems include low encryption standards. | ||
+ | * Strongly encouraged instead of WPA. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA Enterprise] (or: " | ||
+ | * No common pre-shared key is used. | ||
+ | * Doesn' | ||
+ | * More secure against short-password dictionary attacks. | ||
+ | * Suitable for larger, more formal networks. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA2 Personal] - uses elements of the 802.11i standard. | ||
+ | * Supports mandatory use of AES. More secure than old protocols. | ||
+ | * Recommended for small/ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA2 Enterprise] - enables the Enterprise version of WPA2. | ||
+ | * Uses WPA2, but each user has their own username/ | ||
+ | * Is based on parts of 802.11i. | ||
+ | * Doesn' | ||
+ | * Is appropriate for larger, more structured networks. \\ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA / WPA2 Personal] - uses WPA2 Personal, and if that fails, WPA. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [WPA / WPA2 Enterprise] - uses WPA2 Enterprise, and if that fails, WPA . | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * [RADIUS] - enables Remote Access Dialup User Service. | ||
+ | * Designed for larger organizations. | ||
+ | * Uses a separate server | ||
+ | * Supports authentication via certificates. | ||
+ | * Suitable for advanced users. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | **Shared Key: | ||
+ | |||
+ | **Group Key Renewal: | ||
+ | |||
+ | This is part of the WPA protocol. See the first wireless radio unit for more details. | ||
+ | |||
+ | (Default: 3600 seconds). | ||
+ | |||
+ | |||
+ | ===== Network Notes and Troubleshooting ===== | ||
+ | |||
+ | ==== Tune Route Cache ==== | ||
+ | |||
+ | Specifically, | ||
+ | |||
+ | \\ | ||
+ | |||
+ | <code bash> | ||
+ | # 2018-01-19 | ||
+ | # Reduce and flush the route cache to ensure a more synchronous load-balancing across multi-wan | ||
+ | # https:// | ||
+ | |||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 0 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 0 > / | ||
+ | /bin/echo 1 > / | ||
+ | /bin/echo 1 > / | ||
+ | |||
+ | #Causes connectivity issues if this value is too small, use defaults or tune accordingly | ||
+ | /bin/echo 512 > / | ||
+ | </ | ||
+ | |||
+ | | ||
+ | |||
+ | ==== Baby Jumbo Frames ==== | ||
+ | |||
+ | Support for Baby Jumbo Frames started with r2021.3. It works only on gigabit routers. | ||
+ | |||
+ | Very few ISPs support Jumbo Frames for PPPoE. To enable Baby Jumbo Frames: | ||
+ | |||
+ | \\ | ||
+ | |||
+ | * Go the [[advanced-misc|Miscellaneous]] menu. Check //Enable jumbo frame support// . \\ The router | ||
+ | * In the [[basic-network|Network]] menu, Set MTU to manual. For PPPoE operation, | ||
+ | * Clamping can be manually disabled, if needed. At a FreshTomato\\ command prompt: type: "nvram set tcp_clamp_disable=1" | ||
+ | * Ping with packet size of 1472 to verify a working PPP MTU of 1500. | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ==== Wireless Band Steering ==== | ||
+ | |||
+ | | ||
+ | |||
+ | <code -> | ||
+ | Steer Policy: | ||
+ | max=0 period=5 cnt=3 rssi=-52 phyrate_high=110 phyrate_low=0 flags=0x22 state=3 | ||
+ | Rule Logic: OR | ||
+ | RSSI: Greater than | ||
+ | VHT: Allowed | ||
+ | NON VHT: Allowed | ||
+ | NEXT RF: NO | ||
+ | PHYRATE (HIGH): Greater than or Equal to | ||
+ | LOAD BALANCE: NO | ||
+ | STA NUM BALANCE: NO | ||
+ | PHYRATE (LOW): Less than | ||
+ | N ONLY: NO | ||
+ | </ | ||
+ | |||
+ | | ||
+ | |||
+ | This example shows default parameters to steer clients from the 5 GHz band to the 2.4 GHz band: \\ \\ | ||
+ | |||
+ | <code -> | ||
+ | Steer Policy: | ||
+ | max=80 period=5 cnt=3 rssi=-82 phyrate_high=0 phyrate_low=0 flags=0x20 state=2 | ||
+ | Rule Logic: OR | ||
+ | RSSI: Less than or Equal to | ||
+ | VHT: Allowed | ||
+ | NON VHT: Allowed | ||
+ | NEXT RF: NO | ||
+ | PHYRATE (HIGH): Greater than or Equal to | ||
+ | LOAD BALANCE: NO | ||
+ | STA NUM BALANCE: NO | ||
+ | PHYRATE (LOW): Less than | ||
+ | N ONLY: NO | ||
+ | </ | ||
- | **Group Key Renewal: | + | \\ |