Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Native support for nftables #1472

Open
rforberger opened this issue Aug 13, 2023 · 19 comments
Open

Native support for nftables #1472

rforberger opened this issue Aug 13, 2023 · 19 comments

Comments

@rforberger
Copy link

Is there any configuration option to configure dockerd / moby / containerd to use nftables natively for firewalling?

I have a debian machine with docker and nftables, but my docker iptables rules get overwritten by nftables once they get restarted / reloaded.

My alternatives are set to iptables-nft for iptables as per Debian 12.

Does docker support nftables?

Ideally I would want my nftables rules be dynamically merged with any docker firewall rules.

Thanks in advance.

@vasugoriya
Copy link

Migrate Docker to iptables-legacy: If nftables is causing conflicts with Docker's iptables rules, you can consider changing the default iptables backend from iptables-nft to iptables-legacy. This can be done by updating the alternatives configuration. However, keep in mind that this may not be a long-term solution, as support for iptables-legacy might eventually be phased out in favor of nftables.

update-alternatives --set iptables /usr/sbin/iptables-legacy
update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy

Use Docker Compose: If you're using Docker Compose to manage your containers, you can define custom network rules in your Compose file using the network_mode option. This allows you to manage network rules separately from Docker.

Here's an example of how you can define a custom network in your docker-compose.yml
version: '3'
services:
myapp:
image: myapp:latest
network_mode: bridge
# Other service configurations
networks:
bridge:
external: true

@rforberger
Copy link
Author

I don't have problems with nftables, but with docker's iptables implementation.

As from my understanding it is still using iptables right, as it creates iptables rules?

I don't want to migrate to legacy iptables-legacy backend.

If docker is already using nftables, why do my nftables the overwrite docker's iptables rules, when reloading?

@jeromecst
Copy link

If docker is already using nftables, why do my nftables the overwrite docker's iptables rules, when reloading?

If your nftables.conf contains flush ruleset, it will flush all previous rules (including docker's) when reloading

@trallnag
Copy link

trallnag commented Feb 4, 2024

Is this really a problem with Docker? As @jeromecst mentioned, if the primary nftables.conf contains flush ruleset, which is often the case, dynamically added rules will be removed.

One solution would be for Docker to write it's rules to a dedicated file and include this file from the primary nftables.conf.

@rforberger
Copy link
Author

No.

@wcasanova
Copy link

As from my understanding it is still using iptables right, as it creates iptables rules?
If docker is already using nftables, why do my nftables the overwrite docker's iptables rules, when reloading?

Actually docker does not use nftables natively, from debian 10 onwards nftables is the default framework, debian installs the iptables-nft package which translates iptables rules to nft rules.

@bluikko
Copy link

bluikko commented Apr 3, 2024

If docker is already using nftables, why do my nftables the overwrite docker's iptables rules, when reloading?

If your nftables.conf contains flush ruleset, it will flush all previous rules (including docker's) when reloading

Without flush ruleset all the rules will be duplicated since the new ruleset will just be added to the already existing chain.
I guess that could be worked around with just flush table / flush chain instead.

Do you have this working? Wondering because the iptables tools stop working after modifications with nft on EL9 -- is Docker still able to change its rules after direct modifications to nftables?

I believe the point of this issue is that sooner or later iptables wrappers will be deprecated and nftables is the only way forward.

@rforberger
Copy link
Author

rforberger commented Apr 3, 2024 via email

@ghost
Copy link

ghost commented Apr 19, 2024

I agree with the author it's a mess to work like that on distro that use nftables as main way to manage firewall.

@cpuguy83
Copy link
Collaborator

nftables support is being worked on, however it is not a small change and cuts through just about every bit of the network stack.

@jeromecst
Copy link

In the meantime, destroy has recently been added on nftables. Consider using it inside your nftables.conf instead of flush ruleset to avoid flushing every docker rules upon reload.

https://git.netfilter.org/nftables/commit/?id=e1dfd5cc4c46514a84dd8a2063b45517b596e1ca

@jcmcken
Copy link

jcmcken commented Jun 25, 2024

Just want to throw some comments in here. These are based on RHEL9 or compatible systems with a very simple network setup (single main interface eth0).

Installing iptables-nft package and running alternatives --set iptables /usr/sbin/iptables-nft gets you almost all the way there. (This allows dockerd to use the compatibility shims to automatically convert iptables to nftables)

The main problem is that dockerd does a few things which make it incompatible (or to be more accurate, when you translate Docker's generated rules through the NFT translation utilities, it spits out something incompatible):

  • It tries to update the ip table (IPv4 only) instead of the inet table (IPv4 + IPv6). The latter is the default table. Because it's updating the ip and not the inet table, it wants to add an input chain to that table. But an input chain already exists on inet table. So the effect of this is that the entire ip table gets ignored since you can't have an input chain on inet and on ip at the same time
  • It tries to reference chains with capitalized lettering such as FORWARD instead of forward. The default nftables identifiers for chains and other entities don't use upper case.

In my testing, if these two things are fixed, Docker would work with nftables pretty seamlessly using iptables-nft

Since this isn't supported currently, instead what we've had to do is create an /etc/nftables/docker.nft with the following process:

  • Start Docker daemon and then run iptables-save > legacy-rules.txt
  • Convert to NFT: iptables-restore-translate -f legacy-rules.txt > new-rules.nft
  • Edit the rules and fix the issues mentioned above (inet, capitalization, etc.). You can remove some lines too, for example creation of inet tables, if that's already accomplished by the base rules.
  • Move the rules to /etc/nftables/docker.nft.
  • On RHEL, edit /etc/sysconfig/nftables.conf and add include "/etc/nftables/docker.nft"
  • Run systemctl restart nftables to install the new rules.
  • Run nft list rulset and validate everything merged correctly. In particular, the DOCKER* chains should be within the inet table, and the forward chain (not the FORWARD chain) should have updates.

The downside of this approach is dockerd is no longer responsible for making these updates automatically. So if the daemon's firewall design changes in some way, users now need to retrofit it to the above process

@FrankE-Aqura
Copy link

nftables support is being worked on, however it is not a small change and cuts through just about every bit of the network stack.

Is there an ETA for a release that supports nftables?

@initiateit
Copy link

nftables support is being worked on, however it is not a small change and cuts through just about every bit of the network stack.

Its not like we havent known nftables is replacing iptables for a long long time!

Still its nice to know thanks.

@FrankE-Aqura
Copy link

iptables and the iptables-nft package have been deprecated in RHEL 9: https://access.redhat.com/solutions/6739041
nftables is the default and recommended firewall in many distros now as well.

@TurnOffNOD
Copy link

The project netavark has nftables support now, and it claims:

Netavark is a rust based network stack for containers. It is being designed to work with Podman but is also applicable for other OCI container management applications.

@pfeileon
Copy link

pfeileon commented Nov 4, 2024

So what is the recommended way to deal with this issue until nftables is supported?

@hobeone
Copy link

hobeone commented Nov 4, 2024

In the short term if you use systemd you can link docker to the nftables service so it will restart when nftables is restarted. Kind of a hack but it works.

On Debian this is what I added to my /etc/systemd/system/docker.service.d/override.conf file:

[Unit]
PartOf=nftables.service

I did this with my fail2ban service as well.

@pfeileon
Copy link

So I got my setup (WSL2 Fedora 41 with podman and docker-compose) running again by changing the driver to iptables as shown on this wiki-page (NetavarkNftablesDefault#How_To_Test). Simply replace the driver name with iptables.

Source: containers/podman#24486 (comment)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests