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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox