mirror of
https://github.com/AdguardTeam/AdGuardHome.git
synced 2024-11-28 09:58:52 +03:00
ea8d634f65
Merge in DNS/adguard-home from dhcpd-imp-code to master Squashed commit of the following: commit 413403c169bd3f6b5f2ed63b783d078dbb15e054 Merge: eed1838500fec990bcAuthor: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Fri May 26 12:46:25 2023 +0300 Merge remote-tracking branch 'origin/master' into dhcpd-imp-code commit eed1838502add1e16e5d3ada03778f21913fd5e5 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Fri May 26 12:16:46 2023 +0300 dhcpd: imp docs commit fa4fe036f7b1f2b49201bf0b5b904f99989082f0 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Thu May 25 11:32:34 2023 +0300 all: lint script commit a4022b3d4bbfa709e5096397bbe64ea406c8a366 Merge: e08ff3a26cbc7985e7Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Thu May 25 11:29:57 2023 +0300 Merge remote-tracking branch 'origin/master' into dhcpd-imp-code # Conflicts: # scripts/make/go-lint.sh commit e08ff3a26414e201d6e75608363db941fa2f5b39 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Wed May 24 15:43:11 2023 +0300 dhcpd: imp code commit 970b538f8ea94d3732d77bfb648e402a1d28ab06 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Wed May 24 15:40:36 2023 +0300 dhcpd: imp code commit 0e5916ddd7514af983e8557080d55d6aeb6fbbc0 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Wed May 24 15:37:17 2023 +0300 dhcpd: imp code commit e06a6c6031b232e76ae2be3e3b8fe1a2ffa715e0 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 16:40:09 2023 +0300 dhcpd: imp code commit eed4ff10ff1b29c71d70fb7978706efde89afee1 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 15:45:06 2023 +0300 all: lint script commit 87f84ace5f6f34dbc28befa8257d1d2492c5e0a4 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 15:44:23 2023 +0300 dhcpd: imp code commit a54c9929d51de1f1e6807d650fd08dd80ddbf147 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 14:29:42 2023 +0300 dhcpd: imp code commit 1bbea342f7f55587724aa9a29d9657e5ce75f5d8 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 14:12:09 2023 +0300 dhcpd: imp code commit 48fb4eff73683e799ddb3076afdcf7b067ca24b6 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 13:57:59 2023 +0300 dhcpd: imp code commit f6cd7fcb8d4c1c815a20875d777ea1eca2c8ea89 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 13:17:54 2023 +0300 dhcpd: imp code commit 2b91dc25bbaa16dba6d9389a4e2224cf91eb4554 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Tue May 23 12:57:46 2023 +0300 dhcpd: imp code commit 34f5dd58764080f6202fc9a1abd751a15dbf7090 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Mon May 22 15:31:39 2023 +0300 dhcpd: imp code commit 12ef0d225064a1b78adf7b2cfca21a8dba92ca8e Merge: 6b62a766524b41100cAuthor: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Mon May 22 13:03:41 2023 +0300 Merge remote-tracking branch 'origin/master' into dhcpd-imp-code commit 6b62a7665720b85398d65a1926518a63e6bb6403 Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Mon May 22 12:55:43 2023 +0300 dhcpd: imp code commit 18c5cdf0480fac7711282027a64d58704c75af5f Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Mon May 22 12:48:30 2023 +0300 dhcpd: imp code commit e7c1f4324cba3fe86cf56df6b971791a5a8790de Author: Dimitry Kolyshev <dkolyshev@adguard.com> Date: Mon May 22 12:37:15 2023 +0300 dhcpd: imp code ... and 1 more commit
96 lines
2.4 KiB
Markdown
96 lines
2.4 KiB
Markdown
# Testing DHCP Server
|
|
|
|
Contents:
|
|
* [Test setup with Virtual Box](#vbox)
|
|
* [Quick test with DHCPTest](#dhcptest)
|
|
|
|
## <a href="#vbox" id="vbox" name="vbox">Test setup with Virtual Box</a>
|
|
|
|
### 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
|
|
|
|
1. Install Virtual Box and run the following command to create a Host-Only
|
|
network:
|
|
|
|
```sh
|
|
$ 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 addresses 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:
|
|
|
|
```yaml
|
|
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
|
|
```
|
|
|
|
2. Start the server
|
|
|
|
```sh
|
|
./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
|
|
```
|
|
|
|
## <a href="#dhcptest" id="dhcptest" name="dhcptest">Quick test with DHCPTest utility</a>
|
|
|
|
### Prerequisites
|
|
|
|
* [DHCP test utility][dhcptest-gh].
|
|
|
|
### Quick test
|
|
|
|
The DHCP server could be tested for DISCOVER-OFFER packets with in
|
|
interactive mode.
|
|
|
|
[dhcptest-gh]: https://github.com/CyberShadow/dhcptest
|