AdGuardHome/internal/dhcpd
Ainar Garipov 2e0f6e5468 Pull request: refactor-opts
Updates #2893.

Squashed commit of the following:

commit c7027abd1088e27569367f3450e9225ff605b43d
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Wed Oct 5 16:54:23 2022 +0300

    home: imp docs

commit 86a5b0aca916a7db608eba8263ecdc6ca79c8043
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Wed Oct 5 16:50:44 2022 +0300

    home: refactor opts more

commit 74c5989d1edf8d007dec847f4aaa0d7a0d24dc38
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Wed Oct 5 15:17:26 2022 +0300

    home: refactor option parsing
2022-10-05 17:07:08 +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: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
conn_unix.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
conn_unix_test.go Pull request: Improve build tags 2022-09-13 20:06:23 +03:00
db.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
dhcpd.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
dhcpd_unix_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
http_unix.go Pull request: refactor-opts 2022-10-05 17:07:08 +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: filtering: fix rw to subdomain 2021-12-27 19:40:39 +03:00
iprange_test.go Pull request: use testutil 2021-10-22 11:58:18 +03:00
options_unix.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
options_unix_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +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: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v4_unix_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v6_unix.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v6_unix_test.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +03:00
v46_windows.go Pull request: 4722 dhcp http panic 2022-09-13 23:45:35 +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