База документов растёт медленно, а файлы — быстро. Сканы входящих, вложения к договорам, их новые редакции, фотографии с объектов: через пару лет работы каталог файлов DOC-V занимает больше места, чем всё остальное на сервере. Диск приходится докупать, а резервная копия файлов идёт всё дольше.
В версии DOC-V 8.5.36 появился сервис «Внешнее хранилище S3». Файлы хранятся в S3-совместимом хранилище, а на диске сервера остаются только те, что открывали недавно. Расскажем, как он устроен, кому пригодится и о чём важно знать до включения.
📌 Коротко:
- Где файлы: в S3-совместимом хранилище — MinIO, Ceph и других, своём или у провайдера, в том числе с сертификатом внутреннего центра сертификации.
- Диск сервера — кэш: давно не открытые файлы освобождают место и загружаются из хранилища, когда снова понадобятся. Пользователи работают как раньше.
- Новые файлы выкладываются в хранилище в фоне, накопленные — ночью с ограничением скорости.
- Копия базы для теста или проверки бакет рабочей установки только читает и ничего в нём не меняет.
- Страница сервиса: настройки подключения, состояние и счётчики, кнопка «Проверить подключение».
- В версиях 8.5 — бесплатно, без модуля в лицензионном ключе.
🗄️ Кому это нужно
S3 — это объектное хранилище: место в нём обычно дешевле, чем диск сервера, а растёт оно без переезда на новый сервер. Такие хранилища сдают в аренду хостинг-провайдеры, а крупные организации разворачивают их у себя на MinIO или Ceph.
Сервис пригодится, если:
- файлов много и они растут — канцелярия сканирует входящие, к договорам и заявкам прикладывают пакеты документов;
- диск сервера маленький или дорогой — например, DOC-V стоит на VPS, где лишние сотни гигабайт стоят ощутимых денег;
- в компании уже есть хранилище S3, и служба ИТ хочет держать файлы всех систем в одном месте, со своими копиями и контролем.
Если файлов немного и диска хватает, ничего включать не нужно: без сервиса DOC-V хранит файлы на диске, как и раньше.
⚙️ Как это работает
Хранилище S3 становится основным местом для файлов, а каталог файлов на диске сервера — кэшем заданного размера.
- Новый файл сначала, как обычно, сохраняется на диск, а через несколько секунд в фоне выкладывается в хранилище. После выкладки DOC-V сверяет содержимое объекта, а при сбое повторяет попытку с нарастающей паузой. Пользователь ничего не ждёт.
- Кэш. Вы задаёте его размер в гигабайтах. Когда выложенных файлов на диске становится больше, давно не открытые убираются с диска: на их месте остаются пустые заглушки, а содержимое лежит в хранилище. Файлы, которые открывали в последний час, на диске остаются.
- Открытие. Если файла на диске нет, DOC-V загружает его из хранилища и дальше работает с ним как обычно: просмотр, скачивание, вложение в письмо, редактирование в OnlyOffice. Первое открытие давно забытого файла занимает чуть больше времени.
- Изменение и удаление. Изменённый файл, например после правки в OnlyOffice, выкладывается новым объектом, а прежний удаляется. Файл, удалённый в DOC-V, удаляется и из хранилища.
- Мелкие файлы можно не выкладывать: файлы меньше заданного порога в килобайтах остаются только на диске. Порог 0 — в хранилище уходят все файлы.
🌙 Перенос накопленных файлов
Файлы, которые появились до включения сервиса, переносятся отдельно, если включить настройку «Переносить накопленные файлы». Перенос идёт только в заданные часы, по умолчанию с 22:00 до 7:00 по часовому поясу сервера, и со скоростью не больше заданной, по умолчанию 20 МБ/с. Так перенос нескольких сотен гигабайт не мешает работе днём и не занимает весь канал. Сколько файлов уже выложено и сколько осталось, видно на странице сервиса.
Перенос можно и не включать: тогда в хранилище уходят только новые файлы, а старые остаются на диске.
🔐 Своё хранилище и свой сертификат
Сервис рассчитан и на хранилище внутри контура организации, а не только у провайдера:
- Адрес и бакет. Адрес хранилища указывается без пути, вида https://сервер:порт, бакет — отдельно. Бакет нужно создать заранее: сервис его не создаёт.
- Адреса path-style (https://сервер/бакет/ключ), как у Ceph и MinIO, включены по умолчанию. Если хранилище требует адреса вида https://бакет.сервер, настройку можно выключить.
- Корневой сертификат. Если сертификат хранилища выпущен внутренним центром сертификации, вставьте его корневой сертификат в формате PEM прямо в настройки сервиса. Он добавляется к системным сертификатам сервера, и настраивать операционную систему не нужно.
- Префикс ключей позволяет держать в одном бакете файлы нескольких установок DOC-V.
- Секретный ключ после сохранения на странице не показывается.
Кнопка «Проверить подключение» проверяет настройки, введённые на странице, даже если они ещё не сохранены: есть ли бакет, записывается ли в него служебный объект, читается ли и удаляется ли. Так ошибку в адресе, ключе или сертификате видно сразу, до включения сервиса.
🧪 Копия базы не испортит рабочий бакет
Настройки сервиса хранятся в базе DOC-V. Значит, копия рабочей базы — на тестовом стенде или на компьютере администратора — подключилась бы к тому же бакету и могла бы удалять из него файлы рабочей установки.
Чтобы этого не случилось, бакет помнит установку, которая в него пишет. Копия базы видит, что бакет чужой, и работает с ним только на чтение: файлы из хранилища открываются, а новые не выкладываются, кэш не освобождается и объекты не удаляются. Об этом появляется запись в журнале событий.
Если рабочую базу перенесли на другой сервер или восстановили из копии, на странице сервиса есть кнопка «Привязать бакет к этой установке».
📊 Страница сервиса
Сервис настраивается в разделе «Администрирование» → «Сервисы» → «Внешнее хранилище S3». Кроме настроек подключения, кэша и переноса, страница показывает, что происходит прямо сейчас, и сама обновляет данные:
- включён ли сервис и работает ли хранилище на запись или только на чтение — и почему;
- сколько файлов и какого объёма уже в хранилище;
- сколько занимает кэш на диске и какой у него предел;
- сколько файлов пока только на диске;
- очереди выкладки и удаления из хранилища;
- последняя ошибка и ход переноса накопленных файлов.
⚠️ Что важно знать до включения
- Хранилище S3 не заменяет резервное копирование. Файл, удалённый в DOC-V, удаляется и из бакета. А резервная копия хранилища файлов, которую делает планировщик, после включения сервиса содержит вместо перенесённых файлов пустые заглушки, поэтому восстановить из неё файлы можно только вместе с бакетом. Копии самого бакета настраивайте средствами хранилища.
- Выключение сервиса не возвращает файлы на диск. Уже перенесённые файлы DOC-V продолжает читать из хранилища, а новые оставляет на диске. Отдельной операции, которая вернёт все файлы на диск, пока нет. Поэтому хранилище должно оставаться доступным и после выключения.
- Хранилище должно быть доступно серверу. Если оно недоступно, файлы с диска и новые файлы работают, а выкладка повторяется позже. Но файл, которого на диске нет, не откроется: DOC-V покажет ошибку, а не пустой файл.
- Предел кэша мягкий. Файлы, открытые в последний час, с диска не убираются, даже если кэш больше предела.
Совет для первого включения: начните с размера кэша 0. Тогда файлы выкладываются в хранилище, но с диска не убираются, и вы спокойно посмотрите, как идёт выкладка и перенос. Когда всё работает как ожидалось, задайте размер кэша — и диск начнёт освобождаться.
💳 Сколько стоит
В версиях DOC-V 8.5 сервис «Внешнее хранилище S3» бесплатный и не требует модуля в лицензионном ключе. Если хранилище арендовано у провайдера, место в нём оплачивается провайдеру по его тарифам. Если удобнее поручить настройку нам, это работы на сервере: они входят в платный тариф поддержки или оплачиваются отдельно. Условия — на странице цен.
🔗 С чего начать
- Обновите DOC-V до версии 8.5.36 или новее.
- Создайте в хранилище бакет и учётную запись с доступом к нему.
- Откройте «Администрирование» → «Сервисы» → «Внешнее хранилище S3», заполните настройки и нажмите «Проверить подключение».
- Включите сервис с размером кэша 0 и посмотрите, как выкладываются новые файлы. Затем задайте размер кэша и, если нужно, включите перенос накопленных файлов.
- Настройте копии бакета на стороне хранилища.
Если DOC-V у вас ещё не установлен, начните со статьи «Облако или свой сервер» и установщика одной командой.
❓ Частые вопросы
Какие хранилища подходят?
S3-совместимые: MinIO, Ceph и другие, как развёрнутые у вас, так и у хостинг-провайдера. Если сертификат хранилища выпущен внутренним центром сертификации, его корневой сертификат вставляется прямо в настройки сервиса. Бакет нужно создать заранее: сервис его не создаёт.
Заметят ли пользователи, что файлы теперь в хранилище?
Работа с файлами не меняется: просмотр, скачивание, вложения в письма и редактирование в OnlyOffice идут как раньше. Если файла давно не открывали и его уже нет на диске сервера, первое открытие займёт чуть больше времени: DOC-V сначала загрузит его из хранилища.
Нужно ли переносить файлы, которые уже есть?
Не обязательно. Без переноса в хранилище уходят только новые файлы. Если включить «Переносить накопленные файлы», старые файлы выкладываются в заданные часы, по умолчанию с 22 до 7, с ограничением скорости, чтобы не занимать канал.
Заменяет ли хранилище S3 резервное копирование?
Нет. Файл, удалённый в DOC-V, удаляется и из бакета. А резервная копия файлов, которую делает планировщик, после включения сервиса содержит вместо перенесённых файлов пустые заглушки и годится только вместе с бакетом. Копии бакета настраивайте средствами самого хранилища.
Что будет, если хранилище недоступно?
Файлы, которые лежат на диске сервера, и новые файлы работают как обычно, а выкладка повторяется, когда хранилище снова доступно. Файл, которого на диске нет, не откроется: DOC-V покажет ошибку, а не пустой файл. Поэтому хранилище должно быть так же доступно серверу, как его база данных.
Сколько стоит сервис?
В версиях DOC-V 8.5 сервис «Внешнее хранилище S3» бесплатный и не требует модуля в лицензионном ключе. Место в хранилище оплачивается его владельцу, если хранилище арендовано у провайдера.