Надоело таскать с собой роутер, просто чтобы зайти по 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:
sudo apt update
sudo apt install git -yУстановка простая; когда скрипт закончит, система перезагрузится (будет 10 секунд, чтобы отменить).
git clone https://github.com/JetBrains-Hardware/UniEDC.git
cd UniEDC
chmod +x uniedc_install.sh
sudo ./uniedc_install.shПосле настройки и подключения кабеля устройство доступно по адресу 10.212.212.1

Как это работает на стороне устройства:
- Профиль NetworkManager: Скрипт создаёт на устройстве профиль подключения (
UniEDC-USB), который подходит под любой интерфейс, начинающийся сenx*, и назначает этому интерфейсу статический IP10.212.212.1 - DHCP-сервер:
dnsmasqнастроен слушать только IP USB-интерфейса и раздаёт адреса (например,10.212.212.50) подключённому ноутбуку - Защита от конфликтов:
dnsmasqнастроен сbind-dynamicиexcept-interface=lo, чтобы не конфликтовать со встроеннымsystemd-resolved.systemd-resolvedнастроен так, чтобы устройство по-прежнему могло резолвить локальные имена (mDNS) и выходить в интернет через другие интерфейсы (Wi-Fi/Ethernet).
Я Head of Hardware в компании JetBrains. Основатель Uptime Lab. Рад видеть вас у себя на сайте! Пожалуйста подписывайтесь на мой Инстаграм и Твиттер, я публикую там самые свежие обновления.