docs: document the BusyBox ifup CIDR trap in the docker init path

BusyBox ifup — what runs in /gns3/init.sh unless the image ships its
own ifupdown — only brings up 'auto' stanzas and rejects CIDR notation
in the address line ("don't have all variables for <iface>/inet"),
leaving the interface unconfigured after a container restart.

Document the constraint next to the ifup call and in the generated
/etc/network/interfaces sample, where addressing gets written.
This commit is contained in:
YueGuobin committed 2026-08-28 23:26:24 +08:00
1 parent ae317608e8
commit c3cc067eea
2 files changed
+10

No files matched your search

+5
View File
@@ -511,6 +511,11 @@ class DockerVM(BaseNode):
f.write("""#
# This is a sample network config, please uncomment lines to configure the network
#
# NOTE: at boot /gns3/init.sh applies this file with BusyBox ifup ("ifup -a -f").
# BusyBox ifupdown only brings up "auto" stanzas and requires separate
# "address <ip>" and "netmask <mask>" lines: CIDR notation such as
# "address 10.0.0.1/24" is rejected and the interface stays unconfigured.
#
# Uncomment this line to load custom interface files
# source /etc/network/interfaces.d/*