Как безопасно создавать резервные копии и восстанавливать конфигурационные файлы Collabora CODE

Выпуск Collabora Online Development Edition (CODE) 26.04.4.2 состоялся 24 сентября 2026 года. Это важно для планирования резервного копирования, поскольку в версии 26.04 также были изменены некоторые аспекты рекомендуемой обработки путей обратного прокси для новых URL-адресов WebSocket. Если вы готовитесь к обновлению, миграции или аварийному восстановлению, резервного копирования только одного XML-файла может быть недостаточно для воспроизведения работающей системы.

Проверенная основа довольно проста: основной конфигурационный файл сервера Collabora находится /etc/coolwsd/coolwsd.xmlвнутри официального контейнера CODE. Официальная документация Docker также поддерживает копирование этого файла из контейнера, его обратное копирование или монтирование с хоста. Различаются только следующие компоненты: переменные среды Docker, монтирование с привязкой, ключи подтверждения WOPI, завершение TLS и конфигурация обратного прокси.

В этом руководстве описан консервативный процесс резервного копирования и восстановления как для установки собственных пакетов, так и для развертывания в Docker. Он намеренно разделяет информацию, подтвержденную документацией Collabora, от информации, зависящей от вашей собственной системы развертывания.

Что должно включать резервное копирование Collabora CODE?

Подтверждено: /etc/coolwsd/coolwsd.xml это основной конфигурационный файл Collabora Online. Collabora указывает этот путь напрямую и описывает файл как самодокументирующийся для доступных параметров сервера. См. официальное руководство по SDK Collabora Online .

Зависит от развертывания: для полного восстановления может потребоваться конфигурация, использованная при запуске службы. Для Docker это может включать YAML-файл Compose, переменные среды, привязанные точки монтирования, секреты и файлы, смонтированные с хоста. Для нативной установки это может включать виртуальный хост обратного прокси и сертификаты, если они управляются на том же сервере.

Действие: перед созданием архива запишите, является ли ваш экземпляр установкой пакета или развертыванием Docker/Compose. Не следует предполагать, что одна и та же процедура восстановления применима к обоим вариантам.

Распространенные заблуждения перед началом работы

Резервное копирование файла coolwsd.xml не приводит к резервному копированию пользовательских документов.

Обычно CODE подключается к платформе хранения данных через WOPI. Документы остаются под контролем этой платформы хранения, например, Nextcloud или другого хоста WOPI. Поэтому восстановление конфигурации CODE не восстанавливает сами документы.

Действие: создайте резервную копию хоста WOPI и его хранилища данных, используя процедуру резервного копирования, встроенную в этот продукт. Рассматривайте эту резервную копию CODE как резервную копию конфигурации службы.

Контейнер Docker не является резервной копией.

Контейнер можно воссоздать из образа. Конфигурация, передаваемая через переменные среды или привязки монтирования, может храниться вне контейнера, в то время как изменения, внесенные только внутри контейнера, могут исчезнуть при замене контейнера.

Действие: сохранить определение развертывания и файлы, смонтированные на хосте, а не только файловую систему контейнера.

Копирование старого файла coolwsd.xml поверх более новой версии не всегда является самым безопасным способом восстановления.

Параметры конфигурации могут меняться между выпусками CODE. В текущих примечаниях к выпуску Collabora указаны продолжающиеся изменения серверов и прокси-серверов в серии 26.04, включая обновленные рекомендации по прокси-серверам для компактного URL-адреса WebSocket. См. официальные примечания к выпуску CODE 26.04 .

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

Шаг 1: Запишите установленную версию и тип развертывания.

Для начала соберите достаточно информации, чтобы воспроизвести среду. Для развертывания контейнера проверьте работающий контейнер и его образ:

docker ps --filter name=collabora
docker inspect collabora --format '{{.Config.Image}}'
docker inspect collabora --format '{{json .Mounts}}'

