3.6 KiB
Ручной редактор схем на draw.io (12.11.2026)
Что было не так
Мой самодельный редактор (combine-drawedit, :8106) умел только таскать
узлы авто-схемы, добавлять подписи и линии. Владельцу нужно больше:
добавлять устройства вручную, рисовать кабели, свободные фигуры.
Самодельный редактор это не покрывал.
Решение: готовый редактор draw.io
Взят зрелый продукт — draw.io (embed.diagrams.net). В нём есть всё: библиотека фигур, коннекторы для кабелей, подписи, свободное рисование, группировка, экспорт SVG/PNG/PDF.
Сервис combine-canvas (:8107)
| Маршрут | Назначение |
|---|---|
GET /canvas?host=…&item=… |
страница: панель + встроенный draw.io |
GET /canvas/xml?host=… |
стартовая схема (mxGraph XML из port_plan) |
POST /canvas/save |
сохранить схему (нужен X-Token) |
Сохранение: /opt/work-hub/compat/layouts/<хост>.drawio.xml.
Как это работает
- Открывается авто-схема текущего состава как обычная диаграмма draw.io:
терминал в центре, устройства вниз, кабели подписаны портами
(
out:USB → USB), проблемные — пунктиром и красным. - Дальше владелец правит руками: тащит блоки, добавляет новые устройства из палитры draw.io, рисует кабели коннекторами, ставит подписи.
- Сохранить пишет XML в проект (кнопка в верхней панели).
- Скачать .drawio — файл для draw.io desktop.
- Сброс — вернуть авто-схему.
Проверено
GET :8107/canvas → 200
GET :8107/canvas/xml → 1930 байт, XML корректный, 4 вершины, 3 ребра
POST :8107/canvas/save → {"ok": true, "bytes": 209}
файл → /opt/work-hub/compat/layouts/<host>.drawio.xml
кнопка в UI → открывает :8107/canvas
Попытка self-hosted draw.io (не удалась)
Пробовал поднять jgraph/drawio в Docker на порту 8097: контейнер падает
java.io.IOException: Permission denied
at sun.security.pkcs12.PKCS12KeyStore.setKeyEntry
— entrypoint генерирует keystore в недоступный каталог. Попытки
--user root и --tmpfs не помогли. Поэтому используется официальный
embed-хостинг diagrams.net (доступен с хоста: HTTP 200).
Если интернет в браузере недоступен — draw.io не загрузится.
Тогда либо доводим self-hosted образ, либо остаётся простой редактор
combine-drawedit (:8106).
Ловушка
port_plan ожидает список позиций [[модель, кол-во], …], а не словарь
параметров запроса. Первая версия передала q целиком — падало с
invalid literal for int(): 'o' (строка "host" разбиралась как позиция).