$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $

VBoxManage dhcpserver

VBoxManage-dhcpserver 1
VBoxManage-dhcpserver Управление DHCP сервером &product-name;
`VBoxManage dhcpserver add` --network=имя-сети --interface=имя-интерфейса --server-ip=адрес --netmask=маска --lower-ip=адрес --upper-ip=адрес --enable --disable
--global --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды
--group=имя --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --incl-mac=адрес --excl-mac=адрес --incl-mac-wild=шаблон --excl-mac-wild=шаблон --incl-vendor=строка --excl-vendor=строка --incl-vendor-wild=шаблон --excl-vendor-wild=шаблон --incl-user=строка --excl-user=строка --incl-user-wild=шаблон --excl-user-wild=шаблон --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды
--vm=имя|uuid --nic=1-N --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --fixed-address=адрес
--mac-address=адрес --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --fixed-address=адрес `VBoxManage dhcpserver modify` --network=имя-сети --interface=имя-интерфейса --server-ip=адрес --lower-ip=адрес --upper-ip=адрес --netmask=маска --enable --disable
--global --del-opt=номер-опции-dhcp --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp значение --force-opt=номер-опции-dhcp --unforce-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --unsuppress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --remove-config
--group=имя --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --unforce-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --unsuppress-opt=номер-опции-dhcp --del-mac=адрес --incl-mac=адрес --excl-mac=адрес --del-mac-wild=шаблон --incl-mac-wild=шаблон --excl-mac-wild=шаблон --del-vendor=строка --incl-vendor=строка --excl-vendor=строка --del-vendor-wild=шаблон --incl-vendor-wild=шаблон --excl-vendor-wild=шаблон --del-user=строка --incl-user=строка --excl-user=строка --del-user-wild=шаблон --incl-user-wild=шаблон --excl-user-wild=шаблон --zap-conditions --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --remove-config
--vm=имя|uuid --nic=1-N --del-opt=номер-опции-dhcp --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --unforce-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --unsupress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --fixed-address=адрес --remove-config
--mac-address=адрес --del-opt=номер-опции-dhcp --set-opt=номер-опции-dhcp значение --set-opt-hex=номер-опции-dhcp строка-hex --force-opt=номер-опции-dhcp --unforce-opt=номер-опции-dhcp --suppress-opt=номер-опции-dhcp --unsuppress-opt=номер-опции-dhcp --min-lease-time=секунды --default-lease-time=секунды --max-lease-time=секунды --fixed-address=адрес --remove-config `VBoxManage dhcpserver remove` --network=имя-сети --interface=имя-интерфейса `VBoxManage dhcpserver start` --network=имя-сети --interface=имя-интерфейса `VBoxManage dhcpserver restart` --network=имя-сети --interface=имя-интерфейса `VBoxManage dhcpserver stop` --network=имя-сети --interface=имя-интерфейса `VBoxManage dhcpserver findlease` --network=имя-сети --interface=имя-интерфейса --mac-address=mac

## Описание

Команды `dhcpserver` позволяют управлять встроенным в VirtualBox DHCP сервером. Это может быть полезно при использовании внутренней сети или сети хоста. Теоретически, его можно использовать также и для сетевого моста, но это может вызвать конфликты с другими DHCP серверами, находящимся в вашей физической сети.

### Общие параметры

Все подкоманды `dhcpserver` работают во внутренней сети, идентифицируемой через ее имя или, в случае с сетью хоста, через имя интерфейса:

--network=имя-сети

  Имя внутренней сети. Это то же самое имя, которое было задано в опции `VBoxManage modifyvm --intnet` при настройке ВМ на внутреннюю сеть. Также его можно посмотреть в поле "Имя сети VBox" вывода команд `VBoxManage list intnets`, `VBoxManage list natnets` или `VBoxManage list hostonlyifs`.

--interface=имя-интерфейса

  Имя интерфейса сети хоста. Это то же самое имя, которое было задано в опции `VBoxManage modifyvm --host-only-adapter` при настройке ВМ на сеть хоста. Оно также может быть получено в поле "Имя" вывода команды `VBoxManage list hostonlyifs`.

### dhcpserver add

Добавляет новый DHCP сервер в сеть или интерфейс сети хоста.

Опции для настройки ядра DHCP сервера:

`--server-ip=адрес`

  IP адрес, который должен быть у DHCP сервера.

`--lower-ip=адрес`, `--upper-ip=адрес`

  Диапазон IP адресов в управлении у DHCP сервера. Он не должен включать адрес самого DHCP сервера, но должен быть в той же сети. Границы включены, так что и верхний и нижний адреса также распределяются между клиентами.

`--netmask=маска`

  Сетевая маска. Обычно 255.255.255.0.

`--enable`, --disable

  Включает или выключает DHCP сервер. Если не указан, сервер создается в выключенном состоянии и не распределяет адресов.

Опции, определяющие область настроек:

`--global`

  Задать глобальную область настроек. Любые последующие опции `--set-opt` будут применены ко всем клиентам DHCP.

`--vm=имя-ВМ|uuid`

  Задать область настроек, ограниченную первым NIC указанной ВМ. Любые последующие опции `--set-opt` будут применены только к этому интерфейсу и никуда больше.

