AdGuardHome/internal/dhcpd
Ainar Garipov 773f02cf7d Pull request: dhcpd: normalize client host
Updates #2946.

Squashed commit of the following:

commit f830c03ddee65f7e86c43baa00a7dcc022091d93
Merge: df6c83d7 327e76cd
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Tue Apr 13 15:55:58 2021 +0300

    Merge branch 'master' into 2946-norm-dhcp-host

commit df6c83d7d117b718110a035216e708d5131bf71c
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Tue Apr 13 15:49:03 2021 +0300

    dhcpd: imp docs

commit 1407e9bd7b7694bd3069349faba3ec9ff5eb468b
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Tue Apr 13 15:27:38 2021 +0300

    dhcpd: normalize client host
2021-04-13 16:00:09 +03:00
..
nclient4 Pull request: all: rm var shadowing vol. 3 2021-03-11 21:30:52 +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
checkother.go Pull request: all: rm var shadowing vol. 3 2021-03-11 21:30:52 +03:00
checkother_windows.go Pull request: all: fix lint and naming issues vol. 2 2020-12-07 15:38:05 +03:00
db.go Pull request: all: use renameio instead of golibs/file 2021-04-06 20:48:36 +03:00
dhcpd.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
dhcpd_test.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
helpers.go Pull request: 2508 ip conversion vol.1 2021-01-13 16:56:05 +03:00
http.go Pull request: dhcpd: do not overwrite dhcpv4 options 2021-04-06 16:40:05 +03:00
http_test.go Pull request: dhcpd: assume static ip on eperm 2021-02-12 16:40:34 +03:00
iprange.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
iprange_test.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
nullbool.go Pull request: dhcpd: do not override ra-slaac settings 2021-02-11 20:49:03 +03:00
nullbool_test.go Pull request: dhcpd: normalize client host 2021-04-13 16:00:09 +03:00
options.go Pull request: dhcpd: fix ip ranges 2021-03-16 19:11:32 +03:00
options_test.go Pull request: dhcpd: fix ip ranges 2021-03-16 19:11:32 +03:00
os_windows.go Pull request: * all: move internal Go packages to internal/ 2020-10-30 13:32:02 +03:00
routeradv.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
routeradv_test.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
server.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +03:00
v4.go Pull request: dhcpd: normalize client host 2021-04-13 16:00:09 +03:00
v4_test.go Pull request: dhcpd: normalize client host 2021-04-13 16:00:09 +03:00
v6.go Pull request: dhcpd: do not assume mac addrs of 6 bytes 2021-03-31 12:36:57 +03:00
v6_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v46.go Pull request: dhcpd: wait for interfaces' ip addresses to appear 2020-11-27 14:39:43 +03:00
v46_test.go Pull request: 2639 use testify require vol.3 2021-02-12 13:27:44 +03:00
v46_windows.go Pull request: dhcpd: imp static lease validation 2021-03-18 17:07:13 +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