mirror of https://github.com/AdguardTeam/AdGuardHome.git synced 2024-12-21 06:22:39 +03:00

History

Eugene Burkov c234e5dc31 Pull request 2317: Update all Squashed commit of the following: commit 832a5ac0c9d588428c7d030978769e510e011645 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Dec 4 17:38:20 2024 +0300 client: upd i18n commit 6fa7591109085b169b79bd771808922a1a53f875 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Dec 4 17:20:30 2024 +0300 client: upd trackers commit f4b692d37c1cc4d784b4a76f85198f4a1cfa7f83 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Dec 4 16:55:40 2024 +0300 all: upd tools, go		2024-12-04 17:57:37 +03:00
..
bitset.go
bitset_test.go
broadcast_bsd.go
broadcast_bsd_test.go
broadcast_others.go
broadcast_others_test.go
config.go
conn_bsd.go
conn_bsd_internal_test.go
conn_linux.go
conn_linux_internal_test.go
conn_unix.go
db.go
dhcpd.go
dhcpd_unix_test.go
http_unix.go
http_unix_internal_test.go
http_windows.go
http_windows_test.go
iprange.go
iprange_test.go
migrate.go
migrate_internal_test.go
options_unix.go
options_unix_test.go
README.md
routeradv.go
routeradv_test.go
v4_unix.go
v4_unix_test.go
v6_unix.go
v6_unix_test.go
v46_windows.go

README.md

Testing DHCP Server

Contents:

Test setup with Virtual Box
Quick test with DHCPTest

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

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...
```
Create your virtual machine and set up its network:
```
VM Settings -> Network -> Host-only Adapter
```
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.
To see the current IP addresses on client OS you can use ip a command on Linux or ipconfig on Windows.
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

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

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

DHCP test utility.

Quick test

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