mirror of https://github.com/AdguardTeam/AdGuardHome.git synced 2024-12-20 05:52:25 +03:00

History

Ainar Garipov 355cec1d7b Pull request 2284: AG-32257-file-permission-mitigation Squashed commit of the following: commit 6e0e61ec2e95a563b04a622f46c6bbe2b2e12711 Merge: e3cccc01a `5b5b39713` Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 20:51:29 2024 +0300 Merge branch 'master' into AG-32257-file-permission-mitigation commit e3cccc01a9cbd382cec0fcd7f3685e43acb48424 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 19:57:32 2024 +0300 dnsforward: imp test commit 16ecebbc2fd2f4afe2bf475774af1786fa7a02c0 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 19:22:10 2024 +0300 configmigrate: imp tests commit da8777c3a7c81e17c0d08cfff4e3a9c8d2bbd649 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 18:58:46 2024 +0300 all: imp types, tests commit 58822a0ef8aa2d944a667d1ba77fe23ff52af424 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 18:28:37 2024 +0300 all: imp chlog commit 8ce81f918cc5cf43972e2045532a48c829257a2f Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Wed Oct 2 18:09:57 2024 +0300 all: improve permissions, add safe_fs_patterns		2024-10-02 21:00:15 +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.