From Wikipedia, the free encyclopedia
Original author(s)The Netfilter Project
Developer(s)The Netfilter Project
Stable release
1.0.9[1] / October 19, 2023; 37 days ago (2023-10-19)
Preview release
Written inC
Operating systemLinux
Typepacket filtering

nftables is a subsystem of the Linux kernel providing filtering and classification of network packets/datagrams/frames. It has been available since Linux kernel 3.13 released on 19 January 2014.[2]

nftables replaces the legacy iptables portions of Netfilter. Among the advantages of nftables over iptables is less code duplication and easier extension to new protocols. nftables is configured via the user-space utility nft, while legacy tools are configured via the utilities iptables, ip6tables, arptables and ebtables frameworks.

nftables utilizes the building blocks of the Netfilter infrastructure, such as the existing hooks into the networking stack, connection tracking system, userspace queueing component, and logging subsystem.


Command-line syntax[edit]

A command to drop any packets with destination IP address

nft add rule ip filter output ip daddr drop

Note that the new syntax differs significantly from that of iptables, in which the same rule would be written:

iptables -A OUTPUT -d -j DROP

The new syntax can appear more verbose, but it is also far more flexible. nftables incorporates advanced data structures such as dictionaries, maps and concatenations that do not exist with iptables. Making use of these can significantly reduce the number of chains and rules needed to express a given packet filtering design.

The iptables-translate tool can be used to translate many existing iptables rules to equivalent nftables rules.[3][4] Debian 10 (Buster), among other Linux distributions, uses nftables along with iptables-translate as the default packet filtering backend.[5]


The project was first publicly presented at Netfilter Workshop 2008 by Patrick McHardy from the Netfilter Core Team.[6] The first preview release of kernel and userspace implementation was given in March 2009.[7] Although the tool has been called "the biggest change to Linux firewalling since the introduction of iptables in 2001", it has received little press attention.[8] Notable hacker Fyodor Vaskovich (Gordon Lyon) said that he is "looking forward to its general release in the mainstream Linux kernel".[8]

The project stayed in alpha stage, and the official website was removed in 2009. In March 2010, emails from the author on the project mailing lists showed the project was still active and approaching a beta release,[9][10] but the latter was never shipped officially. In October 2012, Pablo Neira Ayuso proposed a compatibility layer for iptables[11] and announced a possible inclusion of the project into mainstream kernel.

On 16 October 2013, Pablo Neira Ayuso submitted a nftables core pull request to the Linux kernel mainline tree.[12] It was merged into the kernel mainline on 19 January 2014, with the release of Linux kernel version 3.13.[2]


The nftables kernel engine adds a simple virtual machine to the Linux kernel which is able to execute bytecode to inspect a network packet and make decisions on how that packet should be handled. The operations implemented by this virtual machine are intentionally made basic. It can get data from the packet itself, have a look at the associated metadata (inbound interface, for example), and manage connection-tracking data. Arithmetic, bitwise and comparison operators can be used for making decisions based on that data. The virtual machine is also capable of manipulating sets of data (typically, IP addresses), allowing multiple comparison operations to be replaced with a single set lookup.[13]

The above-described organization is contrary to the iptables firewalling code, which has protocol awareness built-in so deeply into the logic that the code has had to be replicated four times—for IPv4, IPv6, ARP, and Ethernet bridging—as the firewall engines are too protocol-specific to be used in a generic manner.[13]

The main advantages of nftables over iptables are the simplification of the Linux kernel ABI, reduction of code duplication, improved error reporting, and more efficient execution, storage and incremental changes of filtering rules. Traditionally used iptables(8), ip6tables(8), arptables(8) and ebtables(8) (for IPv4, IPv6, ARP and Ethernet bridging, respectively) are intended to be replaced with nft(8) as a single unified implementation, providing firewall configuration on top of the in-kernel virtual machine.

nftables also offers an improved userspace API that allows atomic replacements of one or more firewall rules within a single Netlink transaction. This speeds up firewall configuration changes for setups having large rulesets; it can also help in avoiding race conditions while the rule changes are being executed. nftables also includes compatibility features to ease transition from previous firewalls, command-line utilities to convert rules in the iptables format,[14] and syntax-compatible versions of iptables commands that use the nftables backend.[15]


  1. ^ "News of the netfilter/iptables project". 2023-10-19. Retrieved 2023-10-21.
  2. ^ a b "nftables, the successor of iptables". Linux 3.13. 2014-01-19. Retrieved 2016-03-04.
  3. ^ "Moving from iptables to nftables - nftables wiki".
  4. ^ "List of available translations via iptables-translate tool - nftables wiki".
  5. ^ "Nftables - Debian Wiki".
  6. ^ "User day program – NFWS2008". 2008-10-03. Retrieved 2014-02-22.
  7. ^ initial release announcement.
  8. ^ a b Gray, Patrick (March 26, 2009). "NEWS: Linux Gets New Firewall".
  9. ^ "Linux Netfilter Devel – Re: Current state of nftables". Retrieved 2014-01-20.
  10. ^ "Linux Netfilter Devel – Re: Current state of nftables". Retrieved 2014-01-20.
  11. ^ "Linux Netfilter Devel – [RFC] back on nf_tables (plus compatibility layer)". Retrieved 2014-01-20.
  12. ^ "[PATCH 00/17] netfilter updates: nf_tables pull request". Retrieved 2014-01-20.
  13. ^ a b Jonathan Corbet (2013-08-20). "The return of nftables". Retrieved 2013-10-22.
  14. ^ Neira Ayuso, Pablo. "nftables – nft command line tool". Retrieved 24 January 2019.
  15. ^ Arturo, Ral. "Netfilter Workshop 2018 Berlin summary". Retrieved 24 January 2019.

External links[edit]