Внешнее хранилище S3 в DOC-V: страница сервиса со счётчиками — в хранилище, кэш на диске, перенос накопленных файлов

База документов растёт медленно, а файлы — быстро. Сканы входящих, вложения к договорам, их новые редакции, фотографии с объектов: через пару лет работы каталог файлов DOC-V занимает больше места, чем всё остальное на сервере. Диск приходится докупать, а резервная копия файлов идёт всё дольше.

В версии DOC-V 8.5.36 появился сервис «Внешнее хранилище S3». Файлы хранятся в S3-совместимом хранилище, а на диске сервера остаются только те, что открывали недавно. Расскажем, как он устроен, кому пригодится и о чём важно знать до включения.

📌 Коротко:

  • Где файлы: в S3-совместимом хранилище — MinIO, Ceph и других, своём или у провайдера, в том числе с сертификатом внутреннего центра сертификации.
  • Диск сервера — кэш: давно не открытые файлы освобождают место и загружаются из хранилища, когда снова понадобятся. Пользователи работают как раньше.
  • Новые файлы выкладываются в хранилище в фоне, накопленные — ночью с ограничением скорости.
  • Копия базы для теста или проверки бакет рабочей установки только читает и ничего в нём не меняет.
  • Страница сервиса: настройки подключения, состояние и счётчики, кнопка «Проверить подключение».
  • В версиях 8.5 — бесплатно, без модуля в лицензионном ключе.

🗄️ Кому это нужно

S3 — это объектное хранилище: место в нём обычно дешевле, чем диск сервера, а растёт оно без переезда на новый сервер. Такие хранилища сдают в аренду хостинг-провайдеры, а крупные организации разворачивают их у себя на MinIO или Ceph.

Сервис пригодится, если:

Если файлов немного и диска хватает, ничего включать не нужно: без сервиса DOC-V хранит файлы на диске, как и раньше.

⚙️ Как это работает

Хранилище S3 становится основным местом для файлов, а каталог файлов на диске сервера — кэшем заданного размера.

🌙 Перенос накопленных файлов

Файлы, которые появились до включения сервиса, переносятся отдельно, если включить настройку «Переносить накопленные файлы». Перенос идёт только в заданные часы, по умолчанию с 22:00 до 7:00 по часовому поясу сервера, и со скоростью не больше заданной, по умолчанию 20 МБ/с. Так перенос нескольких сотен гигабайт не мешает работе днём и не занимает весь канал. Сколько файлов уже выложено и сколько осталось, видно на странице сервиса.

Перенос можно и не включать: тогда в хранилище уходят только новые файлы, а старые остаются на диске.

🔐 Своё хранилище и свой сертификат

Сервис рассчитан и на хранилище внутри контура организации, а не только у провайдера:

Кнопка «Проверить подключение» проверяет настройки, введённые на странице, даже если они ещё не сохранены: есть ли бакет, записывается ли в него служебный объект, читается ли и удаляется ли. Так ошибку в адресе, ключе или сертификате видно сразу, до включения сервиса.

🧪 Копия базы не испортит рабочий бакет

Настройки сервиса хранятся в базе DOC-V. Значит, копия рабочей базы — на тестовом стенде или на компьютере администратора — подключилась бы к тому же бакету и могла бы удалять из него файлы рабочей установки.

Чтобы этого не случилось, бакет помнит установку, которая в него пишет. Копия базы видит, что бакет чужой, и работает с ним только на чтение: файлы из хранилища открываются, а новые не выкладываются, кэш не освобождается и объекты не удаляются. Об этом появляется запись в журнале событий.

Если рабочую базу перенесли на другой сервер или восстановили из копии, на странице сервиса есть кнопка «Привязать бакет к этой установке».

📊 Страница сервиса

Сервис настраивается в разделе «Администрирование» → «Сервисы» → «Внешнее хранилище S3». Кроме настроек подключения, кэша и переноса, страница показывает, что происходит прямо сейчас, и сама обновляет данные:

⚠️ Что важно знать до включения

Совет для первого включения: начните с размера кэша 0. Тогда файлы выкладываются в хранилище, но с диска не убираются, и вы спокойно посмотрите, как идёт выкладка и перенос. Когда всё работает как ожидалось, задайте размер кэша — и диск начнёт освобождаться.

💳 Сколько стоит

В версиях DOC-V 8.5 сервис «Внешнее хранилище S3» бесплатный и не требует модуля в лицензионном ключе. Если хранилище арендовано у провайдера, место в нём оплачивается провайдеру по его тарифам. Если удобнее поручить настройку нам, это работы на сервере: они входят в платный тариф поддержки или оплачиваются отдельно. Условия — на странице цен.

🔗 С чего начать

  1. Обновите DOC-V до версии 8.5.36 или новее.
  2. Создайте в хранилище бакет и учётную запись с доступом к нему.
  3. Откройте «Администрирование» → «Сервисы» → «Внешнее хранилище S3», заполните настройки и нажмите «Проверить подключение».
  4. Включите сервис с размером кэша 0 и посмотрите, как выкладываются новые файлы. Затем задайте размер кэша и, если нужно, включите перенос накопленных файлов.
  5. Настройте копии бакета на стороне хранилища.

Если DOC-V у вас ещё не установлен, начните со статьи «Облако или свой сервер» и установщика одной командой.

❓ Частые вопросы

Какие хранилища подходят?

S3-совместимые: MinIO, Ceph и другие, как развёрнутые у вас, так и у хостинг-провайдера. Если сертификат хранилища выпущен внутренним центром сертификации, его корневой сертификат вставляется прямо в настройки сервиса. Бакет нужно создать заранее: сервис его не создаёт.

Заметят ли пользователи, что файлы теперь в хранилище?

Работа с файлами не меняется: просмотр, скачивание, вложения в письма и редактирование в OnlyOffice идут как раньше. Если файла давно не открывали и его уже нет на диске сервера, первое открытие займёт чуть больше времени: DOC-V сначала загрузит его из хранилища.

Нужно ли переносить файлы, которые уже есть?

Не обязательно. Без переноса в хранилище уходят только новые файлы. Если включить «Переносить накопленные файлы», старые файлы выкладываются в заданные часы, по умолчанию с 22 до 7, с ограничением скорости, чтобы не занимать канал.

Заменяет ли хранилище S3 резервное копирование?

Нет. Файл, удалённый в DOC-V, удаляется и из бакета. А резервная копия файлов, которую делает планировщик, после включения сервиса содержит вместо перенесённых файлов пустые заглушки и годится только вместе с бакетом. Копии бакета настраивайте средствами самого хранилища.

Что будет, если хранилище недоступно?

Файлы, которые лежат на диске сервера, и новые файлы работают как обычно, а выкладка повторяется, когда хранилище снова доступно. Файл, которого на диске нет, не откроется: DOC-V покажет ошибку, а не пустой файл. Поэтому хранилище должно быть так же доступно серверу, как его база данных.

Сколько стоит сервис?

В версиях DOC-V 8.5 сервис «Внешнее хранилище S3» бесплатный и не требует модуля в лицензионном ключе. Место в хранилище оплачивается его владельцу, если хранилище арендовано у провайдера.