Skip to content

Support 'gateway' option when creating network#32

Open
Vigilans wants to merge 1 commit into
devplayer0:masterfrom
Vigilans:vigilans/option-gateway
Open

Support 'gateway' option when creating network#32
Vigilans wants to merge 1 commit into
devplayer0:masterfrom
Vigilans:vigilans/option-gateway

Conversation

@Vigilans
Copy link
Copy Markdown

When using docker to build an intermediate gateway (like raspberry pi), we may expect a following workflow:

  • Set DHCP server's published default gateway to be intermediate gateway's LAN IP;
  • Set intermediate gateway (the docker container)'s default gateway to be router's LAN IP.

However, currently docker-net-dhcp will always use DHCP published gateway when creating the container, and when that published IP is the same as container's lease IP, an error Destination unreachable will raise, preventing us to modify the gateway later after the container created.

Thus, this PR add a new option gateway when creating the docker network, to forcibly uses a user-provided gateway instead of one provided by DHCP when creating the container.

Usage example:
docker create .... -o bridge=br-eth -o gateway=192.168.0.2

@claymore666
Copy link
Copy Markdown

Heads-up — the gateway override option from this PR is incorporated in a maintained fork at https://github.com/claymore666/docker-net-dhcp (commit 7f72060, crediting you). The fork also modernizes the deps and adds a macvlan attachment mode. Tracking issue: #47. Thanks for the original work.

claymore666 pushed a commit to claymore666/docker-net-dhcp that referenced this pull request May 2, 2026
When set, the plugin uses the operator-provided IPv4 gateway instead of
whatever the upstream DHCP server returns. The persistent client also
stops replacing the gateway on lease renewals while the override is in
effect, so the override sticks across the lifetime of the container.

Useful when egress should leave via a different router than the one the
LAN's DHCP server advertises — for example a VPN gateway or a
split-horizon setup. Without the option, behaviour is unchanged: DHCP's
router option becomes the container's default gateway.

The override applies to both bridge and macvlan modes.

Originally proposed by @Vigilans in devplayer0/docker-net-dhcp#32.
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

Successfully merging this pull request may close these issues.

2 participants