AdGuardHome/internal/dhcpd
Eugene Burkov 39aeaf8910 Pull request 2014: 4923 gopacket dhcp vol.3
Merge in DNS/adguard-home from 4923-gopacket-dhcp-vol.3 to master

Updates #4923.

Squashed commit of the following:

commit 1a09c436e5666a515084cd5e76cfccd67991ae5e
Merge: 95bcf0720 c3f141a0a
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Thu Sep 28 19:38:57 2023 +0300

    Merge branch 'master' into 4923-gopacket-dhcp-vol.3

commit 95bcf07206434fd451632e819926871ba8c14f08
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Thu Sep 28 13:19:42 2023 +0300

    dhcpsvc: fix interface to match legacy version

commit 5da513ce177319f19698c5a8e1d10affaaf5e85c
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Thu Sep 28 12:32:21 2023 +0300

    dhcpsvc: make it build on 32bit

commit 37a935514b1cebdc817cdcd5ec3562baeafbc42d
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Wed Sep 27 19:39:35 2023 +0300

    dhcpd: fix v6 as well

commit 03b5454b04c4fdb3fe928d661562883dc3e09d81
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Wed Sep 27 19:34:17 2023 +0300

    dhcpsvc: imp code, docs

commit 91a0e451f78fba64578cc541f7ba66579c31d388
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Sep 22 15:25:58 2023 +0300

    dhcpsvc: imp filing

commit 57c91e1194caa00a69e62b6655b1b4e38b69b89f
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Sep 22 15:23:02 2023 +0300

    dhcpsvc: imp code

commit d86be56efbfc121c9fe2c5ecef992b4523e04d57
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Thu Sep 14 12:24:39 2023 +0300

    dhcpsvc: imp code, docs

commit c9ef29057e9e378779d1a7938ad13b6eebda8f50
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Wed Sep 13 17:53:55 2023 +0300

    dhcpsvc: add constructor, validations, tests

commit f2533ed64e4ef439603b9cdf9596f8b0c4a87cf1
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Sep 12 23:05:42 2023 +0500

    WIP
2023-10-02 13:21:16 +03:00
..
bitset_test.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
bitset.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
broadcast_bsd_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
broadcast_bsd.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
broadcast_others_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
broadcast_others.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
config.go Pull request 1978: 4923 gopacket dhcp vol.2 2023-08-30 14:02:12 +03:00
conn_bsd_internal_test.go Pull request 1856: fix-dhcpd-tags 2023-05-26 12:31:55 +03:00
conn_bsd.go Pull request 1962: upd-code-deps 2023-08-15 15:09:08 +03:00
conn_linux_internal_test.go Pull request 1856: fix-dhcpd-tags 2023-05-26 12:31:55 +03:00
conn_linux.go Pull request 1962: upd-code-deps 2023-08-15 15:09:08 +03:00
conn_unix.go Pull request 1962: upd-code-deps 2023-08-15 15:09:08 +03:00
db.go Pull request 1955: Upd libraries 2023-08-10 20:00:17 +03:00
dhcpd_unix_test.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
dhcpd.go Pull request 1978: 4923 gopacket dhcp vol.2 2023-08-30 14:02:12 +03:00
http_unix_test.go Pull request 2002: fix-typo 2023-09-07 20:37:24 +03:00
http_unix.go Pull request 1978: 4923 gopacket dhcp vol.2 2023-08-30 14:02:12 +03:00
http_windows_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
http_windows.go Pull request 1907: 951-blocked-services-schedule-api 2023-08-29 20:03:40 +03:00
iprange_test.go Pull request: use testutil 2021-10-22 11:58:18 +03:00
iprange.go Pull request 1771: AG-20352-dhcpd-lease-netip-addr 2023-03-23 16:52:01 +03:00
migrate_internal_test.go Pull request 1817: AG-20352-imp-leases-db 2023-04-18 15:12:11 +03:00
migrate.go Pull request 1897: nextapi-write-conf 2023-06-29 14:34:06 +03:00
options_unix_test.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
options_unix.go Pull request: 5281-dhcp-mtu-opt 2023-03-07 15:49:47 +03:00
README.md Pull request 1974: 6133-upd-quic-go 2023-08-23 20:10:54 +03:00
routeradv_test.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
routeradv.go Pull request 1861: 4923-gopacket-dhcp vol.1 2023-06-22 14:18:43 +03:00
v4_unix_test.go Pull request 1996: fix-typo 2023-09-06 19:42:34 +03:00
v4_unix.go Pull request 2014: 4923 gopacket dhcp vol.3 2023-10-02 13:21:16 +03:00
v6_unix_test.go Pull request 1845: AG-21324-update-dhcp 2023-05-17 15:16:02 +03:00
v6_unix.go Pull request 2014: 4923 gopacket dhcp vol.3 2023-10-02 13:21:16 +03:00
v46_windows.go Pull request 1978: 4923 gopacket dhcp vol.2 2023-08-30 14:02:12 +03:00

Testing DHCP Server

Contents:

Test setup with Virtual Box

Prerequisites

To set up a test environment for DHCP server you will need:

  • Linux AG Home host machine (Virtual).
  • Virtual Box.
  • Virtual machine (guest OS doesn't matter).

Configure Virtual Box

  1. Install Virtual Box and run the following command to create a Host-Only network:

    $ VBoxManage hostonlyif create
    

    You can check its status by ip a command.

    You can also set up Host-Only network using Virtual Box menu:

    File -> Host Network Manager...
    
  2. Create your virtual machine and set up its network:

    VM Settings -> Network -> Host-only Adapter
    
  3. Start your VM, install an OS. Configure your network interface to use DHCP and the OS should ask for a IP address from our DHCP server.

  4. To see the current IP addresses on client OS you can use ip a command on Linux or ipconfig on Windows.

  5. To force the client OS to request an IP from DHCP server again, you can use dhclient on Linux or ipconfig /release on Windows.

Configure server

  1. Edit server configuration file AdGuardHome.yaml, for example:

    dhcp:
         enabled: true
         interface_name: vboxnet0
         local_domain_name: lan
         dhcpv4:
           gateway_ip: 192.168.56.1
           subnet_mask: 255.255.255.0
           range_start: 192.168.56.2
           range_end: 192.168.56.2
           lease_duration: 86400
           icmp_timeout_msec: 1000
           options: []
         dhcpv6:
           range_start: 2001::1
           lease_duration: 86400
           ra_slaac_only: false
           ra_allow_slaac: false
    
  2. Start the server

    ./AdGuardHome -v
    

    There should be a message in log which shows that DHCP server is ready:

    [info] DHCP: listening on 0.0.0.0:67
    

Quick test with DHCPTest utility

Prerequisites

Quick test

The DHCP server could be tested for DISCOVER-OFFER packets with in interactive mode.