AdGuardHome/internal/dhcpd
Eugene Burkov 6d402dc86c Pull request 1830: 5712-rollback-dhcp
Merge in DNS/adguard-home from 5712-rollback-dhcp to master

Updates #5712.

Squashed commit of the following:

commit 3d53a6385ad08dfad0b7ac28bb057cf25608554d
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Apr 14 16:30:18 2023 +0300

    dhcpd: imp import

commit 86bd55b0225b5d9067bd0bf9e6def1e52dd27124
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Apr 14 16:26:41 2023 +0300

    all: return todo

commit 629c548989a464a9cf461fffc0815b99a00c4851
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Apr 14 16:24:10 2023 +0300

    all: log changes

commit e4c369e55cbcc7c73d73d8df333996862e1e146a
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Fri Apr 14 16:03:03 2023 +0300

    dhcpd: revert raw for darwin
2023-04-14 16:58:07 +03:00
..
README.md Pull request: * all: move internal Go packages to internal/ 2020-10-30 13:32:02 +03:00
bitset.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
bitset_test.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
broadcast_bsd.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
broadcast_bsd_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
broadcast_others_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
config.go Pull request 1755: imp-home-gocyclo 2023-03-01 13:27:24 +03:00
conn_darwin.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
conn_darwin_internal_test.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
conn_unix.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
conn_unix_internal_test.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
db.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
dhcpd.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
dhcpd_unix_test.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
http_unix.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
http_unix_test.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
http_windows.go Pull request: imp-json-resp 2022-10-04 14:35:10 +03:00
http_windows_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
iprange.go Pull request 1771: AG-20352-dhcpd-lease-netip-addr 2023-03-23 16:52:01 +03:00
iprange_test.go Pull request: use testutil 2021-10-22 11:58:18 +03:00
options_unix.go Pull request: 5281-dhcp-mtu-opt 2023-03-07 15:49:47 +03:00
options_unix_test.go Pull request: Migrate to netip.Addr vol.1 2022-10-14 15:29:44 +03:00
os_windows.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
routeradv.go Pull request: upd-fmt 2022-08-31 18:57:02 +03:00
routeradv_test.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
v4_unix.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
v4_unix_test.go Pull request 1830: 5712-rollback-dhcp 2023-04-14 16:58:07 +03:00
v6_unix.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
v6_unix_test.go Pull request 1800: AG-20352-dhcpd-lease-is-static 2023-04-10 11:17:05 +03:00
v46_windows.go Pull request 1755: imp-home-gocyclo 2023-03-01 13:27:24 +03:00

README.md

DHCP server

Contents:

Test setup with Virtual Box

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

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

Configure client

  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 address 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
       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
    

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

     [info] DHCP: listening on 0.0.0.0:67