Надоело таскать с собой роутер, просто чтобы зайти по SSH на устройство? Мне тоже.

Если вы работаете с edge-устройствами вроде Nvidia Jetson, Raspberry Pi или нового Nvidia Spark, вы знаете, как это бывает. Хочется быстрое и надёжное подключение к ноутбуку для разработки и отладки.

Wi-Fi не всегда удобен. Таскать отдельный свитч или роутер — громоздко.

Моё предложение довольно простое: Ноутбук <-> кабель USB-C <-> адаптер USB-C в Ethernet <-> адаптер Ethernet в USB-C <-> Устройство.

Но дальше начинается программный кошмар. Статические IP, DHCP-серверы, конфликтующие подсети, dnsmasq, который воюет с systemd-resolved… Сплошной бардак. Я решил это раз и навсегда.

Встречайте UniEDC (Universal Ethernet Direct Connect)

Очевидный вопрос: зачем отдельный адаптер USB-C в Ethernet со стороны Spark?

Чтобы не трогать текущее Ethernet-подключение и иметь возможность в любой момент подключить Spark к обычной сети

Где используется

Это решение активно использовалось в нескольких демо JetBrains. В частности, можно почитать пост моего коллеги по ссылке:

https://jonnyzzz.com/blog/2025/11/26/junie-cage-spark


Что это?

Это bash-утилита в духе «настроил и забыл», которая превращает целевое устройство (Spark, Pi, Jetson) в plug-and-play шлюз.

Изначально мы сделали это, чтобы подключать устройство Nvidia Spark напрямую к ноутбуку разработчика, чтобы его можно было использовать с AI-ассистентом и агентами JetBrains на компьютере пользователя. Но работать это должно почти на любом железе на базе Debian/Ubuntu.

Вы запускаете скрипт установки на устройстве один раз, и он берёт на себя все сложности сетевого стека: DHCP с горячим подключением, поддержку любых адаптеров через wildcards и, что важно, умную изоляцию DNS, чтобы устройство не теряло собственный доступ в интернет, когда вы к нему подключаетесь.

Основные возможности

  • Поддержка любых адаптеров: UniEDC использует wildcards NetworkManager (enx*), чтобы автоматически находить и настраивать любой USB-Ethernet адаптер, подключённый к устройству. Адаптеры можно менять без перенастройки ОС
  • Горячее подключение: В комплекте скрипт NetworkManager Dispatcher. DHCP-сервер (dnsmasq) на устройстве запускается автоматически, когда появляется Ethernet-линк, и останавливается при отключении
  • Безопасная подсеть: Используется 10.212.212.0/24, чтобы гарантированно не пересекаться по IP с Wi-Fi, Docker-контейнерами (172.17.x.x) или типичными офисными/домашними подсетями разработчика (192.168.1.x)
  • Умная изоляция DNS: Сетевые обязанности разделены, чтобы не было конфликтов за порт 53
  • Хост: systemd-resolved продолжает обслуживать обычный DNS, так что Spark сохраняет полный доступ в интернет/Wi-Fi.
  • Подключение: dnsmasq работает изолированно, строго для USB-линка, и обслуживает прямое подключение, не мешая системной сети.



Железная часть

Физически всё устроено хитро и компактно. Используются два конкретных адаптера, которые втыкаются прямо друг в друга и образуют один аккуратный блок без лишнего патч-корда.

Я использовал эти два компонента:

Адаптер USB-C в Gigabit Ethernet: Обычный адаптер с коротким кабелем и штекером USB-C. Я брал https://www.amazon.de/-/en/dp/B0B1N4F6QD



Адаптер USB-C (гнездо) в RJ45 (штекер): Компактный адаптер, который втыкается прямо в Ethernet-порт первого и даёт на выходе гнездо USB-C. https://www.amazon.de/-/en/dp/B0FJRWJ6QP

Как они соединяются: Штекер RJ45 адаптера StarTech втыкается в порт RJ45 адаптера Duttek. Получается одно устройство: с одной стороны штекер USB-C (от StarTech), с другой — гнездо USB-C (от Duttek).

Режем здесь:

И здесь тоже:

Когда почти закончили, вставьте USB, чтобы направить порт в отверстие:

Вся цепочка целиком:

  • Штекер USB-C (сторона StarTech) втыкается в целевое устройство (например, Nvidia Spark).
  • Обычным кабелем USB-C — USB-C (желательно USB 3.0) соедините гнездо USB-C (сторона Duttek) с ноутбуком. Кстати, USB2.0 — это 480Mbps, так что вполне возможно, что для ваших задач этого хватит

Чтобы сделать конструкцию ещё надёжнее и удобнее в дороге, я нарисовал и напечатал на 3D-принтере корпус, который фиксирует оба адаптера в один прочный блок.

Модель корпуса для 3D-печати можно скачать по ссылке. Я печатал с «fuzzy skin», чтобы получить классный эффект поверхности:

Теперь это просто один цельный блок, который я втыкаю в устройство, а дальше нужен только обычный кабель USB-C до ноутбука.


Софт

Скрипт на GitHub.

GitHub: https://github.com/JetBrains-Hardware/UniEDC

Если вдруг нет Git:

Bash
sudo apt update
sudo apt install git -y

Установка простая; когда скрипт закончит, система перезагрузится (будет 10 секунд, чтобы отменить).

Bash
git clone https://github.com/JetBrains-Hardware/UniEDC.git
cd UniEDC
chmod +x uniedc_install.sh
sudo ./uniedc_install.sh

После настройки и подключения кабеля устройство доступно по адресу 10.212.212.1

Как это работает на стороне устройства:

  1. Профиль NetworkManager: Скрипт создаёт на устройстве профиль подключения (UniEDC-USB), который подходит под любой интерфейс, начинающийся с enx*, и назначает этому интерфейсу статический IP 10.212.212.1
  2. DHCP-сервер: dnsmasq настроен слушать только IP USB-интерфейса и раздаёт адреса (например, 10.212.212.50) подключённому ноутбуку
  3. Защита от конфликтов:
    dnsmasq настроен с bind-dynamic и except-interface=lo, чтобы не конфликтовать со встроенным systemd-resolved.
    systemd-resolved настроен так, чтобы устройство по-прежнему могло резолвить локальные имена (mDNS) и выходить в интернет через другие интерфейсы (Wi-Fi/Ethernet).
0 0 голоса
Article Rating
Подписаться
Уведомить о
guest

0 Комментарий
Старые
Новые Популярные