Тема
Редактор диаграмм Draw.io
На доске Эсборд доступен редактор диаграмм Draw.io. Технически это встроенный на доску редактор (iframe), который по умолчанию загружается с публичного сайта diagrams.net. Поэтому в закрытом контуре без доступа в интернет редактор нужно либо разместить внутри вашей инфраструктуры, либо он будет недоступен.
Как это работает по умолчанию
Поведение задаётся переменной окружения DRAW_IO_EMBED_URL на контейнере образа sboard:
- Переменная не задана — редактор пытается загрузиться с внешнего сайта
https://embed.diagrams.net/. Если у сервера есть доступ в интернет, редактор работает без дополнительной настройки. Если доступа нет, при открытии редактора диаграмм пользователь увидит сообщение «Draw.io недоступен в вашем окружении» с предложением обратиться к менеджеру (контакт менеджера показывается, если он назначен). - Переменная задана — редактор загружается с указанного URL. Так подключается локально размещённый Draw.io для работы в закрытом контуре.
Включение Draw.io в закрытом контуре (офлайн)
Чтобы редактор работал без доступа в интернет, запустите Draw.io внутри вашей инфраструктуры рядом с Эсборд и укажите его адрес в DRAW_IO_EMBED_URL. Редактор открывается по адресу https://<ДОМЕННОЕ ИМЯ>/drawio/ — на том же домене, что и Эсборд.
Версия
Штатный маршрут /drawio/ во встроенном nginx Эсборд доступен начиная с коробочной версии 2026.3.3. В более ранних версиях маршрута нет: опубликуйте Draw.io через ваш внешний reverse proxy, как описано в разделе Внешний reverse proxy.
1. Загрузите образ Draw.io
Draw.io распространяется как готовый образ jgraph/drawio (лицензия Apache-2.0, self-hosting разрешён). Образ содержит редактор целиком и рассчитан на работу в закрытом контуре. Загрузите образ в ваш реестр так же, как образы Эсборд (см. установку образов из архива). Рекомендуем зафиксировать конкретный тег образа, а не latest.
TIP
Экспорт диаграмм в Эсборд выполняется на стороне браузера, поэтому отдельный сервер экспорта Draw.io (drawio-export) не требуется — достаточно самого webapp.
2. Запустите Draw.io рядом с Эсборд
Добавьте сервис drawio в тот же docker-compose.yml, где запущен Эсборд. Встроенный nginx Эсборд обращается к Draw.io по имени сервиса drawio на порт 8080 внутри docker-сети compose, поэтому публиковать порты Draw.io наружу не нужно.
yml
drawio:
image: "${DOCKER_REGISTRY}/jgraph/drawio:<ТЕГ>"
restart: "always"Если Draw.io запущен под другим именем или на другом хосте, задайте его адрес переменными DRAW_IO_HOST (по умолчанию drawio) и DRAW_IO_PORT (по умолчанию 8080) на контейнере со встроенным nginx — см. примеры ниже (на другом хосте порт Draw.io должен быть опубликован). Draw.io должен отдавать webapp по HTTP на этом порту из корня (так работает образ jgraph/drawio).
3. Укажите адрес редактора
Задайте контейнеру образа sboard переменную окружения DRAW_IO_EMBED_URL: "https://${DOMAIN_NAME}/drawio/".
Важно
- Адрес указывается со слэшем на конце:
https://${DOMAIN_NAME}/drawio/. - Адрес должен быть https: политика безопасности доски (CSP) разрешает встраивать редактор только с того же домена или по https. Публикация на том же домене через
/drawio/этому удовлетворяет.
Пример для Docker-compose standalone / HA
Встроенный nginx работает внутри контейнера sboard, поэтому все переменные задаются ему.
- Внести изменения в docker-compose.yml:
yml
sboard:
image: "${DOCKER_REGISTRY}/sboard:${DOCKER_IMAGE_TAG}"
restart: "always"
ports:
- 80:80
- 443:443
volumes:
- "./certs:/certs"
environment:
DOMAIN_NAME: "${DOMAIN_NAME}"
DRAW_IO_EMBED_URL: "https://${DOMAIN_NAME}/drawio/"
# Только если Draw.io запущен не сервисом drawio в этом же compose:
# DRAW_IO_HOST: "<адрес Draw.io>"
# DRAW_IO_PORT: "8080"
depends_on:
- minio
- redis
- postgres
drawio:
image: "${DOCKER_REGISTRY}/jgraph/drawio:<ТЕГ>"
restart: "always"- Запустить docker-compose заново как при обновлении:
shell
docker-compose -f docker-compose.yml up -d --force-recreateПример для Docker-compose minimal (standalone / HA)
В minimal-варианте nginx — отдельный контейнер nginx: адрес редактора задаётся контейнеру sboard, а адрес Draw.io (если он отличается от умолчания) — контейнеру nginx.
- Внести изменения в docker-compose.yml:
yml
sboard:
image: "${DOCKER_REGISTRY}/sboard:${DOCKER_IMAGE_TAG}-minimal"
restart: "always"
environment:
DOMAIN_NAME: "${DOMAIN_NAME}"
DRAW_IO_EMBED_URL: "https://${DOMAIN_NAME}/drawio/"
nginx:
image: "${DOCKER_REGISTRY}/nginx:${DOCKER_IMAGE_TAG}"
restart: "always"
ports:
- 80:80
- 443:443
volumes:
- "./certs:/certs"
environment:
DOMAIN_NAME: "${DOMAIN_NAME}"
# Только если Draw.io запущен не сервисом drawio в этом же compose:
# DRAW_IO_HOST: "<адрес Draw.io>"
# DRAW_IO_PORT: "8080"
depends_on:
- sboard
drawio:
image: "${DOCKER_REGISTRY}/jgraph/drawio:<ТЕГ>"
restart: "always"- Запустить docker-compose заново как при обновлении:
shell
docker-compose -f docker-compose.yml up -d --force-recreate4. Проверьте работу
- Откройте в браузере
https://<ДОМЕННОЕ ИМЯ>/drawio/— должна открыться страница редактора Draw.io. - Откройте доску и добавьте диаграмму Draw.io — редактор загрузится с локального адреса, без обращения в интернет.
Если не работает
/drawio/отвечает 502 — встроенный nginx не может достучаться до Draw.io: контейнерdrawioне запущен, запущен под другим именем или в другой docker-сети. Проверьтеdocker-compose psи при необходимости задайтеDRAW_IO_HOST/DRAW_IO_PORT./drawio/открывает страницу входа или перенаправляет в личный кабинет — в вашей версии Эсборд ещё нет штатного маршрута/drawio/; опубликуйте Draw.io через внешний reverse proxy (см. ниже).- Редактор на доске не загружается, а
/drawio/открывается — проверьте, чтоDRAW_IO_EMBED_URLзадан контейнеруsboard, начинается сhttps://и заканчивается слэшем, и что контейнер пересоздан после изменения.
Внешний reverse proxy
Если Эсборд запущен за вашим reverse proxy, маршрут /drawio/ можно обслужить одним из двух способов.
Вариант 1 — через встроенный nginx Эсборд (с версии 2026.3.3, рекомендуется). Reverse proxy передаёт во встроенный nginx Эсборд все запросы, включая /drawio/ (location /), а встроенный nginx сам направляет их в Draw.io внутри docker-сети. Отдельная настройка прокси и публикация порта Draw.io не нужны — достаточно шагов 1–3 выше.
Вариант 2 — маршрут на вашем reverse proxy (версии до 2026.3.3). В этих версиях во встроенном nginx нет маршрута /drawio/, поэтому Draw.io публикуется на вашем reverse proxy, на том же домене, что и Эсборд. После обновления до 2026.3.3 или новее можно перейти на вариант 1: удалить маршрут /drawio/ с прокси и убрать публикацию порта.
Опубликуйте порт Draw.io на хосте, чтобы reverse proxy мог к нему обратиться, — добавьте сервису
drawioсекциюportsи пересоздайте контейнер:ymldrawio: image: "${DOCKER_REGISTRY}/jgraph/drawio:<ТЕГ>" restart: "always" ports: - "8080:8080"Проверьте с сервера reverse proxy:
curl -I http://<ХОСТ DRAW.IO>:8080/должен вернуть200.Добавьте маршрут на reverse proxy рядом с общим маршрутом на Эсборд (
location /). Пример для nginx:location = /drawio { return 301 /drawio/; } location /drawio/ { proxy_pass http://<ХОСТ DRAW.IO>:8080/; proxy_set_header Host $host; }Важно
Слэш в конце
proxy_pass http://<ХОСТ DRAW.IO>:8080/;обязателен: он срезает префикс/drawio/, иначе Draw.io получит запрос не к своему корню и редактор не загрузится.Задайте контейнеру
sboardпеременнуюDRAW_IO_EMBED_URL: "https://${DOMAIN_NAME}/drawio/", как описано в шаге 3.
Отключение Draw.io
Отдельного флага для полного отключения редактора нет: если Draw.io недоступен (переменная не задана и нет доступа в интернет), при попытке открыть редактор диаграмм пользователь увидит сообщение о недоступности с контактом менеджера, а остальная работа с доской продолжается без ограничений.