Если ваш контейнер использует другое имя, замените его collaboraсоответствующим образом. Официальный образ опубликован как collabora/code; в Docker Hub в настоящее время идентифицируется образ 26.04.4.2 в последней линейке релизов. См. официальный образ Collabora CODE на Docker Hub .

Для установки пакетов непосредственно в систему, запишите версию пакета в используемом вами менеджере пакетов. Например, в Debian или Ubuntu:

dpkg-query -W 'coolwsd*' 'collaboraoffice*' 2>/dev/null

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

Шаг 2: Создайте резервную копию основной конфигурации и метаданных развертывания.

Установка нативных пакетов

Создайте резервную копию только для корневого каталога и заархивируйте весь /etc/coolwsdкаталог целиком, а не только основной XML-файл. Это позволит сохранить все дополнительные файлы, которые были добавлены в этот каталог установленным пакетом или локальными настройками.

sudo install -d -m 700 /var/backups/collabora
sudo tar -C /etc -czpf \
  /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  coolwsd

Эта команда намеренно вносит изменения /etcперед архивированием, чтобы архив содержал относительный coolwsd/путь вместо абсолютного пути к файловой системе.

Docker или Docker Compose

В документации Collabora указано, что официальный образ содержит /etc/coolwsd/coolwsd.xmlи что администраторы могут копировать его, изменять, копировать обратно или монтировать извне контейнера.

Если файл еще не смонтирован с хоста, скопируйте его:

sudo install -d -m 700 /var/backups/collabora
docker cp collabora:/etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/coolwsd.xml

Далее, зафиксируйте конфигурацию контейнера:

docker inspect collabora --format '{{json .Config.Env}}' \
  > /var/backups/collabora/container-env.json

docker inspect collabora --format '{{json .Mounts}}' \
  > /var/backups/collabora/container-mounts.json

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

Если вы используете Docker Compose, скопируйте сам файл Compose и все указанные файлы окружения или секретов с хоста. Их расположение зависит от вашего развертывания, поэтому универсального пути, который можно было бы безопасно предположить, нет.

Действие: убедитесь, что ваша резервная копия содержит источник достоверной информации. Если coolwsd.xmlконфигурация смонтирована через bind-mount, создайте резервную копию файла hosts. Если конфигурация передается через переменные среды, сохраните конфигурацию Compose/run, которая определяет эти переменные.

Шаг 3: Включайте ключи подтверждения, конфигурацию прокси и TLS только в том случае, если они применимы.

Эти компоненты важны именно потому, что они не идентичны в каждой установке.

Ключ подтверждения WOPI: В документации Collabora указано, что при установке RPM и DEB пара ключей подтверждения WOPI генерируется автоматически. Для Docker пара ключей не входит в состав общедоступного образа; при использовании её необходимо сгенерировать и предоставить контейнеру, как правило, через том. В руководстве описана coolconfig generate-proof-keyпроцедура генерации ключа. Поскольку ключ Docker находится вне неизменяемого образа, потеря ключа, смонтированного на стороне хоста, может изменить идентификатор, используемый для подписи подтверждения WOPI.

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

Обратный прокси: Apache, Nginx, HAProxy, Traefik или другой прокси-сервер может хранить публичное имя хоста, завершение TLS, маршрутизацию WebSocket и правила переадресации запросов. В CODE 26.04 Collabora обновила рекомендации по использованию прокси для нового компактного URL-адреса WebSocket, сохранив при этом в некоторых случаях резервный вариант.

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

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

Шаг 4: Проверьте резервную копию перед тем, как она вам понадобится.

Одного успешного выполнения tarкоманды недостаточно. Проверьте, можно ли просмотреть содержимое архива и присутствует ли ожидаемый основной конфигурационный файл.

sudo tar -tzf /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  | grep 'coolwsd/coolwsd.xml'

Создайте контрольную сумму для проверки вне хоста:

