From: Stefan Hanreich <s.hanreich@proxmox.com>
To: Arthur Bied-Charreton <a.bied-charreton@proxmox.com>
Cc: pve-devel@lists.proxmox.com
Subject: Re: [PATCH pve-firewall v2 03/12] firewall: dump configs locally after applying
Date: Thu, 15 Oct 2026 14:45:23 +0200 [thread overview]
Message-ID: <179206832307.200960.4312066992851317571.b4-review@b4> (raw)
In-Reply-To: <20261001122625.348730-4-a.bied-charreton@proxmox.com>
> ... and remove them when the firewall is disabled in the config or the
> daemon is stopped.
>
> The firewall config lives on pmxcfs, which is only available once
> pve-cluster is up, i.e. well after the network. To be able to restore
> rules before that, dump the config files needed to recompile the ruleset
> (cluster.fw, host.fw and the SDN config as sdn.json) to a local
> directory after every successful apply. The guest configs are not
> dumped, since pve-guests does not start until the actual firewall daemon
> is running.
>
> The last dumped content is cached per file, so the daemon only writes
> when something changed since the last dump, or if the dump file does not
> exist at all.
>
> Ownership of the dumps is keyed on the nftables option in the host
> config. If the firewall is disabled cluster-wide, the dumps are removed.
> If nftables is enabled, they are left in place, since proxmox-firewall
> owns them in that case.
>
> The dumps are also removed when the daemon is stopped, to prevent a
> ruleset restored at boot from living forever if no daemon starts
> afterwards.
>
> Signed-off-by: Arthur Bied-Charreton <a.bied-charreton@proxmox.com>
> Reviewed-by: Thomas Ellmenreich <t.ellmenreich@proxmox.com>
> Tested-by: Thomas Ellmenreich <t.ellmenreich@proxmox.com>
>
> diff --git a/debian/dirs b/debian/dirs
> index c9e3b54..e472f56 100644
> --- a/debian/dirs
> +++ b/debian/dirs
> @@ -1 +1,2 @@
> /var/lib/pve-firewall
> +/var/lib/pve/firewall
> diff --git a/src/PVE/Firewall.pm b/src/PVE/Firewall.pm
> index 592e5fe..81901e3 100644
> --- a/src/PVE/Firewall.pm
> +++ b/src/PVE/Firewall.pm
> @@ -17,6 +17,7 @@ use Storable qw(dclone);
> use PVE::Cluster;
> use PVE::Corosync;
> use PVE::Exception qw(raise raise_param_exc);
> +use PVE::File;
> use PVE::INotify;
> use PVE::JSONSchema qw(register_standard_option get_standard_option);
> use PVE::Network;
> @@ -32,6 +33,8 @@ my $pvefw_conf_dir = "/etc/pve/firewall";
> my $clusterfw_conf_filename = "$pvefw_conf_dir/cluster.fw";
> my $vnetfw_conf_dir = "/etc/pve/sdn/firewall";
>
> +my $dump_dir = '/var/lib/pve/firewall';
We moved from using those abbreviations in names / paths to just
proxmox in general. E.g. the firewall binary is located in
/usr/libexec/proxmox.
> +
> # dynamically include PVE::QemuServer and PVE::LXC
> # to avoid dependency problems
> my $have_qemu_server;
> @@ -4231,7 +4234,7 @@ sub load_sdn_conf {
> return $sdn_config // $empty_sdn_config;
> }
>
> -sub save_clusterfw_conf {
> +sub serialize_clusterfw_conf {
> my ($cluster_conf) = @_;
>
> my $raw = '';
> @@ -4266,11 +4269,21 @@ sub save_clusterfw_conf {
> }
> }
>
> + return $raw;
> +}
> +
> +sub save_clusterfw_conf {
> + my ($cluster_conf, $filename) = @_;
> +
> + $filename = $clusterfw_conf_filename if !defined($filename);
> +
> + my $raw = serialize_clusterfw_conf($cluster_conf);
> +
> if ($raw) {
> mkdir $pvefw_conf_dir;
> - PVE::Tools::file_set_contents($clusterfw_conf_filename, $raw);
> + PVE::Tools::file_set_contents($filename, $raw);
> } else {
> - unlink $clusterfw_conf_filename;
> + unlink($filename);
> }
> }
>
> @@ -4294,11 +4307,8 @@ sub load_hostfw_conf {
> return generic_fw_config_parser($filename, $cluster_conf, $empty_conf, 'host');
> }
>
> -sub save_hostfw_conf {
> - my ($hostfw_conf, $filename) = @_;
> -
> - $filename = $hostfw_conf_filename if !defined($filename);
> -
> +sub serialize_hostfw_conf {
> + my ($hostfw_conf) = @_;
> my $raw = '';
>
> my $options = $hostfw_conf->{options};
> @@ -4311,6 +4321,16 @@ sub save_hostfw_conf {
> $raw .= "\n";
> }
>
> + return $raw;
> +}
> +
> +sub save_hostfw_conf {
> + my ($hostfw_conf, $filename) = @_;
> +
> + $filename = $hostfw_conf_filename if !defined($filename);
> +
> + my $raw = serialize_hostfw_conf($hostfw_conf);
> +
> if ($raw) {
> PVE::Tools::file_set_contents($filename, $raw);
> } else {
> @@ -5432,6 +5452,14 @@ sub remove_pvefw_chains {
>
> }
>
> +sub delete_dumps {
> +
> + unlink "$dump_dir/cluster.fw";
> + unlink "$dump_dir/host.fw";
> + unlink "$dump_dir/sdn.json";
> +
> +}
> +
> sub remove_pvefw_chains_iptables {
> my ($iptablescmd, $table) = @_;
>
> @@ -5530,21 +5558,57 @@ sub init {
> # load required modules here
> }
>
> +my $dump_cache = {};
> +
> +sub dump_if_changed {
> + my ($f, $data) = @_;
> + return if -f $f && defined($dump_cache->{$f}) && $dump_cache->{$f} eq $data;
> + PVE::File::file_set_contents($f, $data);
> + $dump_cache->{$f} = $data;
> + syslog('info', "dumped $f\n");
> +}
> +
> +# The cache is only filled once this daemon wrote the dumps, i.e. while it owns them.
> +sub delete_dumps_if_owned {
> + delete_dumps() if $dump_cache->%*;
> +}
> +
> sub update {
> my $code = sub {
> + my $cfw_dump_path = "$dump_dir/cluster.fw";
> + my $hfw_dump_path = "$dump_dir/host.fw";
> + my $sdn_dump_path = "$dump_dir/sdn.json";
>
> my $cluster_conf = load_clusterfw_conf();
> my $hostfw_conf = load_hostfw_conf($cluster_conf);
>
> if (!is_enabled_and_not_nftables($cluster_conf, $hostfw_conf)) {
> PVE::Firewall::remove_pvefw_chains();
> + $dump_cache = {};
> + # disabled in config: drop stale dumps so the pre-network restore does not resurrect a
> + # disabled ruleset. leave them in nftables mode, since in that case proxmox-firewall
> + # owns the dump directory.
> + delete_dumps() if !$cluster_conf->{options}->{enable};
> return;
> }
>
> + # compile() rewrites rule actions in-place. snapshot the untouched configs now for the
> + # post-apply boot-time dump.
> + my ($cfw_dump, $hfw_dump) = (dclone($cluster_conf), dclone($hostfw_conf));
> +
> my ($ruleset, $ipset_ruleset, $rulesetv6, $ebtables_ruleset) =
> compile($cluster_conf, $hostfw_conf);
>
> apply_ruleset($ruleset, $hostfw_conf, $ipset_ruleset, $rulesetv6, $ebtables_ruleset);
> +
> + eval {
> + mkdir($dump_dir);
mkdir takes a mode parameter directly, use make_path here as well as
we do in the network interface pinning? This also prevents us from
changing the permissions every update cycle...
> + chmod(0700, $dump_dir);
> + dump_if_changed($cfw_dump_path, serialize_clusterfw_conf($cfw_dump));
> + dump_if_changed($hfw_dump_path, serialize_hostfw_conf($hfw_dump));
> + dump_if_changed($sdn_dump_path, JSON->new->utf8->canonical->encode($cfw_dump->{sdn}));
Did you check the performance impact of serializing and comparing the
whole configuration file? It shouldn't matter too much afaict, but a
quick check wouldn't hurt...
--
Stefan Hanreich <s.hanreich@proxmox.com>
next prev parent reply other threads:[~2026-10-15 12:45 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-01 12:26 [RFC firewall/manager/proxmox{,-firewall} v2 00/12] fix #5759: keep firewall rules up across boot and shutdown Arthur Bied-Charreton
2026-10-01 12:26 ` [PATCH pve-manager v2 01/12] network interface pinning: write new firewall config to local dir Arthur Bied-Charreton
2026-10-01 12:26 ` [PATCH pve-firewall v2 02/12] firewall: config: sort OPTIONS when serializing Arthur Bied-Charreton
2026-10-15 12:45 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH pve-firewall v2 03/12] firewall: dump configs locally after applying Arthur Bied-Charreton
2026-10-15 12:45 ` Stefan Hanreich [this message]
2026-10-01 12:26 ` [PATCH pve-firewall v2 04/12] fix #5759: firewall: do not remove chains when host is shutting down Arthur Bied-Charreton
2026-10-15 12:45 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH pve-firewall v2 05/12] firewall: add restore command Arthur Bied-Charreton
2026-10-15 12:45 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH pve-firewall v2 06/12] fix #5759: firewall: restore from dumped config before network-pre Arthur Bied-Charreton
2026-10-15 12:45 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH proxmox v2 07/12] systemd: systemctl: add is-system-running helper Arthur Bied-Charreton
2026-10-01 12:26 ` [PATCH proxmox-firewall v2 08/12] firewall: fix clippy warnings Arthur Bied-Charreton
2026-10-15 12:44 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH proxmox-firewall v2 09/12] fix #5759: firewall: do not clear rules on system shutdown Arthur Bied-Charreton
2026-10-01 12:26 ` [PATCH proxmox-firewall v2 10/12] firewall: dump config to local directory after apply Arthur Bied-Charreton
2026-10-15 12:44 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH proxmox-firewall v2 11/12] firewall: add restore command Arthur Bied-Charreton
2026-10-15 12:44 ` Stefan Hanreich
2026-10-01 12:26 ` [PATCH proxmox-firewall v2 12/12] fix #5759: firewall: restore from dumped config before network-pre Arthur Bied-Charreton
2026-10-15 12:45 ` [RFC firewall/manager/proxmox{,-firewall} v2 00/12] fix #5759: keep firewall rules up across boot and shutdown Stefan Hanreich
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=179206832307.200960.4312066992851317571.b4-review@b4 \
--to=s.hanreich@proxmox.com \
--cc=a.bied-charreton@proxmox.com \
--cc=pve-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.