`--nic=1-N`

  Задать область настроек, ограниченную указанным номером интерфейса ВМ, заданной через опцию `--vm`.

`--mac-address=адрес`

  Задать область настроек, ограниченную указанным MAC адресом.

`--group=имя`

  Задать область настроек, ограниченную указанной группой.

Опции для настройки текущей выбранной области:

`--set-opt=номер-опции-dhcp значение`

  Добавляет указанный номер опции DHCP (0-255) и значение. Формат значения опции зависит от опции (обычно человеко-читаемый) и проверяется API и сервером DHCP.

`--set-opt-hex=номер-опции-dhcp строка-hex`

  Добавляет указанный номер опции DHCP (0-255) и значение. Значение параметра задается в виде необработанной последовательности шестнадцатеричных байтов, которые могут быть разделены двоеточием. Проверка этих значений не производится ни API, ни DHCP сервером, они как есть передаются клиенту.

`--force-opt=номер-опции-dhcp`

  Принудительно отправляет указанный номер опции DHCP (0-255) клиенту независимо от того, запрашивал он это или нет (при условии, что опция настроена со значением на некотором уровне).

`--suppress-opt=номер-опции-dhcp`

  Предотвращает отправку клиенту указанного номера опции DHCP (0–255), если он присутствует в этой или более высокой области настроек.

`--min-lease-time=секунды`

  Устанавливает минимальное время аренды для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--default-lease-time=секунды`

  Задает время аренды по умолчанию для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--max-lease-time=секунды`

  Устанавливает максимальное время аренды для текущей области в секундах. Ноль означает получение значения из более высокого уровня настроек или использование значения по умолчанию.

`--fixed-address=адрес`

  Назначение фиксированного адреса для области настроек `--vm` или `--mac-address`. Пустой адрес возвращает обратно назначение динамического адреса.

Опции для настройки условий членства в группе (исключение, переопределение, включение):

`--incl-mac=адрес`

  Включает указанный MAC адрес в группу.

`--excl-mac=адрес`

  Исключает указанный MAC адрес из группы.

`--incl-mac-wild=шаблон`

  Включает указанный шаблон MAC адреса в группу.

`--excl-mac-wild=шаблон`

  Исключает указанный шаблон MAC адреса из группы.

`--incl-vendor=строка`

  Включает указанный ID класса поставщика в группу.

`--excl-vendor=строка`

  Исключает указанный ID класса поставщика из группы.

`--incl-vendor-wild=шаблон`

  Включает указанный шаблон ID класса поставщика в группу.

`--excl-vendor-wild=шаблон`

  Исключает указанный шаблон ID класса поставщика из группы.

`--incl-user=строка`

  Включает указанный ID класса пользователя в группу.

`--excl-user=строка`

  Исключает указанный ID класса пользователя из группы.

`--incl-user-wild=шаблон`

  Включает указанный шаблон ID класса пользователя в группу.

`--excl-user-wild=шаблон`

  Исключает указанный шаблон ID класса пользователя из группы.

### dhcpserver modify

Команда модифицирует существующую конфигурацию сервера DHCP. Она принимает те же опции как и команда `add` и в дополнении нижеследующие, относящиеся к области настроек:

`--del-opt=номер-опции-dhcp`

  Противоположность к `--set-opt`, которая удаляет указанный номер опции DHCP (0-255) из настроек сервера. Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--unforce-opt=номер-опции-dhcp`

  Удаляет указанный номер опции DHCP (0-255) из списка принудительно передаваемых клиенту опций (то есть обратная к `--force-opt`). Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--unsuppress-opt=номер-опции-dhcp`

  Удаляет указанный номер DHCP (0-255) из списка опций для подавления передачи клиенту (то есть обратная к `--suppress-opt`). Как и у `--set-opt`, область удаления регулируется опциями `--global`, `--vm`, `--mac-address` и `--group`.

`--remove-config`

  Удаляет настройки из текущей области. Область `--global` нельзя удалить. После этой опции область настроек будет изменена на `--global`.

И дополнение к опциям условий членства в группах:

`--del-mac=адрес`

  Удаляет указанный MAC адрес из условий группы.

`--del-mac-wild=шаблон`

  Удаляет указанный шаблон MAC адреса из условий группы.

`--del-vendor=строка`

  Удаляет указанный ID класса поставщика из условий группы.

`--del-vendor-wild=шаблон`

  Удаляет указанный шаблон ID класса поставщика из условий группы.

`--del-user=строка`

  Удаляет указанный ID класса пользователя из условий группы.

`--del-user-wild=pattern`

  Удаляет указанный шаблон ID класса пользователя из условий группы.

`--zap-conditions`

  Удаляет все условия группы.

### dhcpserver remove

Удаляет указанный сервер DHCP.

### dhcpserver start

Запускает указанный сервер DHCP.

### dhcpserver restart

Перезапускает указанный сервер DHCP. Сервер DHCP должен работать на момент запуска команды.

### dhcpserver stop

Останавливает указанный сервер DHCP.

### dhcpserver findlease

Производит просмотр базы данных аренды. Эта команда в основном для получения IP адреса работающей ВМ.

`--mac-address=mac`

  MAC адрес для просмотра в базе данных аренды.

### Общие параметры DHCP: