Skip to content

Редактор диаграмм 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, поэтому все переменные задаются ему.

  1. Внести изменения в 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"
  1. Запустить 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.

  1. Внести изменения в 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"
  1. Запустить docker-compose заново как при обновлении:
shell
docker-compose -f docker-compose.yml up -d --force-recreate

4. Проверьте работу ​

  1. Откройте в браузере https://<ДОМЕННОЕ ИМЯ>/drawio/ — должна открыться страница редактора Draw.io.
  2. Откройте доску и добавьте диаграмму 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/ с прокси и убрать публикацию порта.

  1. Опубликуйте порт Draw.io на хосте, чтобы reverse proxy мог к нему обратиться, — добавьте сервису drawio секцию ports и пересоздайте контейнер:

    yml
      drawio:
        image: "${DOCKER_REGISTRY}/jgraph/drawio:<ТЕГ>"
        restart: "always"
        ports: 
          - "8080:8080"

    Проверьте с сервера reverse proxy: curl -I http://<ХОСТ DRAW.IO>:8080/ должен вернуть 200.

  2. Добавьте маршрут на 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 получит запрос не к своему корню и редактор не загрузится.

  3. Задайте контейнеру sboard переменную DRAW_IO_EMBED_URL: "https://${DOMAIN_NAME}/drawio/", как описано в шаге 3.

Отключение Draw.io ​

Отдельного флага для полного отключения редактора нет: если Draw.io недоступен (переменная не задана и нет доступа в интернет), при попытке открыть редактор диаграмм пользователь увидит сообщение о недоступности с контактом менеджера, а остальная работа с доской продолжается без ограничений.