Добавьте правило в таблицу mangle iptables:sudo iptables -t mangle -A PREROUTING -m physdev --physdev-in eth0 -p udp --dport 67 -j NFQUEUE --queue-num 42.

Затем запустите dhcpoptinj (запустим его на переднем плане с дополнительным отладочным выводом): sudo dhcpoptinj -d -f -q 42 -o'52 01 04 46 6A 61 73'. Обратите внимание, что dhcpoptinj должен запускаться пользователем, имеющим возможность CAP_NET_ADMIN. Вам не нужно, и вам действительно не следует запускать dhcpoptinj от root. Вместо этого вы можете, например, предоставить возможность CAP_NET_ADMIN двоичному файлу (с помощью setcap) и ограничить права выполнения только определённым пользователем или группой. Это метод, используемый для запуска Wireshark не от root, так что вы найдёте несколько руководств, помогающих это сделать.

Теперь отправьте DHCP-пакет на интерфейс eth0 и наблюдайте (с помощью такого инструмента, как wireshark), как он изменился, когда достигает мостового интерфейса. Он должен иметь инжектированную опцию в конце списка опций. Если вы захватите входящий DHCP-пакет с помощью Wireshark, он будет отображаться неизменённым, хотя на самом деле он будет модифицирован.

Обратите внимание на формат аргумента для опции -o: это должна быть шестнадцатеричная строка, начинающаяся с кода DHCP-опции, за которым следует полезная нагрузка опции. Длина опции (байт, который обычно следует за кодом опции) вычисляется автоматически и не должна указываться. Шестнадцатеричная строка может быть разделена нешестнадцатеричными символами для удобочитаемости. Все опции должны иметь полезную нагрузку, за исключением специальной опции заполнения (код 0).

Макет бессмысленной опции, использованной в этом примере (сначала макет DHCP-опции, затем конкретный макет подопции опции информации агента ретрансляции), выглядит следующим образом:

Обратите внимание, что dhcpoptinj не заботится о том, что вы пишете в полезных нагрузках опций, и не проверяет, существует ли ваш код опции. Однако он запрещает использовать код опции 255 (завершающая опция). dhcpoptinj вставляет эту опцию как последнюю автоматически.

Скриншот

Установка

dhcpoptinj есть в Debian/Ubuntu. Пакет deb находится под управлением исходного кода на salsa. Рекомендуется устанавливать dhcpoptinj из пакета deb, а не с помощью следующей процедуры ручной установки, поскольку он также включает страницу руководства, правила автодополнения bash, примеры файлов и т.д.

Предварительные требования

Вам понадобятся cmake и libnetfilter_queue (а также компилятор C, поддерживающий C99). Надеюсь, вы используете систему, подобную Debian, в этом случае вы можете выполнить следующее для их установки: sudo apt-get install cmake libnetfilter-queue-dev.

Сборка

1. Загрузите или клонируйте исходный код: git clone git://github.com/misje/dhcpoptinj
2. Перейдите в каталог: cd dhcpoptinj
3. Создайте каталог сборки и перейдите в него (необязательно, но рекомендуется): mkdir build && cd build
4. Запустите cmake: cmake .. (или cmake -DCMAKE_BUILD_TYPE=Debug .., если вам нужна отладочная сборка)
5. Запустите make: make -j4
6. Установите (необязательно, но вы получите выгоду от наличия dhcpoptinj в вашем PATH): sudo make install

Удаление

1. Выполните sudo make uninstall из каталога сборки

Каталог сборки со всем его содержимым можно безопасно удалить. Если вы не использовали каталог сборки, вы можете избавиться от всего мусора cmake, выполнив git clean -dfx. Однако обратите внимание, что это удаляет всё в каталоге проекта, что не находится под управлением исходного кода.

Конфигурационный файл

dhcptopinj попытается проанализировать /etc/dhcpoptinj.conf или файл, переданный с помощью -c/--conf-file. Синтаксис конфигурационного файла:

• ключ=значение, где ключ — это длинное имя опции, или
• ключ, если опция не принимает аргумент

Пробелы необязательны. Всё после и включая символ # считается комментарием. DHCP-опции перечисляются по одной в виде опция=01:02:03. Кавычки вокруг шестнадцатеричной строки опции необязательны, а байты могут быть разделены любым количеством нешестнадцатеричных символов.

Опции version, help и conf-file не принимаются в конфигурационном файле.

Пример:

Справка

Этот readme должен был помочь вам начать. Также ознакомьтесь со страницей руководства (в пакете deb) и выводом справки (dhcpoptinj -h), которые должны охватывать всё, что может предложить утилита.

По вопросам ошибок и предложений, пожалуйста, создайте issue.

Ограничения

dhcpoptinj прост и, надеюсь, останется таким. Тем не менее, ниже перечислены отсутствующие функции, которые, надеюсь, когда-нибудь будут добавлены:

1. Удаление опций вместо их замены
2. Фильтрация входящих пакетов по типу DHCP-сообщения (код 53) перед их изменением

Устранение неполадок

1. Failed to bind queue handler to AF_INET: Operation not permitted

   Скорее всего, у вас нет возможности CAP_NET_ADMIN или другой процесс (возможно, другой экземпляр dhcpoptinj?) привязан к тому же номеру очереди netfilter.

Известные проблемы

1. Утечка памяти при нештатном завершении.

   Это не считается утечкой. Однако при нормальном завершении (перехват SIGTERM, SIGINT или SIGHUP) утечки памяти быть не должно.

Полезная информация

При создании правил iptables для использования с dhcpoptinj могут быть полезны следующие опции:

• --queue-bypass

Не сбрасывать пакеты, а пропускать их, если dhcpoptinj не запущен (или не прослушивает правильный номер очереди).

Вклад

Если у вас есть какие-либо предложения, пожалуйста, оставьте issue, и я свяжусь с вами. Вы можете внести свой вклад, и pull-запросы очень приветствуются.

Если вы нашли dhcpoptinj полезным, я был бы рад узнать, для чего вы его используете. Обновите страницу вики и опишите своё применение.

Лицензия

Я выбрал GPL для этого проекта. Если это вам не подходит, свяжитесь со мной, и мы сможем договориться о другой лицензии.