mirror of https://github.com/AdguardTeam/AdGuardHome.git synced 2024-11-28 01:42:26 +03:00

History

Eugene Burkov 94cf50a53d Pull request 1955: Upd libraries Merge in DNS/adguard-home from upd-libs to master Squashed commit of the following: commit 72f4fb7d5ab8eaecb917a843dec56e3fa38b725c Merge: 8defe106f `111005b8d` Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Thu Aug 10 19:50:33 2023 +0300 Merge branch 'master' into upd-libs commit 8defe106fc982ba916f42d5722f1cc0152042d04 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Thu Aug 10 19:38:01 2023 +0300 dnsforward: revert behavior commit 8ccb2f675373772f8a6f829b80b317fda0c5f730 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Aug 9 18:35:12 2023 +0300 all: imp code commit a3112d3438a466bae515e56a6ee97394066ba481 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Aug 9 17:26:52 2023 +0300 filtering: revert type commit 56d2528fb4c8ee5504de0c6ec24050d63c8e6330 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Aug 9 14:57:04 2023 +0300 stats: fix sort commit 0dbb446602b7536df508a8e53c4a532455c9d064 Author: Eugene Burkov <E.Burkov@AdGuard.COM> Date: Wed Aug 9 14:52:28 2023 +0300 all: upd golibs & dnsproxy		2023-08-10 20:00:17 +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
db.go
dhcpd.go
dhcpd_unix_test.go
http_unix.go
http_unix_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.