cd /var/backups/collabora
sha256sum * > SHA256SUMS

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

Действие: хотя бы один раз протестируйте извлечение данных во временную директорию. Использование резервной копии, которую вы никогда не открывали, — это лишь предположение.

Шаг 5: Выполните консервативное восстановление, затем проверьте работоспособность работающей службы.

Восстановить исходную установку

Рекомендуется сначала установить ту же самую версию CODE. Остановите службу, распакуйте архив во временную директорию и сравните сохраненную конфигурацию с только что установленной конфигурацией по умолчанию:

sudo systemctl stop coolwsd
sudo mkdir -p /root/collabora-restore
sudo tar -xzf /var/backups/collabora/coolwsd-etc-YYYY-MM-DD.tar.gz \
  -C /root/collabora-restore

sudo diff -u \
  /etc/coolwsd/coolwsd.xml \
  /root/collabora-restore/coolwsd/coolwsd.xml

Если версии совпадают и вы планируете полную замену, сначала сохраните исходную директорию в качестве копии для отката:

sudo cp -a /etc/coolwsd /etc/coolwsd.pre-restore
sudo cp -a /root/collabora-restore/coolwsd/. /etc/coolwsd/
sudo systemctl start coolwsd

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

Восстановление развертывания Docker

Воссоздайте контейнер из записанной версии образа и исходного Docker Compose или docker runопределения. Восстановите конфигурацию, смонтированную на хосте, ключи подтверждения и другие внешние файлы в исходные пути хоста перед запуском контейнера.

Если вы намеренно сохранили coolwsd.xmlфайл внутри контейнера, а не использовали его в качестве монтирования, описанный в документации Collabora подход позволяет скопировать файл обратно. На практике же монтирование на хосте проще воспроизвести, поскольку конфигурация сохраняется при замене контейнера.

Действие: сначала восстановите определение развертывания, а затем восстановите файлы, на которые оно ссылается. Это обеспечит согласованность переменных среды, томов и XML-конфигурации.

Как убедиться, что восстановление действительно прошло успешно

Не судите об успехе только по тому, запустился ли процесс. Проверьте работу сервиса, используя тот же сетевой путь, что и клиенты.

Для нативной установки:

sudo systemctl status coolwsd --no-pager
sudo journalctl -u coolwsd -n 100 --no-pager

Для Docker:

docker ps --filter name=collabora
docker logs --tail 100 collabora

В документации Collabora /hosting/capabilitiesуказано, что эта конечная точка позволяет получить, помимо прочей информации, название и версию запущенного продукта. Протестируйте её, используя свой общедоступный URL-адрес Collabora:

curl -fsS https://office.example.com/hosting/capabilities

Замените имя хоста на своё собственное. Также откройте реальный документ на хосте WOPI и убедитесь, что редактирование, сохранение и повторное подключение работают через обычный путь обратного прокси.

Действие: считать восстановление завершенным только после того, как конечная точка возможностей ответит и документ действительно можно будет открыть и сохранить.

Практический контрольный список для резервного копирования

Окончательная рекомендация

Наиболее надежный план восстановления Collabora CODE — это не копирование одного файла. Сохраните coolwsd.xmlточную версию CODE и определение развертывания вместе как один восстанавливаемый набор. Добавляйте ключи подтверждения, правила прокси и TLS-материалы только там, где ваша архитектура действительно их использует. При обновлении, по возможности, восстанавливайте данные в ту же версию; если вы переходите на более новую версию, сравните и объедините конфигурации, а не перезаписывайте новые значения по умолчанию без проверки.

По состоянию на 6 октября 2026 года, согласно официальным примечаниям к выпуску 26.04 и метаданным образа Docker от Collabora, текущая версия — CODE 26.04.4.2. Перед будущей миграцией обязательно проверьте эти официальные источники, поскольку версии образов, рекомендации по прокси-серверам и параметры конфигурации постоянно меняются.